Make main readme file easier to read, and make documentation build instructions clearer.

1 files changed, 48 insertions, 28 deletions

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