autogsdoc with TeX backend

autogsdoc with TeX backend (18 April 2003)

The following file contains the sources for a modified version of autogsdoc present in the GNUstep base library. At the moment it is in a pre-alpha stage. Lots of tags not implemented but for the rest it seems to work.

Testing

Download sources autogsdoc-20030418.tar.bz2 (+/- 80 Kb)
unpack the sources
type `make'
run by `./obj/autogsdoc -TeX YES -XLP YES *.h *.m'
put the gnustep.mf somewhere the TeX system can find it
postprocess by `tex autogsdoc.tex'
create pdf with `dvipdfm autogsdoc.dvi'
Or open with HelpViewer version 0.3. (A main.xlp file is automatically generated.)

Features

New since version 20030314

Made better conforming XLP output
Improved output of example tag

New since version 20030316

Added very rudimentary support for standard compliance indicators for TeX backend
Changed XLP output format for HelpViewer version 0.3
XLP output supports more tags. (Still far from compleet)
Fixed some bugs in XLP output

New since version 20030222

Layout changed again
Fixed bug in finding files, should work as replacement of stock autogsdoc.
Added enumeration in TeX
Output class/instance method seperately
Put .tex macro files in Resource directory

New since version 20030215

Somewhat improved layout.
fixed some bugs
Added symbols for designated initializer etcetera. (gnustep.mf)

New since version 20030211

Produces HelpViewer XLP files
cross references in generated pdf files should work for functions, classes and methods.
Sorted output of classes / protocols / function list
Fixed a few bugs, addes some new bugs.

New compared to autogsdoc in Base

Produces .tex files
Slightly rewritten main function.

Example output

The Base.pdf (+/- 1.3Mb) file is an example of a large file processed by autogsdoc version 20030413. This file is created by replacing the standard autogsdoc with the 20030413 version. Output for HelpViewer 0.3 is

Base.help.tar.bz2 (+/- 62Kb)
Gui.help.tar.bz2 (+/- 76Kb)

The files above are generated from a clean source tree. No customization is added to the source files of autogsdoc. Gui.pdf is missing because the Gui.gsdoc file is not in a format suitable for generating one big document.

Future

This should be merged into the GNUstep base version. But first I want to get it in some better shape than it is now. My modifications most probably broke the html output in some ways.