Short: Autodoc-Formatting Utility
Type: util/misc
Uploader: inf01@uni-trier.de

-- README-File of archive ADFormat.lha follows --------------------------------
ADFormat Version 1.0 README FILE

This is version 1.0 of ADFormat, an Autodoc formatting utility. To use it,
you must at least read the "Legal Stuff" node in the ADFormat.guide Amigaguide
file.

Note: If you don't have AmigaGuide, then you can almost read the Guide file
with a plain text reader. Just ignore the @xxx commands. Even better, get
yourself the AmigaGuide archive from AmiNet or somewhere. Commodore has
by now released AmigaGuide as freely distributable.

-------------------------------------------------------------------------------

What is ADFormat?

ADFormat is a utility to format AutoDocs which where converted to AmigaGuide 
with the AD2HT utility. These files all have an ugly layout, with no 
justification, no multi-column output and all different sized buttons. ADFormat
tries to correct this. It reads in the @NODE MAIN of an Autodoc file and

    - Searches the largest button in the node and extends all other buttons
      according to this one, so that all buttons become the same size.

    - Optionally formats the button to an adjustable number of columns, thus
      giving you more buttons on screen on one page.

    - Optionally inserts a "Back to Autodoc-it"-Button at the top of the
      list, so that you can return to autodoc-it (if you use it at all)
      without having to set a bookmark or going to thousands of RETRACEs.

For further details, look in the ADFormat.guide file, which features a
complete explanation of all the possibilities of ADFormat.

ADFormat was kind of a quickie, I wrote it on one afternoon in august, and
it may still contain bugs. Should you discover some, please let me know (see
the "Legal Stuff"-Chapter in the documentation.