Correct Endpoint/Pipe maximum constants for the AVR32 UC3 models.
[pub/lufa.git] / LUFA / ManPages / LUFAvsAtmelStack.txt
index 8f39b72..239c277 100644 (file)
@@ -1,46 +1,52 @@
-/** \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
-/**\r
- *  \page Page_LUFAvsAtmelStack LUFA vs the Atmel Stack\r
- *\r
- *  Atmel offers an official USB AVR stack, which may be incorporated into user projects and products. As LUFA and the Atmel\r
- *  stack aims to give roughly the same functionality to a design, it is often asked what advantages LUFA carries over the\r
- *  official Atmel USB stack. Below are just some of the advantages to choosing LUFA over the official stack.\r
- *\r
- *  - <b>Licensing:</b>\r
- *    LUFA is released under a very permissive MIT license (see \ref Page_LicenceInfo), while the Atmel stack carries several\r
- *    restrictions as to how and where it can be used. LUFA's licensing should be suitable for both Commercial and Non-Commercial\r
- *    entities alike.\r
- *\r
- *  - <b>Demos and Projects:</b>\r
- *    Unlike the Atmel stack, LUFA comes with many different Device and Host mode Demos and Projects ready to run out of the box.\r
- *    Atmel favours separate downloads for each of their (small set) of USB AVR demos, which requires more time and offers less\r
- *    to the end-user. LUFA also contains several open source Bootloaders, which can be modified as the user wishes to suit his or\r
- *    her application, instead of being forced to use Atmel's single prebuilt (closed-source) DFU bootloader.\r
- *\r
- *  - <b>Central Library Code:</b>\r
- *    LUFA is designed to allow the central library core code to be shared amongst several projects, so long as the compiled object\r
- *    files are cleaned between different projects. This is in direct contrast to the Atmel library, which is strongly coupled to the\r
- *    project it is integrated with. Using LUFA allows for only one copy of the library core to be needed for all applications, and\r
- *    makes updating the library used in all projects a trivial copy-and-paste process.\r
- *\r
- *  - <b>Clean API:</b>\r
- *    One of the main design goals of LUFA is to make the API easy to use. While LUFA is a fluid project which has undergone many\r
- *    API improvements, the API is arguably much nicer to use and easier to understand than the equivelent Atmel stack code. LUFA's\r
- *    API is also more complete than the Atmel stack, and contains many features to speed up application development.\r
- *\r
- *  - <b>Full Hardware Support:</b>\r
- *    LUFA supports the full range of Atmel's USB AVR microcontrollers (see \ref Page_DeviceSupport), with porting between chips being\r
- *    as simple as a single compile switch in many cases. Atmel's stack requires different libraries to be used based on the USB AVR\r
- *    microcontroller series, complicating the process of moving between USB AVR models. In addition, LUFA contains drivers for all the\r
- *    hardware contained on Atmel's USB AVR based boards, so you can get started quickly and easily.\r
- *\r
- *  - <b>Better Library Support:</b>\r
- *    As many people are now using LUFA, there is a community being built around it. You can get answers to your LUFA related questions\r
- *    quickly by either emailing the library author (subject to author's schedule) or by posting to the official LUFA support mailing list.\r
- */\r
\ No newline at end of file
+/** \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_LUFAvsAtmelStack LUFA vs the Atmel 8-bit USB AVR Stack
+ *
+ *  Atmel offers an official 8-bit USB AVR stack, which may be incorporated into user projects and products. As LUFA and the Atmel
+ *  stack aims to give roughly the same functionality to a design, it is often asked what advantages LUFA carries over the official
+ *  Atmel USB stack for the 8-bit USB AVRs. Below are just some of the advantages to choosing LUFA over the official Atmel stack.
+ *
+ *  - <b>Licensing:</b>
+ *    LUFA is released under a very permissive MIT license (see \ref Page_LicenseInfo), while the Atmel stack carries several
+ *    restrictions as to how and where it can be used. LUFA's licensing should be suitable for both Commercial and Non-Commercial
+ *    entities alike.
+ *
+ *  - <b>Demos and Projects:</b>
+ *    Unlike the Atmel stack, LUFA comes with many different Device and Host mode Demos and Projects ready to run out of the box.
+ *    Atmel favors separate downloads for each of their (small set) of USB AVR demos, which requires more time and offers less
+ *    to the end-user. LUFA also contains several open source Bootloaders, which can be modified as the user wishes to suit his or
+ *    her application, instead of being forced to use Atmel's single prebuilt (closed-source) DFU bootloader.
+ *
+ *  - <b>Central Library Code:</b>
+ *    LUFA is designed to allow the central library core code to be shared amongst several projects, so long as the compiled object
+ *    files are cleaned between different projects. This is in direct contrast to the Atmel library, which is strongly coupled to the
+ *    project it is integrated with. Using LUFA allows for only one copy of the library core to be needed for all applications, and
+ *    makes updating the library used in all projects a trivial copy-and-paste process.
+ *
+ *  - <b>Clean API:</b>
+ *    One of the main design goals of LUFA is to make the API easy to use. While LUFA is a fluid project which has undergone many
+ *    API improvements, the API is arguably much nicer to use and easier to understand than the equivalent Atmel stack code. LUFA's
+ *    API is also more complete than the Atmel stack, and contains many features to speed up application development.
+ *
+ *  - <b>Full Hardware Support:</b>
+ *    LUFA supports the full range of Atmel's USB AVR microcontrollers (see \ref Page_DeviceSupport), with porting between chips being
+ *    as simple as a single compile switch in many cases. Atmel's stack requires different libraries to be used based on the USB AVR
+ *    microcontroller series, complicating the process of moving between USB AVR models. In addition, LUFA contains drivers for all the
+ *    hardware contained on Atmel's USB AVR based boards, so you can get started quickly and easily.
+ *
+ *  - <b>Better Library Support:</b>
+ *    As many people are now using LUFA, there is a community being built around it. You can get answers to your LUFA related questions
+ *    quickly by either emailing the library author (subject to author's schedule) or by posting to the official LUFA support mailing list.
+ *
+ *  - <b>More Compact Code:</b>
+ *    LUFA is written from the ground up to compile optimally, using clean code and good design. Two demos giving the same functionality -
+ *    the LUFA Low Level API Mouse Demo vs. the Atmel AVR270 HID Mouse application note shows LUFA to be the clear size winner *.
+ *
+ *  * <i>LUFA Low Level Mouse Demo: 3510 bytes, Atmel AVR270 Mouse Application Note: 4222 bytes, using an identical build environment.</i>
+ */
+