c2man | Graham Stoney's mechanized man page generator. | Mehr ...
Please do not use c2man -- it is unmaintained upstream now, and only exists because other packages depend on it. Doxygen does a far better job. . C2man is an automatic documentation tool that extracts comments from C source code to generate functional interface documentation in the same format as sections 2 & 3 of the Unix Programmer's Manual. It requires minimal effort from the programmer by looking for comments in the usual places near the objects they document, rather than imposing a rigid function-comment syntax or requiring that the programmer learn and use a typesetting language. Acceptable documentation can often be generated from existing code with no modifications. . conformance: supports both K&R and ISO/ANSI C coding styles -- but it has problems with variable names of type __somename. . Features: * generates output in nroff -man, TeXinfo, LaTeX or HTML format * handles comments as part of the language grammar * automagically documents enum parameter & return values * handles C (/* */) and C++ (//) style comments Problems: * doesn't handle C++ grammar (yet) * doxygen does this job better
