.TH "Yodl macros" "7" "1996\-2017" "yodl_4\&.01\&.00\&.tar\&.gz" "Your Own Document Language"

.PP 
.SH "NAME"
yodlmacros \- Macros for the Yodl converters
.PP 
.SH "SYNOPSIS"
This manual page lists the standard macros of the Yodl package\&.
.PP 
.SH "DESCRIPTION"
The following list shows the macros defined by the Yodl converters
define and which can be used in Yodl documents\&. Refer to the Yodl user
guide, distributed with the Yodl package, for a full description\&.
.PP 
\fBNOTE:\fP Starting with Yodl version 3\&.00\&.0 Yodl\(cq\&s default file inclusion
behavior has changed\&. The current working directory no longer remains fixed at
the directory in which Yodl is called, but is volatile, changing to the
directory in which a yodl\-file is located\&. This has the advantage that Yodl\(cq\&s
file inclusion behavior now matches the way \fBC\fP\(cq\&s \f(CW#include\fP directive
operates; it has the disadvantage that it may break some current
documents\&. Conversion, however is simple but can be avoided altogether if
Yodl\(cq\&s \f(CW\-L\fP (\f(CW\-\-legacy\-include\fP) option is used\&. This affects the
\f(CW(l)includefile, includeverbatim, notransinclude\fP and \f(CWverbinclude\fP macros
(see below)\&.
.PP 
The following list shows all macros of the package in alphabetical
order\&.
.PP 
.IP "\f(CWabstract(text)\fP"
Defines an abstract for an \f(CWarticle\fP or \f(CWreport\fP document\&. Abstracts are
not implemented for \f(CWbook\fPs or \f(CWmanpage\fPs\&. Must appear \fBbefore\fP
starting the document with the \f(CWarticle\fP or \f(CWreport\fP macro\&.
.IP 
.IP "\f(CWaddntosymbol(symbol)(n)(text)\fP"
Adds \f(CWtext\fP \f(CWn\fP times to \f(CWsymbol\fP\&. The value \f(CWn\fP may also be the name
of a defined counter (which itself will not be modified)\&.
.IP 
.IP "\f(CWaffiliation(site)\fP"
Defines an affiliation, to appear in the document titlepage below the author
field\&. Must appear \fBbefore\fP starting the document with \f(CWarticle\fP,
\f(CWreport\fP or \f(CWbook\fP\&. The affiliation is only printed when the author field
is not empty\&. When converting to html the way the affiliation is displayed can
be tuned using CSS id selector specifications\&. The affiliation has
\f(CWid=\(dq\&affiliation\(dq\&\fP\&. 
.IP 
.IP "\f(CWAfourEnlarged()\fP"
Enlarges the usable height of A4 paper by 2 cm\&.: the top margin is reduced by
2 cm\&. This macro should be called in the preamble\&. The macro is available only
for LaTeX conversions\&.
.IP 
.IP "\f(CWappendix()\fP"
Starts appendices
.IP 
.IP "\f(CWarticle(title)(author)(date)\fP"
Starts an article\&. The top\-level sectioning command is \f(CW(n)sect\fP\&. In HTML
conversions only one output file is written, while the way the headings are
displayed can be tuned using CSS id selector specifications: the title has
\f(CWid=\(dq\&title\(dq\&\fP, the author \f(CWid=\(dq\&author\(dq\&\fP, and the date \f(CWid=\(dq\&date\(dq\&\fP\&.)
.IP 
.IP "\f(CWattrib(text)\fP"
In html, pushes \f(CWtext\fP as an attribute for the next html tag supporting
\f(CWattrib\fP\&.  E\&.g, to
set a blue color and 30 pixel left\-hand side margin for a section use
.nf 

    attrib(style=\(dq\&color:blue;margin\-left:30px;\(dq\&)\e 
    sect(Section name)
    
.fi 
This results
in the html markup
.br 
.nf 

    <h1 style=\(dq\&color:blue;margin\-left:30px;\(dq\&>Section name</h1>
    
.fi 
This macro is only effective with html conversions\&. It is applied in a
stack\-wise fasion: when multiple \f(CWattrib\fP calls are used, then the topmost
attrib\-string is added to the first macro calling the 
\f(CWattribinsert\fP macro, with subsequent macros using subsequent elements on
the attrib\-stack\&. 
.IP 
Commonly used attributes are \f(CWid=\(dq\&idname\(dq\&\fP, expecting a \f(CW#idname\fP CSS
label in either internal or external CSS specifications, or \f(CWstyle=\(dq\&spec\(dq\&\fP
(as shown in the example)\&. 
.IP 
Example: when using
.nf 

    attrib(width = \(dq\&100\(dq\& height = \(dq\&100\(dq\&)
    attrib(id = \(dq\&#fig\(dq\&)
    figure(imgfile)(Caption)(IMG)
    
.fi 
then the \f(CW#id\fP attribute is applied to \f(CW<figure>\fP, and the \f(CWwidth\fP
and \f(CWheight\fP attributes are applied to \f(CW<img>\fP, which html markup is
inserted by the \f(CWfigure\fP macro\&.
.IP 
The \f(CWattrib\fP macro is supported by the following predefined macros (between
parentheses the number of attribute strings that are inserted by these macros;
if only 1 attribute string is inserted no number is shown): 
.IP 
\f(CWbf cell cells center chapter code dashes dit em figure(3) file htmltag
itdesc lchapter link lref lsect lsubsect lsubsubsect nchapter npart nsect
nsubsect nsubsubsect paragraph part quote row sc sect strong subs subsect
subsubsect subsubsubsect sups tableatt tt ttbegin url verb verborg
verbinclude\fP\&.
.IP 
.IP "\f(CWattribclear()\fP"
Removes any existing contents from the attrib\-stack\&. This macro is only
active when converting to html
.IP 
.IP "\f(CWattribinsert()\fP"
In html, if the attrib\-stack is not empty, 
inserts the value on top of the attrib\-stack and then pops the topmost value\&.
If the attrib\-stack is empty, nothing happens\&.
.IP 
.IP "\f(CWbf(text)\fP"
Sets \f(CWtext\fP in boldface\&.
.IP 
.IP "\f(CWbind(text)\fP"
Generate a binding character after text\&.
.IP 
.IP "\f(CWbook(title)(author)(date)\fP"
Starts a book document\&. The top\-level sectioning command is \f(CW(n)chapter\fP,
\f(CW(n)part\fP being optional\&. In HTML output files are created for each
chapter, while the way the headings are displayed can be tuned using
CSS id selector specifications: the title has \f(CWid=\(dq\&title\(dq\&\fP, the author
\f(CWid=\(dq\&author\(dq\&\fP, and the date \f(CWid=\(dq\&date\(dq\&\fP\&.)
.IP 
.IP "\f(CWcell(contents)\fP"
Sets a table cell, i\&.e\&., one element in a row\&. With the man/ms converters
multiple blanks between \f(CWcell()\fP macro calls are merged into a single blank
character\&.
.IP 
.IP "\f(CWcells(nColumns)(contents)\fP"
Set a table cell over \f(CWnColumns\fP columns\&. With LaTeX and xml the
information in the combined cells is centered\&. 
.IP 
With man/ms conversions the \f(CWcells()\fP macro simply calls the \f(CWcell()\fP
macro, but here the \f(CWsetmanalign()\fP macro can be used to determine the
alignment of multiple cells\&.
.IP 
With html the macro \f(CWattrib\fP can be used, but when it contains a \f(CWstyle\fP
specification the macro\(cq\&s default \f(CWstyle=\(dq\&text\-align: center\(dq\&\fP is ignored
(but it can optionally be specified using the \f(CWattrib\fP macro)\&.
.IP 
.IP "\f(CWcellsline(from)(count)\fP"
Sets a horizontal line starting at column number \f(CWfrom\fP over \f(CWcount\fP
columns in a row\&. If \f(CWfrom\fP is less then the number of columns already added
to a row then it is ignored\&. This macro must be embedded in a \f(CWrow\fP macro
defining a table row\&.  To put a line across the table\(cq\&s full width use
\f(CWrowline\fP\&. To set horizontal lines across columns 1
until 2 and columns 4 until 5 table of a table use:
.nf 

    row(cellsline(1)(2)cellsline(4)(2))
        
.fi 
Combining \f(CWcellsline\fP and \f(CWcell\fP or \f(CWcells\fP calls in one row produces
undefined results\&.
.IP 
.IP "\f(CWcenter(text)\fP"
Centers \f(CWtext\fP\&. Use \f(CWnl()\fP in the text to break lines\&.  In html the
\f(CWattrib\fP macro is not supported, but a division (\f(CWdiv\fP) with style
definition \f(CWtext\-align: center\fP is used\&. To center a table in html use
the \f(CWtableatt\fP macro\&. If a \f(CWtable\fP or \f(CWtableatt\fP macro is used inside a
\f(CWcenter\fP macro then the contents of columns are column\-wise centered\&.
.IP 
.IP "\f(CWchapter(title)\fP"
Starts a new chapter in \f(CWbook\fPs or \f(CWreport\fPs\&.
.IP 
.IP "\f(CWcindex()\fP"
Generate an index entry for LaTex() or texinfo 
c\-indices\&. Its argument is the
index entry\&.  See also the \f(CW[fptv]index\fP macro\&.
.IP 
.IP "\f(CWcite(1)\fP"
Sets a citation or quotation
.IP 
.IP "\f(CWclearpage()\fP"
Starts a new page, when the output format permits\&. Under HTML a horizontal
line is drawn\&.
.IP 
.IP "\f(CWcode(text)\fP"
Sets \f(CWtext\fP in code font, and prevents it from being expanded\&.
For unbalanced parameter lists, use \f(CWCHAR(40)\fP to get
\f(CW(\fP and \f(CWCHAR(41)\fP to get \f(CW)\fP\&.
.IP 
.IP "\f(CWcolumnline(from)(to)\fP"
Sets a horizontal line over some columns in a row\&. Note that \f(CWcolumnline\fP
defines a row by itself, consisting of just a horizontal line spanning some of
its columns, rather than the table\(cq\&s full width, like \f(CWrowline\fP\&. The two
arguments represent column numbers\&. It is the responsibility of the author to
make sure that the \f(CWfrom\fP and \f(CWto\fP values are sensible\&. I\&.e\&., 
.nf 

    1 <= from <= to <= ncolumns
        
.fi 
\fBNote\fP: this macro cannot be used if multiple lines must be set in one
row\&. In those cases the macro \f(CWcolsline\fP should be used\&.
.IP 
.IP "\f(CWdashes()\fP"
Inserts two Sets \f(CWtext\fP in teletype font, and prevents it from being expanded\&.
For unbalanced parameter lists, use \f(CWCHAR(40)\fP to get
\f(CW(\fP and \f(CWCHAR(41)\fP to get \f(CW)\fP\&.
.IP 
The \f(CWtt\fP macro interprets character tables as well as \f(CWSUBST\fP
definitions\&. This is usually what is intended\&. In situations where \f(CWtt\fP
performs unwelcome transformations, use the pair of \f(CWttbegin\fP and \f(CWttend\fP
macros\&.
.IP 
In html the \f(CWattrib\fP macro applies to the \f(CW<code>\fP tag\&.
.IP 
.IP "\f(CWdef(macroname)(nrofargs)(redefinition)\fP"
Defines \f(CWmacroname\fP as a macro, having \f(CWnrofargs\fP arguments, and
expanding to \f(CWredefinition\fP\&. This macro is a shorthand for
\f(CWDEFINEMACRO\fP\&. An error occurs when the macro is already defined\&. Use
\f(CWredef()\fP to unconditionally define or redefine a macro\&.
.IP 
.IP "\f(CWdescription(list)\fP"
Sets \f(CWlist\fP as a description list\&. Use \f(CWdit(item)\fP to
indicate items in the list\&.
.IP 
.IP "\f(CWdit(itemname)\fP"
Starts an item named \f(CWitemname\fP in a description list\&. The list should be
used in \f(CWdescription\fP macros\&. With \f(CWhtml\fP conversions the
contents of a description item is separated from the item itself\&. The \f(CWdit\fP
macro only defines the item, and not the description itself\&. This macro sets
the item in bold\-face (`strong\(cq\& font)\&. The macro \f(CWitdesc\fP, available since
Yodl 3\&.05, can be used to defines an item \fIand\fP its description, using its
suggested format (i\&.e\&., indenting the description relative to the item)\&.
.IP 
.IP "\f(CWeit()\fP"
Indicates an item in an enumerated list\&. The \f(CWeit\fP macro should be used as
an argument in \f(CWenumeration\fP macros\&.
.IP 
.IP "\f(CWellipsis()\fP"
Sets ellipsis (\&.\&.\&.)\&.
.IP 
.IP "\f(CWem(text)\fP"
Sets \f(CWtext\fP as emphasized, usually italics\&.
.IP 
.IP "\f(CWemail(address)\fP"
In HTML, this macro sets the \f(CWaddress\fP in a \f(CW<a href=\(dq\&mailto=\&.\&.\(dq\&>\fP
locator\&. In other output formats, the \f(CWaddress\fP is sent to the output\&. The
\f(CWemail\fP macro is a special case of \f(CWurl\fP\&.
.IP 
.IP "\f(CWenumeration(list)\fP"
\f(CWenumeration()\fP starts an enumerated list\&. Use \f(CWeit()\fP in the list to 
indicate items in the list\&.
.IP 
.IP "\f(CWeuro()\fP"
Sets the euro currency symbol in latex, html, (and possibly sgml and xml)\&. In
all other conversions EUR which is the official textual abbreviation
(cf\&. http://ec\&.europa\&.eu/euro/entry\&.html) is written\&. Note that LaTeX
may require latexpackage()(eurosym)\&.
.IP 
.IP "\f(CWfig(label)\fP"
This macro is a shorthand for \f(CWfigure ref(label)\fP and just makes the typing
shorter, as in \f(CWsee fig(schematic) for \&.\&.\fP See \f(CWgetfigurestring()\fP and
\f(CWsetfigurestring()\fP for the \f(CWfigure\fP text\&.
.IP 
.IP "\f(CWfigure(file)(caption)(label)\fP"
Sets the picture in \f(CWfile\fP as a figure in the current document, using the
descriptive text \f(CWcaption\fP\&. The \f(CWlabel\fP is defined as a placeholder for
the figure number and can be used in a corresponding \f(CWref\fP statement\&. Note
that the \f(CWfile\fP must be the filename without extension: By default, Yodl
will supply \f(CW\&.gif\fP when in HTML mode, or \f(CW\&.ps\fP when in LaTeX mode\&. Figures
in other modes may not (yet) haven been implemented\&.
.IP 
When converting to html, this macro uses three attribute\-strings (if
available)\&. The string pushed first using an attrib\-call defines the
attributes for its \f(CW<figcaption>\fP html\-markup; the string pushed next defines
the attributes for its \f(CW<img>\fP html\-markup; the string pushed last defines
the attributes for its \f(CW<figure>\fP html\-markup\&. The \f(CWfigure\fP macro\(cq\&s html
output is organized like this:
.nf 

    <figure \-attrib\-string pushed last (if any)>
        <img \&.\&.\&. \-attrib\-string pushed last but one>
        <figcaption \-attrib\-string pushed 2nd to last>
            \&.\&.\&.
        </figcaption>
    </figure>
    
.fi 
Starting with Yodl 3\&.07\&.00 no \f(CWalt=\(dq\&Figure # is shown here\&.\&.\&.\(dq\&\fP attribute is
defined anymore for the \f(CWimg\fP markup: an \f(CWalt\fP\-attribute can easily be
defined at the last attrib\-call, using \f(CWgetfigurestring()\fP to obtain
\f(CWFigure\fP or its language\-specific translation, and
\f(CWCOUNTERVALUE(XXfigurecounter)\fP to obtain the order\-number of the figure
shown in the next \f(CWfigure\fP\-macro call\&.
.IP 
.IP "\f(CWfile(text)\fP"
Sets \f(CWtext\fP as filename, usually boldface\&.
In html \f(CWattrib\fP macro applies to the \f(CW<strong>\fP tag\&.
.IP 
.IP "\f(CWfindex()\fP"
Generate an index entry for LaTex() or texinfo 
f\-indices\&. Its argument is the
index entry\&.  See also the \f(CW[cptv]index\fP macro\&.
.IP 
.IP "\f(CWfootnote(text)\fP"
Sets \f(CWtext\fP as a footnote, or between parentheses when the output format
does not allow footnotes\&.
.IP 
.IP "\f(CWgagmacrowarning(name name \&.\&.\&.)\fP"
Prevents the \f(CWyodl\fP program from printing \fIcannot expand possible user
macro\fP\&. E\&.g\&., if you have in your document \f(CWthe file(s) are \&.\&.\fP then you
might want to put before that: \f(CWgagmacrowarning(file)\fP\&. Calls 
\f(CWNOUSERMACRO\fP\&.
.IP 
.IP "\f(CWgetaffilstring()\fP"
Expands to the string that defines the name of \fIAffiliation Information\fP, by
default \fIAFFILIATION INFORMATION\fP\&. Can be redefined for national language
support by \f(CWsetaffilstring()\fP\&. Currently, it is relevant only for txt\&.
.IP 
.IP "\f(CWgetauthorstring()\fP"
Expands to the string that defines the name of \fIAuthor Information\fP, by
default \fIAUTHOR INFORMATION\fP\&. Can be redefined for national language
support by \f(CWsetauthorstring()\fP\&. Currently, it is relevant only for txt\&.
.IP 
.IP "\f(CWgetchapterstring()\fP"
Expands to the string that defines a `chapter\(cq\& entry, by default \fIChapter\fP\&.
Can be redefined for national language support by \f(CWsetchapterstring()\fP\&.
.IP 
.IP "\f(CWgetdatestring()\fP"
Expands to the string that defines the name of \fIDate Information\fP, by
default \fIDATE INFORMATION\fP\&. Can be redefined for national language
support by \f(CWsetdatestring()\fP\&. Currently, it is relevant only for txt\&.
.IP 
.IP "\f(CWgetfigurestring()\fP"
Returns the string that defines a `figure\(cq\& text, in captions or in the
\f(CWfig()\fP macro\&. The string can be redefined using the \f(CWsetfiguretext()\fP
macro\&.
.IP 
.IP "\f(CWgetpartstring()\fP"
Expands to the string that defines a `part\(cq\& entry, by default \fIPart\fP\&. Can
be redefined for national language support by \f(CWsetpartstring()\fP\&.
.IP 
.IP "\f(CWgettitlestring()\fP"
Expands to the string that defines the name of \fITitle Information\fP, by
default \fITITLE INFORMATION\fP\&. Can be redefined for national language
support by \f(CWsettitlestring()\fP\&. Currently, it is relevant only for txt\&.
.IP 
.IP "\f(CWgettocstring()\fP"
Expands to the string that defines the name of the table of contents, by
default \fITable of Contents\fP\&. Can be redefined for national language
support by \f(CWsettocstring()\fP\&.
.IP 
.IP "\f(CWhtmlcommand(cmd)\fP"
Writes \f(CWcmd\fP to the output when converting to html\&. The \f(CWcmd\fP is not
further expanded by Yodl\&.
.IP 
.IP "\f(CWhtmlheadfile(file)\fP"
Adds the contents of \f(CWfile\fP to the \f(CWhead\fP section of an HTML
document\&. The contents of file are not interpreted and should contain plain
html text\&. This option can be useful when large bodies of text, like the
contents of \f(CW<script>\fP sections, must be included into the head section of
html documents\&. This macro is only active in the preamble, should only
specified once, and is only interpreted for html conversions\&.
.IP 
.IP "\f(CWhtmlheadopt(option)\fP"
Adds the literal text \f(CWoption\fP to the current information in the \f(CWhead\fP
section of an HTML document\&. \f(CWOption\fP may (or: should) contain plain html
text\&. A commonly occurring head option is \f(CWlink\fP, defining, e\&.g\&., a style
sheet\&. Since that option is frequently used, it has received a dedicated
macro: \f(CWhtmlstylesheet\fP\&. When large bodies of html\-text must be added to
html documents the macro \f(CWhtmlheadfile\fP should be used\&. This macro is only
active in the preamble and is only interpreted for html conversions\&.
.IP 
.IP "\f(CWhtmlnewfile()\fP"
In HTML output, starts a new file\&. All other formats are not affected\&. Note
that you must take your own provisions to access the new file; say via links\&.
Also, it\(cq\&s safe to start a new file just befoore opening a new section, since
sections are accessible from the clickable table of contents\&. The HTML
converter normally only starts new files prior to a \f(CWchapter\fP definition\&.
.IP 
.IP "\f(CWhtmlstyle(tag)(definition)\fP"
Adds \f(CW<style type=\(dq\&text/css\(dq\&> \&.\&.\&. </style>\fP element to the head section of
an HTML document\&.
.br 
Use \f(CWhtmlstyle\fP to specify one or more CSS definitions which are eventually
inserted at the ellipsis (\f(CW\&.\&.\&.\fP) in the generic \f(CWstyle\fP definition shown
above\&. E\&.g\&., (using \f(CW#rrggbb\fP to specify a color, where \f(CWrr\fP are two
hexadecimal digits specifying the color\(cq\&s red component, \f(CWgg\fP two
hexadecimal digits specifying the color\(cq\&s green component, and \f(CWbb\fP two
hexadecimal digits specifying the color\(cq\&s blue component)  specifying
.nf 

    htmlstyle(body)(color: #rrggbb; background\-color: #rrggbb)
    htmlstyle(h1)(color: blue; text\-align: center)
    htmlstyle(h2)(color: green)
    
.fi 
results in the element
.nf 

    <style type=\(dq\&text/css\(dq\&>
        body {color: #rrggbb; background\-color: #rrggbb;}
        h1 {color: blue; text\-align: center;} 
        h2 {color: green;}
    </style>
    
.fi 
The macros \f(CWhtmlheadopt\fP and \f(CWhtmlstylesheet\fP could also be used to put
information into the head\-section of an HTML document, but \f(CWhtmlheadopt\fP is
of a much more general nature, while \f(CWhtmlstylesheet\fP refers to CSS elements
stored in an external file\&. The macro \f(CWattrib\fP can be used to define
\fIinline styles\fP\&.
.IP 
The \f(CWhtmlstyle\fP macro is only active in the preamble and is only
interpreted for html conversions\&.
.br 
Refer to available CSS specifications (cf\&.,
http://www\&.w3schools\&.com/cssref/ for an overview of how CSS
specifications are used, and which CSS specifications are available)\&.
.IP 
By default the internal style specification
.br 
\f(CWfigure {text\-align: center;} img {vertical\-align: center;}\fP
.br 
is used\&. If this is not appropriate, specify \f(CWnohtmlimgstyle()\fP in the
preamble\&. 
.IP 
.IP "\f(CWhtmlstylesheet(url)\fP"
Adds a \f(CW<link rel=\(dq\&stylesheet\(dq\& type=\(dq\&text/css\(dq\& \&.\&.\&.>\fP element to the head
section of an HTML document, using \f(CWurl\fP in its \f(CWhref\fP field\&. The argument
\f(CWurl\fP is not expanded, and should be plain HTML text, without surrounding
quotes\&. The macro \f(CWhtmlheadopt\fP can also be used to put information in the
head\-section of an HTML document, but \f(CWhtmlheadopt\fP is of a much more
general nature\&.  This macro is only active in the preamble and is only
interpreted for html conversions\&.
.IP 
.IP "\f(CWhtmltag(tagname)(start)\fP"
Sets \f(CWtagname\fP as a HTML tag, enclosed by \f(CW<\fP and \f(CW>\fP\&. When \f(CWstart\fP
is zero, the \f(CWtagname\fP is prefixed with \f(CW/\fP\&. As not all html tags are
available through predefined Yodl\-macros (there are too many of them, some are
used very infrequently, and you can easily define macros for the tags for
which Yodl doesn\(cq\&t offer predefined ones), the \f(CWhtmltag\fP macro can be used
to handle your own set of macros\&. In html the \f(CWattrib\fP macro is
supported\&. E\&.g\&.,
.nf 

    attrib(title=\(dq\&World Health Organization\(dq\&)htmltag(abbr)()WHO+htmltag(abbr)(0)
    
.fi 

.IP 
.IP "\f(CWifnewparagraph(truelist)(falselist)\fP"
The macro \f(CWifnewparagraph\fP should be called from the \f(CWPARAGRAPH\fP macro, if
defined\&. It will insert \f(CWtruelist\fP if a new paragraph is inserted,
otherwise \f(CWfalselist\fP is inserted (e\&.g\&., following two consecutive calls of
PARAGRAPH)\&. This macro can be used to prevent the output of multiple blank
lines\&. 
.IP 
.IP "\f(CWincludefile(file)\fP"
Includes \f(CWfile\fP\&. The default
extension \f(CW\&.yo\fP is supplied if necessary\&.
.IP 
\fBNOTE:\fP Starting with Yodl version 3\&.00\&.0 Yodl\(cq\&s default file inclusion
behavior has changed\&. The current working directory no longer remains fixed at
the directory in which Yodl is called, but is volatile, changing to the
directory in which a yodl\-file is located\&. This has the advantage that Yodl\(cq\&s
file inclusion behavior now matches the way \fBC\fP\(cq\&s \f(CW#include\fP directive
operates; it has the disadvantage that it may break some current
documents\&. Conversion, however is simple but can be avoided altogether if
Yodl\(cq\&s \f(CW\-L\fP (\f(CW\-\-legacy\-include\fP) option is used\&.
.IP 
Furthermore, the \f(CWincludefile\fP macro no longer defines a label\&. To define a
label just before the file\(cq\&s inclusion use \f(CWlincludefile\fP\&.
.IP 
.IP "\f(CWincludeverbatim(file)\fP"
Include \f(CWfile\fP into the output\&.  No processing is done, \f(CWfile\fP should
be in preformatted form, e\&.g\&.: 
.nf 
whenhtml(includeverbatim(foo\&.html))
.fi 

.IP 
\fBNOTE:\fP Starting with Yodl version 3\&.00\&.0 Yodl\(cq\&s default file inclusion
behavior has changed\&. The current working directory no longer remains fixed at
the directory in which Yodl is called, but is volatile, changing to the
directory in which a yodl\-file is located\&. This has the advantage that Yodl\(cq\&s
file inclusion behavior now matches the way \fBC\fP\(cq\&s \f(CW#include\fP directive
operates; it has the disadvantage that it may break some current
documents\&. Conversion, however is simple but can be avoided altogether if
Yodl\(cq\&s \f(CW\-L\fP (\f(CW\-\-legacy\-include\fP) option is used\&.
.IP 
.IP "\f(CWit()\fP"
Indicates an item in an itemized list\&. Items in \f(CWit\fP macros are
arguments of \f(CWitemization\fP macros\&.
.IP 
.IP "\f(CWitdesc(itemname)(contents)\fP"
Starts an item and its description in a description list\&. Its name is
\f(CWitemname\fP, the contents of the item is defined by \f(CWcontents\fP\&. The
\f(CWitemname\fP is defined by using the \f(CWdit\fP macro\&. 
.IP 
With \f(CWhtml\fP conversions the contents are surrounded by \f(CW<dd>\fP and
\f(CW</dd>\fP tags, resulting in contents which are indented relative to the
itemname\&. When the \f(CWattrib\fP macro is used it is applied to the itemname
(\f(CWdt\fP\-tags)\&. 
.IP 
With other conversions the \f(CWcontents\fP are quoted (as if using
\f(CWquote(contents)\fP)\&.
.IP 
.IP "\f(CWitemization(list)\fP"
Sets \f(CWlist\fP as an itemizationd list\&. Use \f(CWit()\fP to indicate items in the
list\&.
.IP 
.IP "\f(CWkindex()\fP"
Generate an index entry for LaTex() or texinfo k\-indices\&. Its argument is the
index entry\&.  See also the \f(CW[cfptv]vindex\fP macro\&.
.IP 
.IP "\f(CWlabel(labelname)\fP"
Defines \f(CWlabelname\fP as an anchor for a \f(CWlink\fP
command, or to stand for the last numbering of a section or figure in a
\f(CWref\fP command\&.
.IP 
.IP "\f(CWlangle()\fP"
Character <
.IP 
.IP "\f(CWlanguagedutch()\fP"
Defines the Dutch\-language specific headers\&. Active this macro via
setlanguage(dutch)\&. 
.IP 
.IP "\f(CWlanguageenglish()\fP"
Defines the English\-language specific headers\&. Active this macro via
setlanguage(english)\&. 
.IP 
.IP "\f(CWlanguageportugese()\fP"
Defines the Portugese\-language specific headers\&. Active this macro via
setlanguage(portugese)\&. 
.IP 
.IP "\f(CWLaTeX()\fP"
The LaTeX symbol\&.
.IP 
.IP "\f(CWlatexaddlayout(arg)\fP"
This macro is provided to add Yodl\-interpreted text to  your own LaTeX layout
commands\&. The command is terminated with an end\-of\-line\&.
See also the macro \f(CWlatexlayoutcmds()\fP
.IP 
.IP "\f(CWlatexcommand(cmd)\fP"
Writes \f(CWcmd\fP plus a white space to the output when converting to LaTeX\&. The
\f(CWcmd\fP is not further expanded by Yodl\&.
.IP 
.IP "\f(CWlatexdocumentclass(class)\fP"
Forces the LaTeX
\f(CW\edocumentclass{\&.\&.\&.}\fP setting to \f(CWclass\fP\&. Normally the class is
defined by the macros \f(CWarticle\fP, \f(CWreport\fP or \f(CWbook\fP\&.  This macro
is an escape route in case you need to specify your own document class
for LaTeX\&. This option is a \fImodifier\fP and must
appear \fIbefore\fP the \f(CWarticle\fP, \f(CWreport\fP or \f(CWbook\fP macros\&.
.IP 
.IP "\f(CWlatexlayoutcmds(NOTRANSs)\fP"
This macro is provided in case you want to put your own LaTeX layout commands
into LaTeX output\&. The \f(CWNOTRANSs\fP are pasted right after the
\f(CW\edocumentclass\fP stanza\&. The default is, of course, no local LaTeX
commands\&. Note that this macro \fBdoes not\fP overrule my favorite LaTeX
layout\&. Use \f(CWnosloppyhfuzz()\fP and \f(CWstandardlayout()\fP to disable my favorite
LaTeX layout\&.
.IP 
.IP "\f(CWlatexoptions(options)\fP"
Set latex options: \f(CWdocumentclass[options]\fP\&.  
This command \fBmust\fP appear before the document type is
stated by \f(CWarticle\fP, \f(CWreport\fP, etc\&.\&.
.IP 
.IP "\f(CWlatexpackage(options)(name)\fP"
Include latex package(s), a useful package is, e\&.g\&.,
\f(CWepsf\fP\&. This command \fBmust\fP appear before the document type is
stated by \f(CWarticle\fP, \f(CWreport\fP, etc\&.\&.
.IP 
.IP "\f(CWlchapter(label)(title)\fP"
Starts a new chapter in \f(CWbook\fPs or \f(CWreport\fPs, setting a label at
the beginning of the chapter\&.
.IP 
.IP "\f(CWletter(language)(date)(subject)(opening)(salutation)(author)\fP"
Starts a letter written in the indicated language\&. The date of the letter is
set to `date\(cq\&, the subject of the letter will be `subject\(cq\&\&. The letter starts
with `opening\(cq\&\&. It is based on the `letter\&.cls\(cq\& document class definition\&.
The macro is available for LaTeX only\&. Preamble command suggestions:
.IP o 
\f(CWlatexoptions(11pt)\fP
.IP o 
\f(CWa4enlarged()\fP
.IP o 
\f(CWletterreplyto(name)(address)(postalcode/city)\fP
.IP o 
\f(CWletterfootitem(phone)(number)\fP, maybe e\-mail too\&.
.IP o 
\f(CWletteradmin(yourdate)(yourref)\fP
.IP o 
\f(CWletterto(addressitem)\fP\&. Use a separate \f(CWletterto()\fP macro call
for each new line of the address\&.

.IP 
.IP "\f(CWletteraddenda(type)(value)\fP"
Adds an addendum at the end of a letter\&. `type\(cq\& should be `bijlagen\(cq\&,
`cc\(cq\& or `ps\(cq\&\&.
.IP 
.IP "\f(CWletteradmin(yourdate)(yourref)\fP"
Puts `yourletterfrom\(cq\& and `yourreference\(cq\& elements in the letter\&. If left
empty, two dashes are inserted\&.
.IP 
.IP "\f(CWletterfootitem(name)(value)\fP"
Puts a footer at the bottom of letter\-pages\&. Up to three will usually fit\&.
LaTeX only\&.
.IP 
.IP "\f(CWletterreplyto(name)(address)(zip city)\fP"
Defines the `reply to\(cq\& address in LaTeX or txt\-letters\&.
.IP 
.IP "\f(CWletterto(element)\fP"
Adds `element\(cq\& as an additional line to the address in LaTeX letters\&.
.IP 
.IP "\f(CWlink(description)(labelname)\fP"
In HTML output a clickable link with the text \f(CWdescription\fP is created
that points to the place where \f(CWlabelname\fP is defined using the \f(CWlabel\fP
macro, and \f(CWattrib\fP macro applies to the \f(CW<a>\fP tag\&.  Using
\f(CWlink\fP is similar to \f(CWurl\fP, except that a hyperlink is set pointing to a
location in the same document\&. For output formats other than HTML, only the
\f(CWdescription\fP appears\&.
.IP 
.IP "\f(CWlref(description)(labelname)\fP"
This macro is a combination of the \f(CWref\fP and \f(CWlink\fP macros\&. In HTML
output a clickable link with the text \f(CWdescription\fP and the label value is
created that points to the place where \f(CWlabelname\fP is defined using the
\f(CWlabel\fP macro, and \f(CWattrib\fP macro applies to the \f(CW<a>\fP
tag\&. For output formats other than HTML, only the \f(CWdescription\fP and the
label value appears\&.
.IP 
.IP "\f(CWlsect(label)(title)\fP"
Starts a new section, setting a label at the beginning of the section\&.
In html \f(CWattrib\fP macro applies to the \f(CW<h2>\fP tag\&.
.IP 
.IP "\f(CWlsubsect(label)(title)\fP"
Starts a new subsection\&. Other sectioning commands are
\f(CWsubsubsect\fP and \f(CWsubsubsubsect\fP\&. A label is added just before the
subsection\&.
In html \f(CWattrib\fP macro applies to the \f(CW<h3>\fP tag\&.
.IP 
.IP "\f(CWlsubsubsect(label)(title)\fP"
Starts a sub\-subsection, a label is added just before the section
In html \f(CWattrib\fP macro applies to the \f(CW<h4>\fP tag\&.
.IP 
.IP "\f(CWlsubsubsubsect(label)(title)\fP"
Starts a sub\-sub\-sub section\&. This level of sectioning is not numbered, in
contrast to `higher\(cq\& sectionings\&. A label is added just before the
subsubsubection\&.
.IP 
.IP "\f(CWlurl(locator)\fP"
An url described by its Locator\&.  For small urls with readable addresses\&.
.IP 
.IP "\f(CWmailto(address)\fP"
Defines the default \f(CWmailto\fP address for HTML output\&. Must appear
\fBbefore\fP the document type is stated by \f(CWarticle\fP, \f(CWreport\fP, etc\&.\&.
.IP 
.IP "\f(CWmakeindex()\fP"
Make index for latex\&.
.IP 
.IP "\f(CWmancommand(cmd)\fP"
Writes \f(CWcmd\fP to the output when converting to man\&. The \f(CWcmd\fP is not
further expanded by Yodl\&.
.IP 
.IP "\f(CWmanpage(title)(section)(date)(source)(manual)\fP"
Starts a manual page document\&. The \f(CWsection\fP argument must be a number,
stating to which section the manpage belongs to\&. Most often used are commands
(1), file formats (5) and macro packages (7)\&. The sectioning commands in a
manpage are \fBnot\fP \f(CW(n)sect\fP etc\&., but \f(CWmanpage\&.\&.\&.()\fP\&. The first section
\fBmust\fP be the \f(CWmanpagename\fP, the last section \fBmust\fP be the
\f(CWmanpageauthor\fP\&. The standard manpage for section 1 contains the following
sections (in the given order): \f(CWmanpagename\fP, \f(CWmanpagesynopsis\fP,
\f(CWmanpagedescription\fP, \f(CWmanpageoptions\fP, \f(CWmanpagefiles\fP,
\f(CWmanpageseealso\fP, \f(CWmanpagediagnostics\fP, \f(CWmanpagebugs\fP,
\f(CWmanpageauthor\fP\&. Optional extra sections can be added with
\f(CWmanpagesection\fP\&. Standard manpageframes for several manpagesections
are provided in \f(CW/usr/local/share/yodl/manframes\fP\&. YODL manual pages can be
converted to \f(CWgroff, html\fP, or plain ascii text formats\&.
.IP 
.IP "\f(CWmanpageauthor()\fP"
Starts the AUTHOR entry in a \f(CWmanpage\fP document\&. Must be the last section
of a \f(CWmanpage\fP\&.
.IP 
.IP "\f(CWmanpagebugs()\fP"
Starts the BUGS entry in a \f(CWmanpage\fP document\&.
.IP 
.IP "\f(CWmanpagedescription()\fP"
Starts the DESCRIPTION entry in a \f(CWmanpage\fP document\&.
.IP 
.IP "\f(CWmanpagediagnostics()\fP"
Starts the DIAGNOSTICS entry in a \f(CWmanpage\fP document\&.
.IP 
.IP "\f(CWmanpagefiles()\fP"
Starts the FILES entry in a \f(CWmanpage\fP document\&.
.IP 
.IP "\f(CWmanpagename(name)(short description)\fP"
Starts the NAME entry in a \f(CWmanpage\fP document\&. The short description is
used by, e\&.g\&., the \f(CWwhatis\fP database\&.
.IP 
.IP "\f(CWmanpageoptions()\fP"
Starts the OPTIONS entry in a \f(CWmanpage\fP document\&.
.IP 
.IP "\f(CWmanpagesection(SECTIONNAME)\fP"
Inserts a non\-required section named \f(CWSECTIONNAME\fP in a \f(CWmanpage\fP
document\&. This macro can be used to augment `standard\(cq\& manual pages with extra
sections, e\&.g\&., EXAMPLES\&. \fBNote that\fP the name of the extra section should
appear in upper case, which is consistent with the normal typesetting of
manual pages\&.
.IP 
.IP "\f(CWmanpageseealso()\fP"
Starts the SEE ALSO entry in a \f(CWmanpage\fP document\&.
.IP 
.IP "\f(CWmanpagesynopsis()\fP"
Starts the SYNOPSIS entry in a \f(CWmanpage\fP document\&.
.IP 
.IP "\f(CWmbox()\fP"
Unbreakable box in LaTeX\&. Other formats may have different opitions on
our unbreakable boxex\&.
.IP 
.IP "\f(CWmetaC(text)\fP"
Put a line comment in the output\&.
.IP 
.IP "\f(CWmetaCOMMENT(text)\fP"
Write format\-specific comment to the output\&.
.IP 
.IP "\f(CWmscommand(cmd)\fP"
Writes \f(CWcmd\fP to the output when converting to ms\&. The \f(CWcmd\fP is not
further expanded by Yodl\&.
.IP 
.IP "\f(CWnchapter(title)\fP"
Starts a chapter (in a \f(CWbook\fP or \f(CWreport\fP) without generating a
number before the title and without placing an entry for the chapter in
the table of contents\&. 
In html \f(CWattrib\fP macro applies to the \f(CW<h1>\fP tag\&.
.IP 
.IP "\f(CWnemail(name)(address)\fP"
Named email\&.
A more consistent naming for url, lurl, email and nemail would be
nice\&.
.IP 
.IP "\f(CWnl()\fP"
Forces a newline; i\&.e\&., breaks the current line in two\&.
.IP 
.IP "\f(CWnodeprefix(text)\fP"
Prepend text to node names, e\&.g\&. 
.nf 
nodeprefix(LilyPond) sect(Overview)
.fi 
Currently used in texinfo descriptions only\&.
.IP 
.IP "\f(CWnodeprefix(text)\fP"
Prepend text to node names, e\&.g\&. 
.nf 
nodeprefix(LilyPond) sect(Overview)
.fi 
Currently used in texinfo descriptions only\&.
.IP 
.IP "\f(CWnodetext(text)\fP"
Use text as description for the next node, e\&.g\&. 
.nf 
nodetext(The GNU Music Typesetter)chapter(LilyPond)
.fi 
Currently used in texinfo descriptions only\&.
.IP 
.IP "\f(CWnohtmlfive()\fP"
Starting yodl 3\&.05 html\-conversions by default use html5\&. This can be
suppressed (in favor of using html4) by calling this macro\&. This macro merely
suppresses writing the initial \f(CW<!DOCTYPE html>\fP to generated html
files; it is only active in the preamble and is only interpreted for
html conversions\&.
.IP 
.IP "\f(CWnohtmlimgstyle()\fP"
By default html\-pages specify
.br 
\f(CW(<style type=\(dq\&text/css\(dq\& img {vertical\-align: bottom;}></style>)\fP
.br 
This macro suppresses this \f(CWimg\fP CSS style specification\&. This macro is
only active in the preamble and is only interpreted for html conversions\&.
.IP 
.IP "\f(CWnop(text)\fP"
Expand to text, to avoid spaces before macros e\&.g\&.: a\&. Although
a+sups(2) should have the same effect\&.
.IP 
.IP "\f(CWnosloppyhfuzz()\fP"
By default, LaTeX output contains commands that cause it to shut up about
hboxes that are less than 4pt overfull\&. When \f(CWnosloppyhfuzz()\fP appears
before stating the document type, LaTeX complaints are `vanilla\(cq\&\&.
.IP 
.IP "\f(CWnotableofcontents()\fP"
Prevents the generation of a table of contents\&. This is default in, e\&.g\&.,
\f(CWmanpage\fP and \f(CWplainhtml\fP documents\&. When present, this option \fBmust\fP
appear before stating the document type with \f(CWarticle\fP, \f(CWreport\fP
etc\&.\&.
.IP 
.IP "\f(CWnotitleclearpage()\fP"
Prevents the generation of a \f(CWclearpage()\fP instruction after the typesetting
of title information\&. This instruction is default in all non \f(CWarticle\fP
documents\&. When present, must appear \fBbefore\fP stating the document type with
\f(CWarticle\fP, \f(CWbook\fP or \f(CWreport\fP\&.
.IP 
.IP "\f(CWnotocclearpage()\fP"
With the LaTeX converter, no \f(CWclearpage()\fP instruction is inserted
immediately beyond the document\(cq\&s table of contents\&. The \f(CWclearpage()\fP
instruction is default in all but the \f(CWarticle\fP document type\&. When present,
must appear \fBbefore\fP stating the document type with \f(CWarticle\fP, \f(CWbook\fP or
\f(CWreport\fP\&. With other converters than the LaTeX converter, it is ignored\&.
.IP 
.IP "\f(CWnotransinclude(filename)\fP"
Reads filename and inserts it literally in the text
not subject to macro expansion or character translation\&.
No information is written either before or after the file\(cq\&s contents, not even
a newline\&.
.IP 
\fBNOTE:\fP Starting with Yodl version 3\&.00\&.0 Yodl\(cq\&s default file inclusion
behavior has changed\&. The current working directory no longer remains fixed at
the directory in which Yodl is called, but is volatile, changing to the
directory in which a yodl\-file is located\&. This has the advantage that Yodl\(cq\&s
file inclusion behavior now matches the way \fBC\fP\(cq\&s \f(CW#include\fP directive
operates; it has the disadvantage that it may break some current
documents\&. Conversion, however is simple but can be avoided altogether if
Yodl\(cq\&s \f(CW\-L\fP (\f(CW\-\-legacy\-include\fP) option is used\&.
.IP 
.IP "\f(CWnoxlatin()\fP"
When used in the preamble, the LaTeX converter disables the inclusion of the
file \f(CWxlatin1\&.tex\fP\&. Normally this file gets included in the LateX output
files to ensure the conversion of high ASCII characters (like e) to
LaTeX\-understandable codes\&. (The file \f(CWxlatin1\&.tex\fP comes with the YODL
distribution\&.)
.IP 
.IP "\f(CWnparagraph(title)\fP"
Starts a non\-numbered paragraph (duh, corresponds to subparagraph in latex)\&.
.IP 
.IP "\f(CWnpart(title)\fP"
Starts a part in a \f(CWbook\fP document, but without numbering it and without
entering the title of the part in the table of contents\&.
In html \f(CWattrib\fP macro applies to the \f(CW<h1>\fP tag\&.
.IP 
.IP "\f(CWnsect(title)\fP"
Starts a section, but does not generate a number before the \f(CWtitle\fP nor
an entry in the table of contents\&. Further sectioning commands are
\f(CWnsubsect\fP, \f(CWnsubsubsect\fP and \f(CWnsubsubsubsect\fP\&.
In html \f(CWattrib\fP macro applies to the \f(CW<h2>\fP tag\&.
.IP 
.IP "\f(CWnsubsect(title)\fP"
Starts a non\-numbered subsection\&.  In html the \f(CWattrib\fP macro applies to
the \f(CW<h3>\fP tag\&.
.IP 
.IP "\f(CWnsubsubsect(title)\fP"
Starts a non\-numbered sub\-sub section\&. 
In html \f(CWattrib\fP macro applies to the \f(CW<p>\fP tag\&.
.IP 
.IP "\f(CWnsubsubsect(title)\fP"
Starts a non\-numbered sub\-subsection\&.
.IP 
.IP "\f(CWparagraph(title)\fP"
Starts a paragraph\&. This level of sectioning is not numbered, in
contrast to `higher\(cq\& sectionings (duh, corresponds to subparagraph in latex)\&.
In html \f(CWattrib\fP macro applies to the \f(CW<p>\fP tag\&.
.IP 
.IP "\f(CWpart(title)\fP"
Starts a new part in a \f(CWbook\fP document\&.
In html \f(CWattrib\fP macro applies to the \f(CW<h1>\fP tag\&.
.IP 
.IP "\f(CWpindex()\fP"
Generate an index entry for LaTex() or texinfo 
p\-indices\&. Its argument is the
index entry\&.  See also the \f(CW[cftv]index\fP macro\&.
.IP 
.IP "\f(CWplainhtml(title)\fP"
Starts a document for only a plain HTML conversion\&. Not available in
other output formats\&. Similar to \f(CWarticle\fP, except that an author\- and
date field are not needed\&.
.IP 
.IP "\f(CWprintindex()\fP"
Make index for texinfo (?)\&.
.IP 
.IP "\f(CWquote(text)\fP"
Sets the text as a quotation\&. Usually, the text is indented, depending on the
output format\&.
In html \f(CWattrib\fP macro applies to the \f(CW<blockquote>\fP tag\&.
.IP 
.IP "\f(CWrangle()\fP"
Inserts the right angle character (>)\&.
.IP 
.IP "\f(CWredef(macro)(nrofargs)(redefinition)\fP"
Defines macro \f(CWmacro\fP to expand to \f(CWredefinition\fP\&.
Similar to \f(CWdef\fP, but any pre\-existing definition is overruled\&. Use
\f(CWARG\fP\fIx\fP in the redefinition part to indicate where the arguments should
be pasted\&. E\&.g\&., \f(CWARG1\fP places the first argument, \f(CWARG2\fP the second
argument, etc\&.\&.\&.
.IP 
.IP "\f(CWredefinemacro(macro)(nrofargs)(redefinition)\fP"
Defines macro \f(CWmacro\fP to expand to \f(CWredefinition\fP\&.
Similar to \f(CWdef\fP, but any pre\-existing definition is overruled\&. Use
\f(CWARG\fP\fIx\fP in the redefinition part to indicate where the arguments should
be pasted\&. E\&.g\&., \f(CWARG1\fP places the first argument, \f(CWARG2\fP the second
argument, etc\&.\&.\&. This commands is actually calling redef()\&. 
.IP 
.IP "\f(CWref(labelname)\fP"
Sets the reference for \f(CWlabelname\fP\&. Use \f(CWlabel\fP to define a label\&.
.IP 
.IP "\f(CWreport(title)(author)(date)\fP"
Starts a report type document\&. The top\-level sectioning command in a report
is \f(CWchapter\fP\&. In html the way the headings are displayed can be tuned using
CSS id selector specifications: the title has \f(CWid=\(dq\&title\(dq\&\fP, the author
\f(CWid=\(dq\&author\(dq\&\fP, and the date \f(CWid=\(dq\&date\(dq\&\fP\&. 
.IP 
.IP "\f(CWroffcmd(dotcmd)(sameline)(secondline)(thirdline)\fP"
Sets a t/nroff command that starts with a dot, on its own line\&. The arguments
are: \f(CWdotcmd\fP \- the command itself, e\&.g\&., \f(CW\&.IP\fP; \f(CWsameline\fP \- when not
empty, set following the \f(CWdotcmd\fP on the same line; \f(CWsecondline\fP \- when
not empty, set on the next line; \f(CWthirdline\fP \- when not empty, set on the
third line\&. Note that \f(CWdotcmd\fP and \f(CWthirdline\fP are not further expanded by
YODL, the other arguments are\&.
.IP 
.IP "\f(CWrow(contents)\fP"
The argument \f(CWcontents\fP may contain a man\-page alignment specification
(only one specification can be entered per row), using \f(CWsetmanalign()\fP\&. If
omitted, the standard alignment is used\&. Furthermore it contains the contents
of the elements of the row, using \f(CWcell()\fP or \f(CWcells()\fP macros\&. If
\f(CWcells()\fP is used, \f(CWsetmanalign()\fP should have been used too\&. In this
macro call only the \f(CWcell()\fP, \f(CWcells()\fP and \f(CWsetmanalign()\fP macros
should be called\&. Any other macro call may produce unexpected results\&.
.IP 
The \f(CWrow\fP macro defines a counter \f(CWXXcellnr\fP that can be inspected and is
incremented by predefined macros adding columns to a row\&. The counter is
initially 0\&. Predefined macros adding columns to a row add the number of
columns they add to the row inserting the contents of those columns\&.  These
macros rely on the correct value of this counter and any user\-defined macros
adding columns to table rows should correctly update \f(CWXXcellnr\fP\&.
In html \f(CWattrib\fP macro applies to the \f(CW<tr>\fP tag\&.
.IP 
.IP "\f(CWrowline()\fP"
Sets a horizontal line over the full width of the table\&. See also
\f(CWcolumnline()\fP\&. Use \f(CWrowline()\fP instead of a \f(CWrow()\fP macro call to
obtain a horizontal line\-separator\&.
.IP 
.IP "\f(CWsc(text)\fP"
Set \f(CWtext\fP in the tt (code) font, using small caps\&.
In html the \f(CWattrib\fP macro is not supported, while the code
section is embedded in a \f(CW<div style=\(dq\&font\-size: 90%\(dq\&>\fP section\&.
.IP 
.IP "\f(CWsect(title)\fP"
Starts a new section\&.
In html \f(CWattrib\fP macro applies to the \f(CW<h2>\fP tag\&.
.IP 
.IP "\f(CWsetaffilstring(name)\fP"
Defines \f(CWname\fP as the `affiliation information\(cq\& string, by default
\fIAFFILIATION INFORMATION\fP\&. E\&.g\&., after \f(CWsetaffilstring(AFILIACION)\fP,
YODL outputs this Spanish string to describe the affiliation information\&.
Currently, it is relevant only for txt\&.
.IP 
.IP "\f(CWsetauthorstring(name)\fP"
Defines \f(CWname\fP as the `Author information\(cq\& string, by default
\fIAUTHOR INFORMATION\fP\&. E\&.g\&., after \f(CWsetauthorstring(AUTOR)\fP,
YODL outputs this portuguese string to describe the author information\&.
Currently, it is relevant only for txt\&.
.IP 
.IP "\f(CWsetchapterstring(name)\fP"
Defines \f(CWname\fP as the `chapter\(cq\& string, by default \fIChapter\fP\&. E\&.g\&., after
\f(CWsetchapterstring(Hoofdstuk)\fP, YODL gains some measure of national language
support for Dutch\&. Note that LaTeX support has its own NLS, this macro doesn\(cq\&t
affect the way LaTeX output looks\&.
.IP 
.IP "\f(CWsetdatestring(name)\fP"
Defines \f(CWname\fP as the `date information\(cq\& string, by default
\fIDATE INFORMATION\fP\&. E\&.g\&., after \f(CWsetdatestring(DATA)\fP,
YODL outputs this portuguese string to describe the date information\&.
Currently, it is relevant only for txt\&.
.IP 
.IP "\f(CWsetfigureext(name)\fP"
Defines the \f(CWname\fP as the `figure\(cq\& extension\&. The extension should include
the period, if used\&. E\&.g\&., use setfigureext(\&.ps) if the extensions
of the figure\-images should end in \f(CW\&.ps\fP
.IP 
.IP "\f(CWsetfigurestring(name)\fP"
Defines the \f(CWname\fP as the `figure\(cq\& text, used e\&.g\&. in figure captions\&. E\&.g\&.,
after \f(CWsetfigurestring(Figuur)\fP, Yodl uses Dutch names for figures\&.
.IP 
.IP "\f(CWsethtmlfigureext(ext)\fP"
Defines the filename extension for HTML figures, defaults to \f(CW\&.jpg\fP\&. Note
that a leading dot must be included in \f(CWext\fP\&. The new extension takes effect
starting with the following usage of the \f(CWfigure\fP macro\&.  It is only active
in html, but otherwise acts identically as setfigureext()\&. 
.IP 
.IP "\f(CWhtmlmetacharset(meta\-charset)\fP"
Adds \f(CW<meta charset=\(dq\&meta\-charset\(dq\&>\fP to the head of html documents\&. By
default \f(CW<meta charset=\(dq\&UTF\-8\(dq\&>\fP is used\&. This macro is only active in the
preamble and is only interpreted for html conversions\&.
.IP 
.IP "\f(CWsetincludepath(name)\fP"
Sets a new value of the include\-path specification used when opening \&.yo
files\&. A warning is issued when the path specification does not include a \&.:
element\&. Note that the local directory may still be an element of the new
include path, as the local directory may be the only or the last element of
the specification\&. For these eventualities the new path specification is not
checked\&.  
.IP 
.IP "\f(CWsetlanguage(name)\fP"
Installs the headers specific to a language\&. The argument must be the name of
a language, whose headers have been set by a corresponding
languageXXX() call\&. For example: languagedutch()\&. The
language macros should set the names of the headers of the following elements:
table of contents, affiliation, author, chapter, date, figure, part and title
.IP 
.IP "\f(CWsetlatexalign(alignment)\fP"
This macro defines the table alignment used when setting tables in LaTeX\&.
Use as many \f(CWl\fP (for left\-alignment), \f(CWr\fP
(for right alignment), and \f(CWc\fP (for centered\-alignment) characters as there
are columns in the table\&. See also \f(CWtable()\fP  
.IP 
.IP "\f(CWsetlatexfigureext(ext)\fP"
Defines the filename extension for encapsulated PostScript figures in LaTeX,
defaults to \f(CW\&.ps\fP\&. The dot must be included in t new extension \f(CWext\fP\&. The
new extension takes effect starting with a following usage of the \f(CWfigure\fP
macro\&. It is only active in LaTeX, but otherwise acts identically as
setfigureext()\&.
.IP 
.IP "\f(CWsetlatexverbchar(char)\fP"
Set the char used to quote LaTeX 
\f(CW\everb\fP
sequences
.IP 
.IP "\f(CWsetmanalign(alignment)\fP"
This macro defines the table alignment used when setting tables used in
man\-pages (see \fBtbl\fP(1))\&.  Use as many \f(CWl\fP (for left\-alignment), \f(CWr\fP
(for right alignment), and \f(CWc\fP (for centered\-alignment) characters as there
are columns in the table\&. Furthermore, \f(CWs\fP can be used to indicate that the
column to its left is combined (spans into) the current column\&. Use this
specification when cells spanning multiple columns are defined\&. Each row in a
table which must be convertible to a manpage may contain a separate
\f(CWsetmanalign()\fP call\&.  Note that neither \f(CWrowline\fP nor \f(CWcolumnline\fP
requires \f(CWsetmanalign()\fP specifications, as these macros define rows by
themselves\&. It is the responsibility of the author to ensure that the number
of alignment characters is equal to the number of columns of the table\&.
.IP 
.IP "\f(CWsetpartstring(name)\fP"
Defines \f(CWname\fP as the `part\(cq\& string, by default \fIPart\fP\&. E\&.g\&., after
\f(CWsetpartstring(Teil)\fP, Yodl identifies parts in the German way\&. Note that
LaTeX output does its own national language support; this macro doesn\(cq\&t affect
the way LaTeX output looks\&.
.IP 
.IP "\f(CWsetrofftab(x)\fP"
Sets the character separating items in a line of input data of a \f(CWroff\fP
(manpage) table\&. By default it is set to \f(CW~\fP\&. This separator is used
internally, and needs only be changed (into some unique character) if the
table elements themselves contain \f(CW~\fP characters\&.
.IP 
.IP "\f(CWsetrofftableoptions(optionlist)\fP"
Set the options for tbl table, default: none\&. Multiple options should be
separated by blanks, by default no option is used\&. From the \fBtbl\fP(1) manpage,
the following options are selected for consideration:
.IP o 
\f(CWcenter\fP Centers the table (default is left\-justified)
.IP o 
\f(CWexpand\fP Makes the table as wide as the current line length
.IP o 
\f(CWbox\fP Encloses the table in a box
.IP o 
\f(CWallbox\fP Encloses each item of the table in a box
Note that starting with Yodl V 2\&.00 no default option is used anymore\&.
See also \f(CWsetrofftab()\fP which is used to set the character separating
items in a line of input data\&. 
.IP 
.IP "\f(CWsettitlestring(name)\fP"
Defines \f(CWname\fP as the `title information\(cq\& string, by default
\fITITLE INFORMATION\fP\&. E\&.g\&., after \f(CWsettitlestring(TITEL)\fP,
YODL outputs this Dutch string to describe the title information\&.
Currently, it is relevant only for txt\&.
.IP 
.IP "\f(CWsettocstring(name)\fP"
Defines \f(CWname\fP as the `table of contents\(cq\& string, by default \fITable of
Contents\fP\&. E\&.g\&., after \f(CWsettocstring(Inhalt)\fP, YODL identifies the table
of contents in the German way\&. Note that LaTeX output does its own national
language support; this macro doesn\(cq\&t affect the way LaTeX output looks\&.
.IP 
.IP "\f(CWsgmlcommand(cmd)\fP"
Writes \f(CWcmd\fP to the output when converting to sgml\&. The \f(CWcmd\fP is not
further expanded by Yodl\&.
.IP 
.IP "\f(CWsgmltag(tag)(onoff)\fP"
Similar to \f(CWhtmltag\fP, but used in the SGML converter\&.
.IP 
.IP "\f(CWsloppyhfuzz(points)\fP"
By default, LaTeX output contains commands that cause it to shut up about
hboxes that are less than 4pt overfull\&. When \f(CWsloppyhfuzz()\fP appears
before stating the document type, LaTeX complaints occur only if hboxes are
overfull by more than \f(CWpoints\fP\&.
.IP 
.IP "\f(CWstandardlayout()\fP"
Enables the default LaTeX layout\&. When this macro is absent, then the
first lines of paragraphs are not indented and the space between
paragraphs is somewhat larger\&. The \f(CWstandardlayout()\fP directive must appear
\fBbefore\fP stating the document type as \f(CWarticle\fP, \f(CWreport\fP, etc\&.\&.
.IP 
.IP "\f(CWstrong(contents)\fP"
In html and xml the \f(CWcontents\fP are set between \f(CW<strong>\fP and
\f(CW</strong>\fP tags\&. 
In html \f(CWattrib\fP macro applies to the \f(CW<strong>\fP tag\&.
.IP 
.IP "\f(CWsubs(text)\fP"
Sets text in subscript in supporting formats\&.
In html \f(CWattrib\fP macro applies to the \f(CW<sub>\fP tag\&.
.IP 
.IP "\f(CWsubsect(title)\fP"
Starts a new subsection\&. Other sectioning commands are
\f(CWsubsubsect\fP and \f(CWsubsubsubsect\fP\&.
In html \f(CWattrib\fP macro applies to the \f(CW<h3>\fP tag\&.
.IP 
.IP "\f(CWsubsubsect(title)\fP"
Starts a sub\-subsection\&.
In html \f(CWattrib\fP macro applies to the \f(CW<h4>\fP tag\&.
.IP 
.IP "\f(CWsubsubsubsect(title)\fP"
Starts a sub\-sub\-sub\-subsection\&. This level of sectioning is not numbered, in
contrast to `higher\(cq\& sectionings\&.
.IP 
.IP "\f(CWsups(text)\fP"
Sets text in superscript in supporting formats
In html \f(CWattrib\fP macro applies to the \f(CW<sup>\fP tag\&.
.IP 
.IP "\f(CWtable(nColumns)(alignment)(Contents)\fP"
The \f(CWtable()\fP\-macro defines a table\&. Its first argument specifies the
number of columns in the table\&.  Its second argument specifies the (standard)
alignment of the information within the cells as used by LaTeX or
man/ms\&. Use \f(CWl\fP for left\-alignment, \f(CWc\fP for centered\-alignment and \f(CWr\fP
for right alignment\&. Its third argument defines the contents of
the table which are the rows, each containing column\-specifications and
optionally man/ms alignment definitions for this row\&.
.IP 
See also the \f(CWtableatt\fP macro and the specialized \f(CWsetmanalign()\fP macro\&.
.IP 
.IP "\f(CWtableatt(nColumns)(alignment)(Contents)\fP"
The \f(CWtableatt()\fP\-macro defines a table\&. The last \f(CWattrib\fP call that was
specified before using the \f(CWtableatt()\fP\-macro is used to specify html
attributes for the table\&. E\&.g\&., to center a table in html use
.nf 

    attrib(style=\(dq\&margin\-left:auto;margin\-right:auto;\(dq\&)
    tableatt(\&.\&.\&.)
        
.fi 
The macro\(cq\&s first argument specifies the
number of columns in the table\&.  Its second argument specifies the (standard)
alignment of the information within the cells as used by LaTeX or
man/ms\&. Use \f(CWl\fP for left\-alignment, \f(CWc\fP for centered\-alignment and \f(CWr\fP
for right alignment\&. Its third argument defines the contents of
the table which are the rows, each containing column\-specifications and
optionally man/ms alignment definitions for this row\&.
.IP 
See also the \f(CWtable\fP macro and the specialized \f(CWsetmanalign()\fP macro\&.
.IP 
.IP "\f(CWtcell(text)\fP"
Roff helper to set a table textcell, i\&.e\&., a paragraph\&.  For LaTeX
special table formatting p{} should be used\&.
.IP 
.IP "\f(CWtelycommand(cmd)\fP"
Writes \f(CWcmd\fP to the output when converting to tely\&. The \f(CWcmd\fP is not
further expanded by Yodl\&.
.IP 
.IP "\f(CWTeX()\fP"
The TeX symbol\&.
.IP 
.IP "\f(CWtexinfocommand(cmd)\fP"
Writes \f(CWcmd\fP to the output when converting to texinfo\&. The \f(CWcmd\fP is not
further expanded by Yodl\&.
.IP 
.IP "\f(CWtindex()\fP"
Generate an index entry for LaTex() or texinfo 
t\-indices\&. Its argument is the
index entry\&.  See also the \f(CW[cfpv]index\fP macro\&.
.IP 
.IP "\f(CWtitleclearpage()\fP"
Forces the generation of a \f(CWclearpage()\fP directive following the title of a
document\&. This is already the default in \f(CWbook\fPs and \f(CWreport\fPs, but can be
overruled with \f(CWnotitleclearpage()\fP\&. When present, must appear in the
\fIpreamble\fP; i\&.e\&., before the document type is stated with \f(CWarticle\fP,
\f(CWbook\fP or \f(CWreport\fP\&.
.IP 
.IP "\f(CWtocclearpage()\fP"
With the LaTeX converter, a \f(CWclearpage()\fP directive if inserted,
immediately following the document\(cq\&s table of contents\&. This is already the
default in all but the \f(CWarticle\fP document type, but it can be overruled by
\f(CWnotocclearpage()\fP\&. When present, it must appear in the \fIpreamble\fP; i\&.e\&.,
before the document type is stated with \f(CWarticle\fP, \f(CWbook\fP or
\f(CWreport\fP\&. With other converters than the LaTeX converter, it is ignored\&.
.IP 
.IP "\f(CWtt(text)\fP"
Sets \f(CWtext\fP in teletype font, and prevents it from being expanded\&.
For unbalanced parameter lists, use \f(CWCHAR(40)\fP to get
\f(CW(\fP and \f(CWCHAR(41)\fP to get \f(CW)\fP\&.
.IP 
The \f(CWtt\fP macro does interpret character tables as well as any \f(CWSUBST\fP
definitions\&. This is usually what is intended\&. In situations where this is
unwelcome the \f(CWttbegin\fP and \f(CWttend\fP pair of macros can be used, between
which the builtin commands \f(CWPUSHSUBST, POPSUBST, NOEXPAND\fP and/or
\f(CWNOTRANS\fP can be used\&. E\&.g\&., to clearly show two hyphens in LaTeX 
teletype font use 
.nf 

    ttbegin()\-\-ttend()
    
.fi 
rather than
.nf 

    tt(\-\-)
    
.fi 
Likewise, use \f(CWttbegin\fP and \f(CWttend\fP if the teletype text contains
accented letters like e\&. To set this in teletype font use 
\f(CWttbegin()\e\(dq\&\fP\f(CWe+ttend()\fP\&.
.IP 
In html the \f(CWattrib\fP macro applies to the \f(CW<code>\fP tag\&.
.IP 
.IP "\f(CWttbegin()\fP"
Initiates text set in teletype font\&. Following the text to set in
teletype font a \f(CWttend()\fP macro should be called\&.
.IP 
Usually the \f(CWtt\fP macro can be used instead of the \f(CWttbegin\fP \-\-
\f(CWttend\fP combination\&. However, \f(CWtt\fP interprets character tables as well as
\f(CWSUBST\fP definitions\&. In situations where this is unwelcome the \f(CWttbegin\fP
and \f(CWttend\fP pair of macros can be used, between which builtin commands like
\f(CWPUSHSUBST, POPSUBST, NOEXPAND\fP and/or \f(CWNOTRANS\fP can be used\&.
.IP 
In html the \f(CWattrib\fP macro applies to the \f(CW<code>\fP tag\&.
.IP 
.IP "\f(CWttend()\fP"
Ends text set in teletype font following \f(CWttbegin\fP\&. Refer to the
\f(CWttbegin\fP macro\(cq\&s description for details\&.
.IP 
.IP "\f(CWtxtcommand(cmd)\fP"
Writes \f(CWcmd\fP to the output when converting to txt\&. The \f(CWcmd\fP is not
further expanded by Yodl\&.
.IP 
.IP "\f(CWurl(description)(locator)\fP"
In LaTeX documents the \f(CWdescription\fP is sent to the output\&. For HTML,
a link is created with the descriptive text \f(CWdescription\fP and pointing
to \f(CWlocator\fP\&. The \f(CWlocator\fP should be the full URL, including
service; e\&.g, \f(CWhttp://www\&.icce\&.rug\&.nl\fP, but excluding the double
quotes that are necessary in plain HTML\&. Use the macro \f(CWlink\fP to create
links within the same document\&. For other formats, something like
\fIdescription [locator]\fP will appear\&.
In html \f(CWattrib\fP macro applies to the \f(CW<a>\fP tag\&.
.IP 
.IP "\f(CWverb(text)\fP"
Sets \f(CWtext\fP in verbatim mode: not subject to macro expansion or character
table expansion, and starting with Yodl version 4\&.00\&.00: not using \f(CWSUBST\fP
definitions\&. See also \f(CWveborg\fP, which does not provide the protection
against \f(CWSUBST\fP definitions\&.
.IP 
While converting Yodl\-documents to target document types Yodl frequently uses
the (not further documented) builtin function \f(CWXXSUBST\fP\&. In the
unlikely event that the text \f(CWXXSUBST(\&.\&.\&.)\fP must be written
in a document, the sequence
.nf 

    XXSUBST+CHAR(40)\&.\&.\&.CHAR(41)
    
.fi 
can be used\&.
.IP 
The text that is passed as argument to the \f(CWverb\fP\-macro appears literally
on the output, usually in a teletype font (that depends on the output
format)\&. This macro is for larger chunks, e\&.g\&., listings\&. 
.IP 
When unbalanced parameter lists are required, use \f(CWCHAR(40)\fP to get
\f(CW(\fP and \f(CWCHAR(41)\fP to get \f(CW)\fP\&.
.IP 
.IP "\f(CWverbinclude(filename)\fP"
Reads filename and inserts it literally in the text, set in verbatim mode\&.
not subject to macro expansion\&. The text appears literally on the output,
usually in a teletype font (that depends on the output format)\&. This macro is
an alternative to \f(CWverb(\&.\&.\&.)\fP, when the text to set in verbatim mode is
better kept in a separate file\&.
.IP 
\fBNOTE:\fP Starting with Yodl version 3\&.00\&.0 Yodl\(cq\&s default file inclusion
behavior has changed\&. The current working directory no longer remains fixed at
the directory in which Yodl is called, but is volatile, changing to the
directory in which a yodl\-file is located\&. This has the advantage that Yodl\(cq\&s
file inclusion behavior now matches the way \fBC\fP\(cq\&s \f(CW#include\fP directive
operates; it has the disadvantage that it may break some current
documents\&. Conversion, however is simple but can be avoided altogether if
Yodl\(cq\&s \f(CW\-L\fP (\f(CW\-\-legacy\-include\fP) option is used\&.
In html \f(CWattrib\fP macro applies to the \f(CW<pre>\fP tag\&.
.IP 
.IP "\f(CWverbinsert(args)\fP"
Passes \f(CWargs\fP to \fByodlverbinsert\fP(1), inserting its output into the
converted file\&. This macro can be used to insert, e\&.g\&., a line\-numbered
indented file, or a labeled subsection of a file, into the file that\(cq\&s
currently being written by \f(CWyodl\fP\&. E\&.g,
.nf 

    verbinsert(\-ans4 file)          \-\- inserts file, showing line
                                       numbers, using a 4 blank\-space
                                       character wide indentation\&.

    verbinsert(\-ns4 //SECT file)    \-\- inserts the section of file, 
                                       labeled //SECT file, showing line
                                       numbers, using a 4 blank\-space 
                                       character wide indentation\&.
    
.fi 

.IP 
.IP "\f(CWverborg(text)\fP"
Sets \f(CWtext\fP in verbatim mode: not subject to macro expansion or character
table expansion, and starting with Yodl version 4\&.00\&.00: this macro replaces
the previosly defined \f(CWverb\fP macro\&. The current \f(CWverb\fP macro surrounds
this macro by \f(CWPUSHSUBST\fP and \f(CWPOPSUBST\fP\&.
.IP 
The text that is passed as argument to the \f(CWverborg\fP\-macro appears
literally on the output, albeit that \f(CWSUBST\fP definitions are processed,
usually in a teletype font (that depends on the
output format)\&. This macro is for larger chunks, e\&.g\&., listings\&.
.IP 
When unbalanced parameter lists are required, use \f(CWCHAR(40)\fP to get
\f(CW(\fP and \f(CWCHAR(41)\fP to get \f(CW)\fP\&.
.IP 
.IP "\f(CWverbpipe(command)(text)\fP"
Pipe text through command, but don\(cq\&t expand the output\&.
.IP 
.IP "\f(CWvindex()\fP"
Generate an index entry for LaTex() or texinfo v\-indices\&. 
Its argument is the index entry\&. 
See also the \f(CW[cfkpt]index\fP macro\&.
.IP 
.IP "\f(CWwhenhtml(text)\fP"
Sends \f(CWtext\fP to the output when in HTML conversion mode\&. The text is
further expanded if necessary\&.
.IP 
.IP "\f(CWwhenlatex(text)\fP"
Sends \f(CWtext\fP to the output when in LATEX conversion mode\&. The text is
further expanded if necessary\&.
.IP 
.IP "\f(CWwhenman(text)\fP"
Sends \f(CWtext\fP to the output when in MAN conversion mode\&. The text is
further expanded if necessary\&.
.IP 
.IP "\f(CWwhenms(text)\fP"
Sends \f(CWtext\fP to the output when in MS conversion mode\&. The text is
further expanded if necessary\&.
.IP 
.IP "\f(CWwhensgml(text)\fP"
Sends \f(CWtext\fP to the output when in SGML conversion mode\&. The text is
further expanded if necessary\&.
.IP 
.IP "\f(CWwhentely(text)\fP"
Sends \f(CWtext\fP to the output when in TELY conversion mode\&. The text is
further expanded if necessary\&.
.IP 
.IP "\f(CWwhentexinfo(text)\fP"
Sends \f(CWtext\fP to the output when in TEXINFO conversion mode\&. The text is
further expanded if necessary\&.
.IP 
.IP "\f(CWwhentxt(text)\fP"
Sends \f(CWtext\fP to the output when in TXT conversion mode\&. The text is
further expanded if necessary\&.
.IP 
.IP "\f(CWwhenxml(text)\fP"
Sends \f(CWtext\fP to the output when in XML conversion mode\&. The text is
further expanded if necessary\&.
.IP 
.IP "\f(CWxit(itemname)\fP"
Starts an xml menu item where the file to
which the menu refers to is the argument of the xit() macro\&. It
should be used as argument to xmlmenu(), which has a 3rd argument:
the default path prefixed to the xit() elements\&. 
.IP 
This macro is only available
within the xml\-conversion mode\&. The argument must be a full filename,
including \&.xml extension, if applicable\&.
.IP 
No \&.xml extension indicates a subdirectory, containing another sub\-menu\&.
.IP 
.IP "\f(CWxmlcommand(cmd)\fP"
Writes \f(CWcmd\fP to the output when converting to xml\&. The \f(CWcmd\fP is not
further expanded by Yodl\&.
.IP 
.IP "\f(CWxmlmenu(order)(title)(menulist)\fP"
Starts an xmlmenu\&. Use itemization() to define the items\&. Only
available in xml conversion\&. The menutitle appears in the menu as the heading
of the menu\&.  The menulist is a series of xit() elements, containing
the name of the file to which the menu refers as their argument (including a
final /)\&.  Prefixed to evert every xit()\-element is the value of
XXdocumentbase\&.
.IP 
Order is the the `order\(cq\& of the menu\&. If omitted, no order is defined\&.
.IP 
.IP "\f(CWxmlnewfile()\fP"
In XML output, starts a new file\&. All other formats are not affected\&. Note
that you must take your own provisions to access the new file; say via links\&.
Also, it\(cq\&s safe to start a new file just befoore opening a new section, since
sections are accessible from the clickable table of contents\&. The XML
converter normally only starts new files prior to a \f(CWchapter\fP definition\&.
.IP 
.IP "\f(CWxmlsetdocumentbase(name)\fP"
Defines \f(CWname\fP as the XML document base\&. No default\&.
Only interpreted with xml conversions\&. It is used with the figure and xmlmenu
macros\&.
.IP 
.IP "\f(CWxmltag(tag)(onoff)\fP"
Similar to \f(CWhtmltag\fP, but used in the XML converter\&.
.IP 
.SH "OPTIONS"
No options are relevant in respect to the macros\&.
.PP 
.SH "FILES"
The files in \fBtmp/wip/macros\fP define the converter\(cq\&s macro packages\&. The
scripts \fByodl2tex\fP, \fByodl2html\fP, \fByodl2man\fP etc\&. perform the
conversions\&.
.PP 
.SH "SEE ALSO"

.PP 
\fByodlstriproff\fP(1), 
\fByodl\fP(1), 
\fByodlbuiltins\fP(7), 
\fByodlconverters\fP(1), 
\fByodlletter\fP(7), 
\fByodlmanpage\fP(7),
\fByodlpost\fP(1), 
\fByodlverbinsert\fP(1)\&.
.PP 
.SH "BUGS"

.PP 
\-
.PP 
.SH "AUTHOR"

.PP 
Frank B\&. Brokken (f\&.b\&.brokken@rug\&.nl),