Add missing documentation to the lightweight ring buffer code in the XPLAINBridge...
[pub/USBasp.git] / LUFA / ManPages / GettingStarted.txt
index dfd38ed..b33a3b5 100644 (file)
@@ -1,20 +1,26 @@
-/** \file\r
- *\r
- *  This file contains special DoxyGen information for the generation of the main page and other special\r
- *  documentation pages. It is not a project source file.\r
- */\r
-\r
-/** \page Page_GettingStarted Getting Started\r
- *\r
- *  Out of the box, LUFA contains a large number of pre-made class demos for you to test, experiment with and\r
- *  ultimately build upon for your own projects. All the demos come pre-configured to build and run correctly\r
- *  on the AT90USB1287 AVR microcontroller, mounted on the Atmel USBKEY board and running at an 8MHz master clock.\r
- *  This is due to two reasons; one, it is the hardware the author possesses, and two, it is the most popular Atmel\r
- *  USB demonstration board to date. To learn how to reconfigure, recompile and program the included LUFA applications\r
- *  using different settings, see the following subsections.\r
- *\r
- *  <b>Subsections:</b>\r
- *  - \subpage Page_ConfiguringApps How to Configure the Included Demos, Projects and Bootloaders\r
- *  - \subpage Page_CompilingApps How to Compile the Included Demos, Projects and Bootloaders\r
- *  - \subpage Page_ProgrammingApps How to Program an AVR with the Included Demos, Projects and Bootloaders\r
- */\r
+/** \file
+ *
+ *  This file contains special DoxyGen information for the generation of the main page and other special
+ *  documentation pages. It is not a project source file.
+ */
+
+/** \page Page_GettingStarted Getting Started
+ *
+ *  Out of the box, LUFA contains a large number of pre-made class demos for you to test, experiment with and
+ *  ultimately build upon for your own projects. All the demos (where possible) come pre-configured to build and
+ *  run correctly on the AT90USB1287 AVR microcontroller, mounted on the Atmel USBKEY board and running at an 8MHz
+ *  master clock. This is due to two reasons; one, it is the hardware the author possesses, and two, it is the most
+ *  popular Atmel USB demonstration board to date. To learn how to reconfigure, recompile and program the included
+ *  LUFA applications using different settings, see the subsections below.
+ *
+ *  Most of the included demos in the /Demos/ folder come in both ClassDriver and LowLevel varieties. If you are new
+ *  to LUFA, it is highly recommended that you look at the ClassDriver versions first, which use the premade USB
+ *  Class Drivers (\ref Group_USBClassDrivers) to simplify the use of the standard USB classes in user applications.
+ *
+ *  For an overview of the included library applications, bootloaders and demos, see \ref Page_LibraryApps.
+ *
+ *  <b>Subsections:</b>
+ *  - \subpage Page_ConfiguringApps How to Configure the Included Demos, Projects and Bootloaders
+ *  - \subpage Page_CompilingApps How to Compile the Included Demos, Projects and Bootloaders
+ *  - \subpage Page_ProgrammingApps How to Program an AVR with the Included Demos, Projects and Bootloaders
+ */