This section lists a number of macros that can be used to modify the looks of
your document. When used, these macros must appear bf(before) stating the
document type with tt(article), tt(report), tt(book), tt(manpage) or 
tt(plainhtml).

startit()

    it() tt(abstract(text)): This macro is relevant for all output formats. 
    The tt(text) is added to the document after the title, author and date 
    information, but before the table of contents. The abstract is usually set 
    as a quote, in italics font (though this depends on the output format). 
    Abstracts are supported in tt(article)s and tt(report)s, but not in 
    other document types. I.e., if you need introductory text in a tt(book), 
    you should start with a non-numbered chapter that holds this text.
    
    it() tt(affiliation(site)): This macro is relevant for tt(article), 
    tt(report) and tt(book) documents. It defines the affiliation of the 
    author. The tt(site) information appears in the title, below the author's 
    name. 

    it() tt(htmlbodyopt(option)(value)): This macro adds tt(option="value") to 
    the tt(<body>) tag that will be generated for HTML output. The HTML 
    converter generates tt(<body>) tags each time that a new file is started; 
    i.e., at the top of the document and at each chapter-file. Different HTML 
    browsers support different tt(<body>) tag options, but useful ones may be 
    e.g.: 
    
verb(\
htmlbodyopt(fgcolor)(#000000)
htmlbodyopt(bgcolor)(#FFFFFF))

    This defines the foreground color as pure white (red/green/blue all 0) and 
    the background color as black (red/green/blue all hexadecimal FF, or 255).
    Another useful option may be tt(htmlbodyopt(background) (some.gif)),
    defining tt(some.gif) as the page background.
    
    See the documentation on HTML for more information.
    
    Note that the tt(value) is automatically surrounded by double quotes when 
    this macro is used. There is no need to type them.

    it() tt(latexdocumentstyle(style)): This macro forces the
    tt(\documentstyle{...}) setting in LaTeX output to tt(style). E.g., at the ICCE
    we have a local tt(article)-derivate called tt(artikel1). Using

verb(\
latexdocumentstyle(artikel1)
article(..title..)
       (..author..)
       (..date..))

    will start an article as far as Yodl is concerned, but will use tt(artikel1) in
    the LaTeX output.
    
    it() tt(latexlayoutcmds(commands)): This macro can be used to specify your 
    own LaTeX layout commands. When present, the tt(commands) are placed in 
    LaTeX output following the tt(\documentstyle) stanza. (Thanks, 
    Bernhard Reiter tt(<breiter@mathematik.Uni-Osnabrueck.DE>)).
    
    it() tt(latexoptions(options)): This macro is only relevant for LaTeX
    output formats, it is not expanded in other formats. The tt(options) are
    used in LaTeX's tt(\documentstyle) preamble; e.g., useful options may be
    tt(dina4) or tt(epsf). To specify several options, separate them by a 
    comma (this is a LaTeX convention).
    
    bf(Backward compatibility note:) At the ICCE, we've used Linuxdoc-SGML for
    some time. The modifier
    
verb(latexoptions(linuxdoc-sgml,qwertz))

    approximates the LaTeX output that this SGML variant produces. The style
    files tt(linuxdoc-sgml.sty) and tt(qwertz.sty) must of course be in one of
    the tt(TEXINPUTS) directories. 
    
    it() tt(mailto(email)): The tt(mailto) macro is only expanded in HTML
    documents. It defines where mail about the document should go to.
    
    it() tt(nosloppyhfuzz()): By default, the LaTeX output contains the text
    
verb(\hfuzz=4pt)

    which is placed there by the macro package. This suppresses em(overfull
    hbox) warnings of LaTeX when the overfull-ness is less than 4pt. I find
    this useful.
    
    This macro has no consequences for non-LaTeX formats.
    
    Use tt(nosloppyhfuzz()) to get `plain' LaTeX warnings about overfull
    hboxes. 
    
    it() tt(notableofcontents()): As the name suggests, this macro suppresses
    the generation of the table of contents. For HTML that means that no
    clickable index of sections appears after the document title.

    The table of contents is by default suppressed in tt(plainhtml) and
    tt(manpage) documents.

    it() tt(notitleclearpage()): Normally, Yodl inserts a tt(clearpage())
    directive after typesetting title information in tt(book) or tt(report)
    documents, but not in tt(article) documents. Use tt(notitleclearpage) to
    suppress this directive.

    it() tt(notocclearpage())+footnote(Read as: em(no-toc-clearpage), read
    tt(toc) as em(table of contents).): In all document types, Yodl inserts a
    tt(clearpage()) directive following the table of contents. Use
    tt(notocclearpage()) to suppress that.

    it() tt(noxlatin()): The LaTeX output contains by default the stanza to
    include the file tt(xlatin1.tex), distributed with Yodl. This file maps
    Latin-1 characters to LaTeX-understandable codes and makes sure that you
    can type characters such as tt(ü), and still make them processable by
    LaTeX. If you don't want this, put tt(noxlatin()) in the preamble.
    
    it() tt(standardlayout()): This is another LaTeX option. I like my
    paragraph starts not to be indented, and I like more space between
    paragraphs. Use tt(standardlayout()) to get `vanilla' LaTeX layout.
    
    This macro has no consequences for non-LaTeX formats.

    it() tt(titleclearpage()): Forces the insertion of a tt(clearpage())
    directive after the title information has been typeset. This behavior is the
    default in tt(book) and tt(report) documents. See also
    tt(notitleclearpage()).

    it() tt(tocclearpage()): Forces the insertion of a tt(clearpage()) directive
    following the table of contents. This behavior is default in all document
    types; the macro is provided for consistency reasons with
    tt((no)titleclearpage()).
    
endit()

bf(Note again) that when present, the modifiers must appear bf(before) the 
document type definition.
