Difference between revisions of "Documentation"

From Avogadro - Free cross-platform molecule editor
Jump to: navigation, search
 
Line 1: Line 1:
 
 
Give an @author when possible.  When you make changes add your name to the list.
 
Give an @author when possible.  When you make changes add your name to the list.
  
Line 7: Line 6:
 
: Do not capitalize the first word of the description.
 
: Do not capitalize the first word of the description.
 
: Do not include an ending period (.) unless the description contains multiple sentences.
 
: Do not include an ending period (.) unless the description contains multiple sentences.
 +
 +
 +
== Links ==
 +
[http://techbase.kde.org/Policies/Library_Documentation_Policy KDE Library Documentation Policy]

Revision as of 11:38, 15 March 2007

Give an @author when possible. When you make changes add your name to the list.

Use @brief comments only for class definitions, this is the only case where brief will be beneficial.

Parameters (@param) and return (@return) values:

Do not capitalize the first word of the description.
Do not include an ending period (.) unless the description contains multiple sentences.


Links

KDE Library Documentation Policy