Short: Automated doc. from c sources (autodoc) Author: ruppert@vs3.informatik.fh-wiesbaden.de Uploader: ruppert vs3 informatik fh-wiesbaden de Type: dev/misc Architecture: m68k-amigaos This is my port of the c2man patchlevel 33 for the Amiga. I added a Commodore AutoDoc output format backend. So you can use this outputs with your favorite autodoc formatting utility. Read the c2man manual for getting started with c2man. If you have groff, a LaTeX package or makeinfo installed you can also use c2man for generating these output formats. I have tested the nroff format with the groff port 1.07. I have compiled c2man with SAS-C V6.51 with the STACKCHECK option ON , because c2man requires more than the standard 4096 bytes. If you don't like this recompile it , but you must have bison/yacc and flex/lex ! A stack of 10000 bytes seems enough . For this port I used the popen implementation from the AmiTCP 4.0 demo package. The original version was written by Rick Schaeffer and by Jarno Rajahalme from the AmiTCP/IP Group . You need also a preprocessor, which supports non-stripping of comments ! I used the cpp from the AmiTCP 4.0 demo package, but you can also use the cpp from gcc or gcc with "gcc -E -C". The following option is added in the Amiga port : -T a : select autodoc output format. This output format is default ! The following command shows, how you can use the c2man program (Note: this implies, that you have installed the Pipe package) : c2man -o- your_c_source.c c2man supports grouping of source files. This means if two source files are passed on the command line, each function in this files links to each other. But if you have two or more groups of such files you can use the following command : c2man -o- csource1.c csource2.c || c2man -o- anothercsource.c | sortad to test.doc This functions with the Pipe1_5.lha package, which uses the '||' to concate outputs. sortad is used to put all docs together and to generate the sorted list of contents. sortad is copyrighted by Stefan Ruppert, but is freely distributable with c2man ! Stefan Ruppert Windthorststraße 5 65439 Flörsheim am Main GERMANY EMail: ruppert@vs3.informatik.fh-wiesbaden.de