This file is a place holder and will eventually
be replaced.  Currently this project is incomplete
and is not available.

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

AsmPub is a simple document program that extracts
comments from source files to build manuals.

The start of a document block begins with       ;@
This is followed by optional sort keys          key1,key2,key3,etc
All this is on the first line.
The end of document block is a single line with ;@

The sort keys control how document is ordered.  Three
levels will use three keys and a simple one level
document only needs one key.  The keys are sorted
alphabetically if no special handling is requested.

Special handling for sort keys can specify a section
be placed at start of its level by:      _n_
The "n" is a numeric value to specify order of multiple
front sections.
To place sections at end of thier level use ~n~
The "n" is a numberic value to specify order of
ending sections.

The first line after a section beginning is the
title line to place in index and at start of block.
These title lines will be numbered and create a
document that appeas as follows:

1 animals
 1.1 dogs
 1.2 cats
2 foods
 2.1 bad foods

Sections will be extracted from all source files
in the current directory or a specified file.  Recursion
to subdrectories will be automatic.

The first pass builds a list of document blocks and
pointers to each block.  The second pass sorts all
pointers.  Finally, the last pass will remove all
special handling characters and all comment ";" characters
from the document.  It also numbers each section.

