From dea897ef571bf33bc80c0e1dbf35601009582f3d Mon Sep 17 00:00:00 2001 From: Dean Camera Date: Tue, 6 Jul 2010 07:07:54 +0000 Subject: Make main readme file easier to read, and make documentation build instructions clearer. --- README.txt | 76 +++++++++++++++++++++++++++++++++++++++----------------------- 1 file changed, 48 insertions(+), 28 deletions(-) (limited to 'README.txt') diff --git a/README.txt b/README.txt index 12542325d..829bd81fc 100644 --- a/README.txt +++ b/README.txt @@ -1,32 +1,52 @@ - _ _ _ ___ _ - | | | | | __/ \ - | |_| U | _| o | - The Lightweight USB - |___|___|_||_n_| Framework for AVRs - ========================================= - Written by Dean Camera - dean [at] fourwalledcubicle [dot] com - - http://www.fourwalledcubicle.com/LUFA.php - ========================================= - - LUFA is donation supported. To support LUFA, - please donate at http://www.fourwalledcubicle.com. - - For Commercial Licensing information, see - http://fourwalledcubicle.com/PurchaseLUFA.php - - -This package contains the complete LUFA library, demos, user-submitted projects -and bootloaders for use with compatible microcontroller models. To get started, -you will need to install the "Doxygen" documentation generation tool from -www.doxygen.org, and run "make doxygen" from the command line whilst inside the -extracted LUFA download package directory. From there, the generated Doxygen -HTML documentation for the library and included projects will be available in the -generated Documentation/ subdirectories of the library core and projects. View -the generated documentation for the library core in your chosen web browser for -further Getting Started information. + _ _ _ ___ _ + | | | | | __/ \ + | |_| U | _| o | - The Lightweight USB + |___|___|_||_n_| Framework for AVRs + ========================================= + Written by Dean Camera + dean [at] fourwalledcubicle [dot] com + + http://www.fourwalledcubicle.com/LUFA.php + ========================================= + + LUFA is donation supported. To support LUFA, + please donate at http://www.fourwalledcubicle.com. + + For Commercial Licensing information, see + http://fourwalledcubicle.com/PurchaseLUFA.php + + +This package contains the complete LUFA library, demos, user-submitted +projects and bootloaders for use with compatible microcontroller models. +LUFA is a simple to use, lightweight framework which sits atop the hardware +USB controller in specific AVR microcontroller models, and allows for the +quick and easy creation of complex USB devices and hosts. + +To get started, you will need to install the "Doxygen" documentation +generation tool. If you use Linux, this can be installed via the "doxygen" +package in your chosen package management tool - under Ubuntu, this can be +acheived by running the following command in the terminal: + + sudo apt-get install doxygen + +Other package managers and distributions will have similar methods to +install Doxygen. In Windows, you can download a prebuilt installer for +Doxygen from its website, www.doxygen.org. + +Once installed, you can then use the Doxygen tool to generate the library +documentation from the command line or terminal of your operating system. To +do this, open your terminal or command line to the root directory of the +LUFA package, and type the following command: + + make doxygen + +Which will recursively generate documentation for all elements in the +library - the core, plus all demos, projects and bootloaders. Generated +documentation will then be available by opening the file "index.html" of the +created Documentation/html/ subdirectories inside each project folder. The documentation for the library itself (but not the documentation for the individual demos, projects or bootloaders) is also available as a separate -package from the project webpage for convenience if Doxygen cannot be installed. \ No newline at end of file +package from the project webpage for convenience if Doxygen cannot be +installed. \ No newline at end of file -- cgit v1.2.3