2015 Neil Edelman, distributed under the terms of the MIT License; see readme.txt, or https://opensource.org/licenses/MIT.
Cdoc is a light weight, JavaDoc-style, documentation generator for C. It is not aware of C, but searches in your file for the double asterisk '** ' comment. It does not support ascii art (three or more asterisks are not recognised.) It does not support writing html in your source code, and escapes '<>&' in html mode; placing two new lines is sufficient to start a new paragraph. Placing '* ' or '- ' as the first non-white space characters starts a list.
The following symbols are recognised:
Cdoc decides based on context of the following code whether it goes in the preamble, functions, or declarations. It uses simple, but inexact heuristic, which may become confused. It supports macro-generics if you write them just like, void A_BI_(Create, Thing)(void); it will transform it into, <A>Create<BI>Thing(void).
Each-expressions must come first on the line. These are accepted globally:
these are accepted in the preamble:
these are accepted before functions:
|Return Type||Function Name||Argument List|
|int||main||int argc, char *argv|