Usage:
------

doc [<--sql, --cxx, --cobol, --sh>] [<--concat>] <files>

   --sql  : The next arguments are files of type sql
   --cxx  : The next arguments are files of type c/c++ (this is default)
   --cobol: The next arguments are files of type cobol
   --sh   : The next arguments are files of type bourne shell

   --concat: concatenate files of the same id (see below).


Keywords:
---------

In this text, c++ comments are used, but shell comments can
also be used,etc.

//id <id>
This gives files an Identifier. With doc_concat, files of the
same Identifier can be assembled and concatenated in sorted order given
by keyword order.

//order <order-id>
Gives the order for concatenation.

//lit
Take the next lines to be literal, i.e. don't interpret, until //end.

//ref
Insert a bookmark here.

//imp
This is implementation; until //endimp document everything at the next
lines.

//endimp
This is the end of implementation for now.

//doc [header]
Beginning of documentation. Header is inserted for the optional
header. If no header is given, 'Algemeen' is used. Level of header
is determined by the target system. End documentation by //end

    Target 	Level
    -----------------
    Word 97	   2

//incdoc <file>
Include this file for documentation. The target system decides what
document type/extension it should be. E.g. the doc.bas word97 macro
desides it is a file of .doc type (i.e. a word file) to be inserted.

//kop <header>
Generic header. Level is determined by target system.

    Target 	Level
    -----------------
    Word 97	   2


//h1 <header>
Insert header of level 1.

//h2 <header>
Insert header of level 2.

//h3 <header>
Insert header of level 3.

//h4 <header>
Insert header of level 4.

//bold <line>
This line should be bold.

//sec
Begin documentation, without header. End documentation by //end.

//def
Begin definition documentation. End documentation by //end.
The next lines are interpreted as a definition. The first empty
line following indicates the end of the definitionpart. The rest
is text explaining the definition.

//end
End of documentation.

//<text>
Documentation line.

-ID-
Insert the identifier of this document at the place of -ID-.

-REF-(bookmark)
Insert a reference to bookmark at this place. The target system
determines what kind of reference it is and places the right text.
e.g.

   Target        Interpretation
   -------------------------------------------------------------------
   Word97        -REF-(bookmark) -> page N  (N=page of //ref bookmark)


Further:
--------
Any text between beginning of documentation and //end is echoed, except
text between { }.



