c2man

<tool> An automatic documentation extraction tool by Graham Stoney <greyham@research.canon.oz.au>. c2man extracts comments from C source code to generate functional interface documentation in the same format as sections 2 and 3 of the Unix Programmer's Manual. It looks for comments near the objects they document, rather than imposing a rigid syntax or requiring that the programmer use a typesetting language. Acceptable documentation can often be generated from existing code with no modifications.

It supports both K&R and ISO/ANSI C coding styles. Output can be in nroff -man, Texinfo or LaTeX format. It automagically documents enum parameter and return values, it handles both C (/* */) and C++ (//) style comments, but not C++ grammar (yet). It requires yacc, byacc or bison for syntax analysis; lex or flex for lexical analysis and nroff, groff, texinfo or LaTeX to format the output. It runs under Unix, OS/2 and MS-DOS.

Version 2.0 patchlevel 25 (25 Oct 1995).

Washington FTP. Stuttgart FTP. Patches.

Mailing list: <listserv@research.canon.oz.au> ("subscribe c2man <Your Name>" in the message body).

Patches posted to Usenet newsgroups comp.sources.bugs and comp.sources.reviewed.

(21 Feb 1994)