X-Git-Url: http://git.linex4red.de/pub/USBasp.git/blobdiff_plain/80fab49e1dafaa4eaefd14a34245888bf9ee3804..c93259fbdbfec154b37fd4c3a4e1b43f5b7265e5:/LUFA/DoxygenPages/BuildSystem.txt

diff --git a/LUFA/DoxygenPages/BuildSystem.txt b/LUFA/DoxygenPages/BuildSystem.txt
index 1b26381bc..57dec5424 100644
--- a/LUFA/DoxygenPages/BuildSystem.txt
+++ b/LUFA/DoxygenPages/BuildSystem.txt
@@ -15,14 +15,15 @@
  *  For details on the prerequisites needed for Linux and Windows machines to be able to use the LUFA
  *  build system, see \ref Sec_Prerequisites.
  *
- *  To use a LUFA build system module, simply add an include to your project makefile:
+ *  To use a LUFA build system module, simply add an include to your project makefile. All user projects
+ *  should at a minimum include \ref Page_BuildModule_CORE for base functionality:
  *  \code
- *  include $(LUFA_PATH)/Build/lufa.core.in
+ *  include $(LUFA_PATH)/Build/lufa_core.mk
  *  \endcode
  *
- *  And the associated build module targets will be added to your project's build makefile automatically.
- *  To call a build target, run <tt>make {TARGET_NAME}</tt> from the command line, substituting in
- *  the appropriate target name.
+ *  Once included in your project makefile, the associated build module targets will be added to your
+ *  project's build makefile targets automatically. To call a build target, run <tt>make {TARGET_NAME}</tt>
+ *  from the command line, substituting in the appropriate target name.
  *
  *  \see \ref Sec_AppConfigParams for a copy of the sample LUFA project makefile.
  *
@@ -49,15 +50,15 @@
  *
  *  The BUILD LUFA build system module, providing targets for the compilation,
  *  assembling and linking of an application from source code into binary files
- *  suitable for programming into a target device.
+ *  suitable for programming into a target device, using the GCC compiler.
  *
  *  To use this module in your application makefile, add the following code:
  *  \code
- *  include $(LUFA_PATH)/Build/lufa.build.in
+ *  include $(LUFA_PATH)/Build/lufa_build.mk
  *  \endcode
  *
  *  \section SSec_BuildModule_BUILD_Requirements Requirements
- *  This module requires the the architecture appropriate binaries of the GCC compiler are  available in your
+ *  This module requires the the architecture appropriate binaries of the GCC compiler are available in your
  *  system's <b>PATH</b> variable. The GCC compiler and associated toolchain is distributed in Atmel AVR Studio
  *  5.x and Atmel Studio 6.x installation directories, as well as in many third party distribution packages.
  *
@@ -73,10 +74,6 @@
  *    <td>Display a size-sorted list of symbols from the compiled application, in decimal bytes.</td>
  *   </tr>
  *   <tr>
- *    <td><tt>check-source</tt></td>
- *    <td>Display a list of input SRC source files which cannot be found (if any).</td>
- *   </tr>
- *   <tr>
  *    <td><tt>lib</tt></td>
  *    <td>Build and archive all source files into a library A binary file.</td>
  *   </tr>
@@ -104,6 +101,10 @@
  *    <td><tt>mostlyclean</tt></td>
  *    <td>Remove all intermediatary files but preserve any binary output files.</td>
  *   </tr>
+ *   <tr>
+ *    <td><tt><i>&lt;filename&gt;</i>.s</tt></td>
+ *    <td>Create an assembly listing of a given input C/C++ source file.</td>
+ *   </tr>
  *  </table>
  *
  *  \section SSec_BuildModule_BUILD_MandatoryParams Mandatory Parameters
@@ -155,6 +156,14 @@
  *    <td>Version of the C++ standard to apply when compiling C++ source files (see GCC manual).</td>
  *   </tr>
  *   <tr>
+ *    <td><tt>DEBUG_FORMAT</tt></td>
+ *    <td>Format of the debug information to embed in the generated object files (see GCC manual).</td>
+ *   </tr>
+ *   <tr>
+ *    <td><tt>DEBUG_LEVEL</tt></td>
+ *    <td>Level of the debugging information to embed in the generated object files (see GCC manual).</td>
+ *   </tr>
+ *   <tr>
  *    <td><tt>F_CPU</tt></td>
  *    <td>Speed of the processor CPU clock, in Hz.</td>
  *   </tr>
@@ -172,7 +181,7 @@
  *   </tr>
  *   <tr>
  *    <td><tt>CC_FLAGS</tt></td>
- *    <td>Common flags to pass to the compiler, assembler and linker, after the automatically generated flags.</td>
+ *    <td>Common flags to pass to the C/C++ compiler and assembler, after the automatically generated flags.</td>
  *   </tr>
  *   <tr>
  *    <td><tt>LD_FLAGS</tt></td>
@@ -181,11 +190,15 @@
  *   <tr>
  *    <td><tt>OBJDIR</tt></td>
  *    <td>Directory to place the generated object and dependency files. If set to "." the same folder as the source file will be used.
- *        \note When this option is enabled, all source filenames must be unique.</td>
+ *        \note When this option is enabled, all source filenames <b>must</b> be unique.</td>
+ *   </tr>
+ *   <tr>
+ *    <td><tt>OBJECT_FILES</tt></td>
+ *    <td>List of additional object files that should be linked into the resulting binary.</td>
  *   </tr>
  *  </table>
  *
- *  \section SSec_BuildModule_BUILD_ProvideVariables Module Provided Variables
+ *  \section SSec_BuildModule_BUILD_ProvidedVariables Module Provided Variables
  *
  *  <table>
  *   <tr>
@@ -208,7 +221,7 @@
  *
  *  To use this module in your application makefile, add the following code:
  *  \code
- *  include $(LUFA_PATH)/Build/lufa.core.in
+ *  include $(LUFA_PATH)/Build/lufa_core.mk
  *  \endcode
  *
  *  \section SSec_BuildModule_CORE_Requirements Requirements
@@ -264,7 +277,7 @@
  *   </tr>
  *  </table>
  *
- *  \section SSec_BuildModule_CORE_ProvideVariables Module Provided Variables
+ *  \section SSec_BuildModule_CORE_ProvidedVariables Module Provided Variables
  *
  *  <table>
  *   <tr>
@@ -288,7 +301,7 @@
  *
  *  To use this module in your application makefile, add the following code:
  *  \code
- *  include $(LUFA_PATH)/Build/lufa.atprogram.in
+ *  include $(LUFA_PATH)/Build/lufa_atprogram.mk
  *  \endcode
  *
  *  \section SSec_BuildModule_ATPROGRAM_Requirements Requirements
@@ -339,7 +352,7 @@
  *   </tr>
  *  </table>
  *
- *  \section SSec_BuildModule_ATPROGRAM_ProvideVariables Module Provided Variables
+ *  \section SSec_BuildModule_ATPROGRAM_ProvidedVariables Module Provided Variables
  *
  *  <table>
  *   <tr>
@@ -363,13 +376,13 @@
  *
  *  To use this module in your application makefile, add the following code:
  *  \code
- *  include $(LUFA_PATH)/Build/lufa.avrdude.in
+ *  include $(LUFA_PATH)/Build/lufa_avrdude.mk
  *  \endcode
  *
  *  \section SSec_BuildModule_AVRDUDE_Requirements Requirements
  *  This module requires the <tt>avrdude</tt> utility to be available in your system's <b>PATH</b>
  *  variable. The <tt>avrdude</tt> utility is distributed in the old WinAVR project releases for
- *  Windows (<a>winavr.sourceforge.net</a>) or can be installed on *nix systems via the project's
+ *  Windows (<a>http://winavr.sourceforge.net</a>) or can be installed on *nix systems via the project's
  *  source code (<a>https://savannah.nongnu.org/projects/avrdude</a>) or through the package manager.
  *
  *  \section SSec_BuildModule_AVRDUDE_Targets Targets
@@ -380,7 +393,7 @@
  *    <td>Program the device FLASH memory with the application's executable data.</td>
  *   </tr>
  *   <tr>
- *    <td><tt>avrdude</tt></td>
+ *    <td><tt>avrdude-ee</tt></td>
  *    <td>Program the device EEPROM memory with the application's EEPROM data.</td>
  *   </tr>
  *  </table>
@@ -406,16 +419,16 @@
  *    <td>Name of the programmer or debugger tool to communicate with (e.g. <tt>jtagicemkii</tt>).</td>
  *   </tr>
  *   <tr>
- *    <td><tt>ATPROGRAM_PORT</tt></td>
+ *    <td><tt>AVRDUDE_PORT</tt></td>
  *    <td>Name of the communication port to use when when programming with the connected tool (e.g. <tt>COM2</tt>, <tt>/dev/ttyUSB0</tt> or <tt>usb</tt>).</td>
  *   </tr>
  *   <tr>
- *    <td><tt>ATPROGRAM_FLAGS</tt></td>
+ *    <td><tt>AVRDUDE_FLAGS</tt></td>
  *    <td>Additional flags to pass to avrdude when programming, applied after the automatically generated flags.</td>
  *   </tr>
  *  </table>
  *
- *  \section SSec_BuildModule_AVRDUDE_ProvideVariables Module Provided Variables
+ *  \section SSec_BuildModule_AVRDUDE_ProvidedVariables Module Provided Variables
  *
  *  <table>
  *   <tr>
@@ -439,7 +452,7 @@
  *
  *  To use this module in your application makefile, add the following code:
  *  \code
- *  include $(LUFA_PATH)/Build/lufa.cppcheck.in
+ *  include $(LUFA_PATH)/Build/lufa_cppcheck.mk
  *  \endcode
  *
  *  \section SSec_BuildModule_CPPCHECK_Requirements Requirements
@@ -507,7 +520,7 @@
  *   </tr>
  *  </table>
  *
- *  \section SSec_BuildModule_CPPCHECK_ProvideVariables Module Provided Variables
+ *  \section SSec_BuildModule_CPPCHECK_ProvidedVariables Module Provided Variables
  *
  *  <table>
  *   <tr>
@@ -533,7 +546,7 @@
  *
  *  To use this module in your application makefile, add the following code:
  *  \code
- *  include $(LUFA_PATH)/Build/lufa.dfu.in
+ *  include $(LUFA_PATH)/Build/lufa_dfu.mk
  *  \endcode
  *
  *  \section SSec_BuildModule_DFU_Requirements Requirements
@@ -584,7 +597,7 @@
  *   </tr>
  *  </table>
  *
- *  \section SSec_BuildModule_DFU_ProvideVariables Module Provided Variables
+ *  \section SSec_BuildModule_DFU_ProvidedVariables Module Provided Variables
  *
  *  <table>
  *   <tr>
@@ -609,14 +622,14 @@
  *
  *  To use this module in your application makefile, add the following code:
  *  \code
- *  include $(LUFA_PATH)/Build/lufa.doxygen.in
+ *  include $(LUFA_PATH)/Build/lufa_doxygen.mk
  *  \endcode
  *
  *  \section SSec_BuildModule_DOXYGEN_Requirements Requirements
  *  This module requires the <tt>doxygen</tt> utility from the Doxygen website
- *  (<a>http://www.stack.nl/~dimitri/doxygen/</a>) to be available in your system's <b>PATH</b>
- *  variable. On *nix systems the <tt>doxygen</tt> utility can be installed via the project's source
- *  code or through the package manager.
+ *  (<a>http://www.doxygen.org/</a>) to be available in your system's <b>PATH</b> variable. On *nix
+ *  systems the <tt>doxygen</tt> utility can be installed via the project's source code or through
+ *  the package manager.
  *
  *  \section SSec_BuildModule_DOXYGEN_Targets Targets
  *
@@ -625,6 +638,14 @@
  *    <td><tt>doxygen</tt></td>
  *    <td>Generate project documentation.</td>
  *   </tr>
+ *   <tr>
+ *    <td><tt>doxygen_create</tt></td>
+ *    <td>Create a new Doxygen configuration file using the latest template.</td>
+ *   </tr>
+ *   <tr>
+ *    <td><tt>doxygen_upgrade</tt></td>
+ *    <td>Upgrade an existing Doxygen configuration file to the latest template</td>
+ *   </tr>
  *  </table>
  *
  *  \section SSec_BuildModule_DOXYGEN_MandatoryParams Mandatory Parameters
@@ -653,7 +674,7 @@
  *   </tr>
  *  </table>
  *
- *  \section SSec_BuildModule_DOXYGEN_ProvideVariables Module Provided Variables
+ *  \section SSec_BuildModule_DOXYGEN_ProvidedVariables Module Provided Variables
  *
  *  <table>
  *   <tr>
@@ -679,7 +700,7 @@
  *
  *  To use this module in your application makefile, add the following code:
  *  \code
- *  include $(LUFA_PATH)/Build/lufa.hid.in
+ *  include $(LUFA_PATH)/Build/lufa_hid.mk
  *  \endcode
  *
  *  \section SSec_BuildModule_HID_Requirements Requirements
@@ -696,9 +717,21 @@
  *    <td>Program the device FLASH memory with the application's executable data using <tt>hid_bootloader_cli</tt>.</td>
  *   </tr>
  *   <tr>
- *    <td><tt>hid-teensy</tt></td>
+ *    <td><tt>hid-ee</tt></td>
+ *    <td>Program the device EEPROM memory with the application's EEPROM data using <tt>hid_bootloader_cli</tt> and
+ *        a temporary AVR application programmed into the target's FLASH.
+ *        \note This will erase the currently loaded application in the target.</td>
+ *   </tr>
+ *   <tr>
+ *    <td><tt>teensy</tt></td>
  *    <td>Program the device FLASH memory with the application's executable data using <tt>teensy_loader_cli</tt>.</td>
  *   </tr>
+ *   <tr>
+ *    <td><tt>teensy-ee</tt></td>
+ *    <td>Program the device EEPROM memory with the application's EEPROM data using <tt>teensy_loader_cli</tt> and
+ *        a temporary AVR application programmed into the target's FLASH.
+ *        \note This will erase the currently loaded application in the target.</td>
+ *   </tr>
  *  </table>
  *
  *  \section SSec_BuildModule_HID_MandatoryParams Mandatory Parameters
@@ -722,7 +755,7 @@
  *   </tr>
  *  </table>
  *
- *  \section SSec_BuildModule_HID_ProvideVariables Module Provided Variables
+ *  \section SSec_BuildModule_HID_ProvidedVariables Module Provided Variables
  *
  *  <table>
  *   <tr>
@@ -748,7 +781,7 @@
  *
  *  To use this module in your application makefile, add the following code:
  *  \code
- *  include $(LUFA_PATH)/Build/lufa.sources.in
+ *  include $(LUFA_PATH)/Build/lufa_sources.mk
  *  \endcode
  *
  *  \section SSec_BuildModule_SOURCES_Requirements Requirements
@@ -783,7 +816,7 @@
  *   </tr>
  *  </table>
  *
- *  \section SSec_BuildModule_SOURCES_ProvideVariables Module Provided Variables
+ *  \section SSec_BuildModule_SOURCES_ProvidedVariables Module Provided Variables
  *
  *  <table>
  *   <tr>