X-Git-Url: http://git.linex4red.de/pub/USBasp.git/blobdiff_plain/90b6bf9e256eea7bb5e493b8f871e2e9f2e1e06d..b8807e9928ec39cb271e28fe3c6a58c60719a60b:/LUFA/DoxygenPages/BuildSystem.txt?ds=inline
diff --git a/LUFA/DoxygenPages/BuildSystem.txt b/LUFA/DoxygenPages/BuildSystem.txt
index 9a460d30a..c30a88bb4 100644
--- a/LUFA/DoxygenPages/BuildSystem.txt
+++ b/LUFA/DoxygenPages/BuildSystem.txt
@@ -12,9 +12,12 @@
* application makefile. The system is written in GNU Make, and each module is independant of
* one-another.
*
+ * 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:
* \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.
@@ -50,7 +53,7 @@
*
* 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
@@ -97,6 +100,10 @@
* | clean |
* Remove all intermediatary files and binary output files. |
*
+ *
+ * | mostlyclean |
+ * Remove all intermediatary files but preserve any binary output files. |
+ *
*
*
* \section SSec_BuildModule_BUILD_MandatoryParams Mandatory Parameters
@@ -148,6 +155,14 @@
* Version of the C++ standard to apply when compiling C++ source files (see GCC manual). |
*
*
+ * | DEBUG_FORMAT |
+ * Format of the debug information to embed in the generated object files (see GCC manual). |
+ *
+ *
+ * | DEBUG_LEVEL |
+ * Level of the debugging information to embed in the generated object files (see GCC manual). |
+ *
+ *
* | F_CPU |
* Speed of the processor CPU clock, in Hz. |
*
@@ -165,7 +180,7 @@
*
*
* | CC_FLAGS |
- * Common flags to pass to the compiler, assembler and linker, after the automatically generated flags. |
+ * Common flags to pass to the C/C++ compiler and assembler, after the automatically generated flags. |
*
*
* | LD_FLAGS |
@@ -174,11 +189,15 @@
*
* | OBJDIR |
* 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. |
+ * \note When this option is enabled, all source filenames must be unique.
+ *
+ *
+ * | OBJECT_FILES |
+ * List of additional object files that should be linked into the resulting binary. |
*
*
*
- * \section SSec_BuildModule_BUILD_ProvideVariables Module Provided Variables
+ * \section SSec_BuildModule_BUILD_ProvidedVariables Module Provided Variables
*
*
*
@@ -201,7 +220,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
@@ -257,7 +276,7 @@
*
*
*
- * \section SSec_BuildModule_CORE_ProvideVariables Module Provided Variables
+ * \section SSec_BuildModule_CORE_ProvidedVariables Module Provided Variables
*
*
*
@@ -281,7 +300,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
@@ -332,7 +351,7 @@
*
*
*
- * \section SSec_BuildModule_ATPROGRAM_ProvideVariables Module Provided Variables
+ * \section SSec_BuildModule_ATPROGRAM_ProvidedVariables Module Provided Variables
*
*
*
@@ -356,7 +375,7 @@
*
* 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
@@ -408,7 +427,7 @@
*
*
*
- * \section SSec_BuildModule_AVRDUDE_ProvideVariables Module Provided Variables
+ * \section SSec_BuildModule_AVRDUDE_ProvidedVariables Module Provided Variables
*
*
*
@@ -432,7 +451,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
@@ -500,7 +519,7 @@
*
*
*
- * \section SSec_BuildModule_CPPCHECK_ProvideVariables Module Provided Variables
+ * \section SSec_BuildModule_CPPCHECK_ProvidedVariables Module Provided Variables
*
*
*
@@ -526,7 +545,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
@@ -577,7 +596,7 @@
*
*
*
- * \section SSec_BuildModule_DFU_ProvideVariables Module Provided Variables
+ * \section SSec_BuildModule_DFU_ProvidedVariables Module Provided Variables
*
*
*
@@ -602,7 +621,7 @@
*
* 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
@@ -646,7 +665,7 @@
*
*
*
- * \section SSec_BuildModule_DOXYGEN_ProvideVariables Module Provided Variables
+ * \section SSec_BuildModule_DOXYGEN_ProvidedVariables Module Provided Variables
*
*
*
@@ -672,7 +691,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
@@ -689,9 +708,21 @@
* | Program the device FLASH memory with the application's executable data using hid_bootloader_cli. |
*
*
- * | hid-teensy |
+ * hid-ee |
+ * Program the device EEPROM memory with the application's EEPROM data using hid_bootloader_cli and
+ * a temporary AVR application programmed into the target's FLASH.
+ * \note This will erase the currently loaded application in the target. |
+ *
+ *
+ * | teensy |
* Program the device FLASH memory with the application's executable data using teensy_loader_cli. |
*
+ *
+ * | teensy-ee |
+ * Program the device EEPROM memory with the application's EEPROM data using teensy_loader_cli and
+ * a temporary AVR application programmed into the target's FLASH.
+ * \note This will erase the currently loaded application in the target. |
+ *
*
*
* \section SSec_BuildModule_HID_MandatoryParams Mandatory Parameters
@@ -715,7 +746,7 @@
*
*
*
- * \section SSec_BuildModule_HID_ProvideVariables Module Provided Variables
+ * \section SSec_BuildModule_HID_ProvidedVariables Module Provided Variables
*
*
*
@@ -741,7 +772,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
@@ -776,7 +807,7 @@
*
*
*
- * \section SSec_BuildModule_SOURCES_ProvideVariables Module Provided Variables
+ * \section SSec_BuildModule_SOURCES_ProvidedVariables Module Provided Variables
*
*