Change to Doxygen (javadoc) code commenting
If enough contributors request it, I could be convinced to switch to Doxygen/javadoc style comments so that the code could be processed by doxygen. Doxygen/javadoc comments are a bit bulkier than my personal style, but sometimes it's useful to have text descriptions of the parameter and return values.
My preference is to name variables so that it's obvious how they are
intended to be used. For example, I much prefer variable names like ok and fail to the generic ret that one often sees.
Change History
(11)
| Description: |
modified (diff)
|
| Owner: |
changed from StevenHL to Steven Levine
|
| Status: |
new → assigned
|
| Summary: |
Change to Javadoc code commenting → Change to Doxygen (javadoc) code commenting
|
| Owner: |
Steven Levine removed
|
| Status: |
assigned → new
|
| Component: |
fm/2 base → Documentation
|
| Milestone: |
→ Release_3.21
|
| Owner: |
set to Gregg Young
|
| Status: |
new → assigned
|
| Resolution: |
→ fixed
|
| Status: |
assigned → closed
|
CS 1616 changes a*.c files comments to Doxygen style