- Timestamp:
-
11/05/18 17:31:38 (6 years ago)
- Author:
-
Gedare Bloom
- Comment:
-
Add info about creating commits.
Legend:
- Unmodified
- Added
- Removed
- Modified
-
v5
|
v6
|
|
93 | 93 | Again, once modules are in place for all BSP's, a module should be defined to house the doxygen documenting the files shared across all BSPs. |
94 | 94 | |
95 | | Finally, we have reached a group we can really work with, the specific group of the BSP, in this case arm_raspberrypi. You can work with this module the same way you would for using doxygen in general, and can follow the standard doxygen instructions given here and elsewhere. @defgroup new headers in .h files (remembering @ingroup any new headers you define into the BSP group), move protoypes and function comments to the .h and include @briefs, @ingroup relevant .c files, etc etc. These directions can be found in the section [http://www.rtems.org/wiki/index.php/GoogleCodeInProjects#Add_Doxygen_File_Headers Add Doxygen File Headers], and other doxygen reccomendations can be found [http://wiki.rtems.org/wiki/index.php/Doxygen_Recommendations here] |
| 95 | Finally, we have reached a group we can really work with, the specific group of the BSP, in this case arm_raspberrypi. You can work with this module the same way you would for using doxygen in general, and can follow the standard doxygen instructions given here and elsewhere. @defgroup new headers in .h files (remembering @ingroup any new headers you define into the BSP group), move protoypes and function comments to the .h and include @briefs, @ingroup relevant .c files, etc etc. These directions can be found in the section [http://www.rtems.org/wiki/index.php/GoogleCodeInProjects#Add_Doxygen_File_Headers Add Doxygen File Headers], and other doxygen recommendations can be found [http://wiki.rtems.org/wiki/index.php/Doxygen_Recommendations here] |
| 96 | |
| 97 | === Contributing Your Work === |
| 98 | |
| 99 | You are expected to [wiki:Developer/Contributing provide a patch] for all the changes you make. Your task should be specific to a single BSP, so we would like you to use a commit message such as: |
| 100 | {{{ |
| 101 | git commit -a -m "arm/raspberrypi: Update Doxygen (GCI 20xx)" |
| 102 | }}} |
| 103 | Where you would replace arm/raspberrypi by the arch/bsp you modified, and xx by the year of GCI this was done in. You are not required to use your real name and email address in the commit authorship information. |
96 | 104 | |
97 | 105 | === Notes, tips, tricks === |