c2man

An automatic {documentation} extraction tool by Graham

Stoney . 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 (1995-10-25).

{Washington FTP

(ftp://ftp.wustl.edu/usenet/comp.sources.reviewed/volume03/)}.

{Stuttgart FTP

(ftp://ftp.informatik.uni-stuttgart.de/pub/archive/comp.sources/reviewe