[IPOL discuss] IPOL Software Guidelines, 2nd draft (and last one?)

Pascal Getreuer getreuer at gmail.com
Tue Nov 22 01:16:11 CET 2011


Another remark:
For authors to measure their comment ratio (4.2. Source Code
Documentation), a nice tool is "cloc" (Count Llines Of Code) [1].  It
would be good to mention in Annex C.  Cloc counts the number of
physical code lines, comment lines, and blank lines per
file/directory/archive, and it can handle a wide array of languages.
The percentage of comment lines, ignoring blank lines, can be computed
from its results as

 (100.0*nComment)/(nComment+nCode) = value between 0 and 100.

[1] http://cloc.sourceforge.net/


Pascal


More information about the discuss mailing list