1. Graham Stoney's mechanized man page generator 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 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 From Debian 3.0r0 APT

2. generate manual pages from C source code From whatis