Provided by: yodl_3.00.0-6ubuntu1_i386 bug

NAME

       yodlmacros - Macros for the Yodl converters

SYNOPSIS

       This manual page lists the standard macros of the Yodl package.

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.

       NOTE:  Starting  with Yodl version 3.00.0 Yodl'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's file inclusion behavior now matches the way C's
       #include directive operates; it has the disadvantage that it may  break
       some  current  documents.  Conversion,  however  is  simple  but can be
       avoided altogether if Yodl's -L (--legacy-include) option is used. This
       affects   the   (l)includefile,   includeverbatim,  notransinclude  and
       verbinclude macros (see below).

       The following list shows all macros  of  the  package  in  alphabetical
       order.

       abstract(text)
              Defines an abstract for an article or report document. Abstracts
              are not implemented for books or manpages.  Must  appear  before
              starting the document with the article or report macro.

       addntosymbol(symbol)(n)(text)
              Adds text n times to symbol. The value n may also be the name of
              a defined counter (which itself will not be modified).

       affiliation(site)
              Defines an affiliation, to  appear  in  the  document  titlepage
              below the author field. Must appear before starting the document
              with article, report or book. The affiliation  is  only  printed
              when the author field is not empty.

       AfourEnlarged()
              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.

       appendix()
              Starts appendices

       article(title)(author)(date)
              Starts  an article. The top-level sectioning command is (n)sect.
              In HTML conversions only one output file is written.

       bf(text)
              Sets text in boldface.

       bind(text)
              Generate a binding character after text.

       book(title)(author)(date)
              Starts a book document.  The  top-level  sectioning  command  is
              (n)chapter,  (n)part  being  optional.  In HTML output files are
              created for each chapter.

       cell(contents)
              Sets a table cell, i.e., one element in a row. With  the  man/ms
              converters multiple blanks between cell() macro calls are merged
              into a single blank character.

       cells(nColumns)(contents)
              Set a table cell over nColumns columns. In html, LaTeX  and  xml
              formats  the information in the combined cells will be centered.
              With man/ms conversions  the  cells()  macro  simply  calls  the
              cell()  macro,  but  here the setmanalign() macro can be used to
              determine the alignment of multiple cells.

       cellsline(from)(count)
              Sets a horizontal line starting at column number from over count
              columns  in  a  row.  If from is less then the number of columns
              already added to a row then it is ignored. This  macro  must  be
              embedded  in  a  row  macro defining a table row.  To put a line
              across the table's full width use  rowline.  To  set  horizontal
              lines  across columns 1 until 2 and columns 4 until 5 table of a
              table use:

                  row(cellsline(1)(2)cellsline(4)(2))

              Combining cellsline and cell or cells calls in one row  produces
              undefined results.

       center(text)
              Sets  text centered, when the output format permits. Use nl() in
              the text to break lines.

       chapter(title)
              Starts a new chapter in books or reports.

       cindex()
              Generate an index entry for index c.

       cite(1)
              Sets a citation or quotation

       clearpage()
              Starts a new page, when the output format permits. Under HTML  a
              horizontal line is drawn.

       code(text)
              Sets  text  in  code  font, and prevents it from being expanded.
              For unbalanced parameter  lists,  use  CHAR(40)  to  get  (  and
              CHAR(41) to get ).

       columnline(from)(to)
              Sets  a  horizontal  line  over some columns in a row. Note that
              columnline defines  a  row  by  itself,  consisting  of  just  a
              horizontal  line  spanning  some of its columns, rather than the
              table's full width, like rowline. The  two  arguments  represent
              column  numbers.  It is the responsibility of the author to make
              sure that the from and to values are sensible. I.e.,

                  1 <= from <= to <= ncolumns

              Note: this macro cannot be used if multiple lines must be set in
              one row. In those cases the macro colsline should be used.

       def(macroname)(nrofargs)(redefinition)
              Defines  macroname  as  a  macro, having nrofargs arguments, and
              expanding  to  redefinition.  This  macro  is  a  shorthand  for
              DEFINEMACRO.  An error occurs when the macro is already defined.
              Use redef() to unconditionally define or redefine a macro.

       description(list)
              Sets list as a description list. Use dit(item) to indicate items
              in the list.

       dit(itemname)
              Starts an item named itemname in a descriptive list. The list is
              either enclosed by startdit() and enddit(), or is an argument to
              description().

       eit()  Indicates  an item in an enumerated list. The eit() macro should
              be an argument in enumerate().

       ellipsis()
              Sets ellipsis (...).

       em(text)
              Sets text as emphasized, usually italics.

       email(address)
              In HTML, this macro sets the address in a  <a  href="mailto=..">
              locator.  In  other  output  formats, the address is sent to the
              output. The email macro is a special case of url.

       endcenter()
              DEPRECATED. Use center().

       enddit()
              DEPRECATED. Use description().

       endeit()
              DEPRECATED. Use enumeration().

       endit()
              DEPRECATED. Use itemization().

       endmenu()
              DEPRECATED. Use menu().

       endtable()
              DEPRECATED. Use table().

       enumerate(list)
              DEPRECATED. Use enumeration().

       enumeration(list)
              enumeration() starts an enumerated list. Use eit() in  the  list
              to indicate items in the list.

       euro() 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).

       fig(label)
              This macro is a shorthand for figure ref(label) and  just  makes
              the  typing  shorter,  as  in  see  fig(schematic)  for  ..  See
              getfigurestring() and setfigurestring() for the figure text.

       figure(file)(caption)(label)
              Sets the picture in file as a figure in  the  current  document,
              using  the  descriptive  text caption. The label is defined as a
              placeholder  for  the  figure  number  and  can  be  used  in  a
              corresponding  ref  statement.  Note  that  the file must be the
              filename without extension: By default, Yodl  will  supply  .gif
              when  in  HTML mode, or .ps when in LaTeX mode. Figures in other
              modes may not (yet) haven been implemented.

       file(text)
              Sets text as filename, usually boldface.

       findex()
              Generate an index entry for index f.

       footnote(text)
              Sets text as a footnote,  or  in  parentheses  when  the  output
              format does not allow footnotes.

       gagmacrowarning(name name ...)
              Prevents  the  yodl program from printing cannot expand possible
              user macro. E.g., if you have in your document the  file(s)  are
              ..    then    you    might    want    to    put   before   that:
              gagmacrowarning(file). Calls NOUSERMACRO.

       getaffilstring()
              Expands to the string  that  defines  the  name  of  Affiliation
              Information,   by   default   AFFILIATION  INFORMATION.  Can  be
              redefined for national  language  support  by  setaffilstring().
              Currently, it is relevant only for txt.

       getauthorstring()
              Expands   to   the  string  that  defines  the  name  of  Author
              Information, by default AUTHOR INFORMATION. Can be redefined for
              national language support by setauthorstring(). Currently, it is
              relevant only for txt.

       getchapterstring()
              Expands to the string that defines a `chapter' entry, by default
              Chapter.   Can  be  redefined  for  national language support by
              setchapterstring().

       getdatestring()
              Expands to the string that defines the name of Date Information,
              by  default  DATE  INFORMATION.  Can  be  redefined for national
              language support by setdatestring(). Currently, it  is  relevant
              only for txt.

       getfigurestring()
              Returns  the string that defines a `figure' text, in captions or
              in the fig() macro.  The  string  can  be  redefined  using  the
              setfiguretext() macro.

       getpartstring()
              Expands  to  the  string that defines a `part' entry, by default
              Part.  Can  be  redefined  for  national  language  support   by
              setpartstring().

       gettitlestring()
              Expands   to   the   string  that  defines  the  name  of  Title
              Information, by default TITLE INFORMATION. Can be redefined  for
              national  language support by settitlestring(). Currently, it is
              relevant only for txt.

       gettocstring()
              Expands to the string that defines the  name  of  the  table  of
              contents,  by  default  Table  of Contents. Can be redefined for
              national language support by settocstring().

       htmlbodyopt(option)(value)
              Adds option="value" to the options of the <body ...> tag in HTML
              files.  Useful  options  are,  e.g.,  fgcolor and bgcolor, whose
              values are expressed as #rrggbb, where rr  are  two  hexadecimal
              digits  of  the  red component, gg two hexadecimal digits of the
              green component, and bb  two  hexadecimal  digits  of  the  blue
              component.

       htmlcommand(cmd)
              Writes cmd to the output when converting to html. The cmd is not
              further expanded by Yodl.

       htmlheadopt(option)
              Adds the literal text option to the current information  in  the
              head  section  of  an  HTML  document.  Option  may (or: should)
              contain plain html text. A commonly  occurring  head  option  is
              link,  defining,  e.g.,  a  style  sheet.  Since  that option is
              frequently  used,   it   has   received   a   dedicated   macro:
              htmlstylesheet.  Like htmlbodyopt this macro should be placed in
              the document's preamble.

       htmlnewfile()
              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'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 chapter
              definition.

       htmlstylesheet(url)
              Adds a <link rel="stylesheet" type="text/css"  ...>  element  to
              the  head  section  of  an  HTML document, using url in its href
              field. The argument url is not expanded,  and  should  be  plain
              HTML text, without surrounding quotes. The macro htmlheadopt can
              also be used to put information in the head-section of  an  HTML
              document, but htmlheadopt is of a much more general nature. Like
              htmlbodyopt this  macro  should  be  placed  in  the  document's
              preamble.

       htmltag(tagname)(start)
              Sets  tagname  as a HTML tag, enclosed by < and >. When start is
              zero, the tagname is prefixed with /.

       ifnewparagraph(truelist)(falselist)
              The macro ifnewparagraph should be  called  from  the  PARAGRAPH
              macro, if defined. It will insert truelist if a new paragraph is
              inserted, otherwise falselist is inserted (e.g.,  following  two
              consecutive  calls  of  PARAGRAPH).  This  macro  can be used to
              prevent the output of multiple blank lines.

       includefile(file)
              Includes  file.  The  default  extension  .yo  is  supplied   if
              necessary.

              NOTE:  Starting  with  Yodl  version  3.00.0 Yodl'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's file inclusion
              behavior now matches the way C's #include directive operates; it
              has  the  disadvantage that it may break some current documents.
              Conversion, however is simple but can be avoided  altogether  if
              Yodl's -L (--legacy-include) option is used.

              Furthermore, the includefile macro no longer defines a label. To
              define  a  label  just   before   the   file's   inclusion   use
              lincludefile.

       includeverbatim(file)
              Include  file  into  the  output.   No  processing is done, file
              should be in preformatted form, e.g.:
              whenhtml(includeverbatim(foo.html))

              NOTE: Starting with Yodl  version  3.00.0  Yodl'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's  file  inclusion
              behavior now matches the way C's #include directive operates; it
              has the disadvantage that it may break some  current  documents.
              Conversion,  however  is simple but can be avoided altogether if
              Yodl's -L (--legacy-include) option is used.

       it()   Indicates an item in  an  itemized  list.  The  list  is  either
              surrounded  by  startit()  and  endit(), or it is an argument to
              itemize().

       itemization(list)
              Sets list as an itemizationd list. Use it() to indicate items in
              the list.

       itemize(list)
              DEPRECATED. Use itemization().

       kindex()
              Generate an index entry for index k.

       label(labelname)
              Defines  labelname  as an anchor for a link command, or to stand
              for the last numbering of a section or figure in a ref command.

       langle()
              Character <

       languagedutch()
              Defines the Dutch-language specific headers. Active  this  macro
              via setlanguage(dutch).

       languageenglish()
              Defines the English-language specific headers. Active this macro
              via setlanguage(english).

       languageportugese()
              Defines the Portugese-language  specific  headers.  Active  this
              macro via setlanguage(portugese).

       LaTeX()
              The LaTeX symbol.

       latexaddlayout(arg)
              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 latexlayoutcmds()

       latexcommand(cmd)
              Writes  cmd  plus a white space to the output when converting to
              LaTeX. The cmd is not further expanded by Yodl.

       latexdocumentclass(class)
              Forces the LaTeX \documentclass{...} setting to class.  Normally
              the  class  is  defined  by  the macros article, report or book.
              This macro is an escape route incase you need  to  specify  your
              own document class for LaTeX. This option is a modifier and must
              appear before the article, report or book macros.

       latexlayoutcmds(NOTRANSs)
              This macro is provided in case you want to put  your  own  LaTeX
              layout commands into LaTeX output. The NOTRANSs are pasted right
              after the \documentclass stanza. The default is, of  course,  no
              local  LaTeX commands. Note that this macro does not overrule my
              favorite LaTeX layout. Use nosloppyhfuzz() and  standardlayout()
              to disable my favorite LaTeX layout.

       latexoptions(options)
              Set  latex  options:  documentclass[options].  This command must
              appear before the document type is stated  by  article,  report,
              etc..

       latexpackage(options)(name)
              Include  latex package(s), a useful package is, e.g., epsf. This
              command must appear  before  the  document  type  is  stated  by
              article, report, etc..

       lchapter(label)(title)
              Starts a new chapter in books or reports, setting a label at the
              beginning of the chapter.

       letter(language)(date)(subject)(opening)(salutation)(author)
              Starts a letter written in the indicated language. The  date  of
              the  letter  is set to `date', the subject of the letter will be
              `subject'. The letter starts with `opening'. It is based on  the
              `letter.cls'  document class definition.  The macro is available
              for LaTeX only. Preamble command suggestions:

       o      latexoptions(11pt)

       o      a4enlarged()

       o      letterreplyto(name)(address)(postalcode/city)

       o      letterfootitem(phone)(number), maybe e-mail too.

       o      letteradmin(yourdate)(yourref)

       o      letterto(addressitem). Use a separate letterto() macro call  for
              each new line of the address.

       letteraddenda(type)(value)
              Adds  an  addendum  at  the  end  of  a letter. `type' should be
              `bijlagen', `cc' or `ps'.

       letteradmin(yourdate)(yourref)
              Puts  `yourletterfrom'  and  `yourreference'  elements  in   the
              letter. If left empty, two dashes are inserted.

       letterfootitem(name)(value)
              Puts  a  footer  at the bottom of letter-pages. Up to three will
              usually fit.  LaTeX only.

       letterreplyto(name)(address)(zip city)
              Defines the `reply to' address in LaTeX or txt-letters.

       letterto(element)
              Adds `element' as an additional line to  the  address  in  LaTeX
              letters.

       link(description)(labelname)
              In  HTML  output  a  clickable link with the text description is
              created that points to the  place  where  labelname  is  defined
              using  the  label  macro.   Using link is similar to url, except
              that a hyperlink is set pointing  to  a  location  in  the  same
              document.   For   output  formats  other  than  HTML,  only  the
              description appears.

       lref(description)(labelname)
              This macro is a combination of the ref and link macros. In  HTML
              output  a clickable link with the text description and the label
              value is created that points to the  place  where  labelname  is
              defined  using  the  label  macro. For output formats other than
              HTML, only the description and the label value appears.

       lsect(label)(title)
              Starts a new section, setting a label at the  beginning  of  the
              section.

       lsubsect(label)(title)
              Starts   a   new   subsection.  Other  sectioning  commands  are
              subsubsect and subsubsubsect. A label is added just  before  the
              subsection.

       lsubsubsect(label)(title)
              Starts  a  sub-subsection,  a  label  is  added  just before the
              section

       lsubsubsubsect(label)(title)
              Starts a sub-sub-sub section. This level of  sectioning  is  not
              numbered,  in contrast to `higher' sectionings. A label is added
              just before the subsubsubection.

       lurl(locator)
              An url described by its Locator.  For small urls  with  readable
              addresses.

       mailto(address)
              Defines  the default mailto address for HTML output. Must appear
              before the document type is stated by article, report, etc..

       makeindex()
              Make index for latex.

       mancommand(cmd)
              Writes cmd to the output when converting to man. The cmd is  not
              further expanded by Yodl.

       manpage(title)(section)(date)(source)(manual)
              Starts  a  manual  page document. The section 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 not (n)sect  etc.,
              but manpage...(). The first section must be the manpagename, the
              last section must be the manpageauthor. The standard manpage for
              section  1 contains the following sections (in the given order):
              manpagename,        manpagesynopsis,         manpagedescription,
              manpageoptions,           manpagefiles,          manpageseealso,
              manpagediagnostics, manpagebugs, manpageauthor.  Optional  extra
              sections    can   be   added   with   manpagesection.   Standard
              manpageframes  for  several  manpagesections  are  provided   in
              /usr/local/share/yodl/manframes.

       manpageauthor()
              Starts  the AUTHOR entry in a manpage document. Must be the last
              section of a manpage.

       manpagebugs()
              Starts the BUGS entry in a manpage document.

       manpagedescription()
              Starts the DESCRIPTION entry in a manpage document.

       manpagediagnostics()
              Starts the DIAGNOSTICS entry in a manpage document.

       manpagefiles()
              Starts the FILES entry in a manpage document.

       manpagename(name)(short description)
              Starts  the  NAME  entry  in  a  manpage  document.  The   short
              description is used by, e.g., the whatis database.

       manpageoptions()
              Starts the OPTIONS entry in a manpage document.

       manpagesection(SECTIONNAME)
              Inserts  a  non-required  section named SECTIONNAME in a manpage
              document. This macro can be used to  augment  `standard'  manual
              pages with extra sections, e.g., EXAMPLES. Note that the name of
              the  extra  section  should  appear  in  upper  case,  which  is
              consistent with the normal typesetting of manual pages.

       manpageseealso()
              Starts the SEE ALSO entry in a manpage document.

       manpagesynopsis()
              Starts the SYNOPSIS entry in a manpage document.

       mbox() Unbreakable  box  in  LaTeX.  Other  formats  may have different
              opitions on our unbreakable boxex.

       menu(list)
              DEPRECATED.

       metaC(text)
              Put a line comment in the output.

       metaCOMMENT(text)
              Write format-specific comment to the output.

       mit()  DEPRECATED.

       mscommand(cmd)
              Writes cmd to the output when converting to ms. The cmd  is  not
              further expanded by Yodl.

       nchapter(title)
              Starts  a  chapter  (in  a  book or report) without generating a
              number before the title and without placing  an  entry  for  the
              chapter in the table of contents.

       nemail(name)(address)
              Named  email.  A more consistent naming for url, lurl, email and
              nemail would be nice.

       nl()   Forces a newline; i.e., breaks the current line in two.

       node(previous)(this)(next)(up)
              DEPRECATED Defines a node with name this,  and  links  to  nodes
              previous, next and (up), for the node command.

       nodeprefix(text)
              Prepend text to node names, e.g.
              nodeprefix(LilyPond) sect(Overview)
              Currently used in texinfo descriptions only.

       nodeprefix(text)
              Prepend text to node names, e.g.
              nodeprefix(LilyPond) sect(Overview)
              Currently used in texinfo descriptions only.

       nodetext(text)
              Use text as description for the next node, e.g.
              nodetext(The GNU Music Typesetter)chapter(LilyPond)
              Currently used in texinfo descriptions only.

       nop(text)
              Expand  to text, to avoid spaces before macros e.g.: a. Although
              a+sups(2) should have the same effect.

       nosloppyhfuzz()
              By default, LaTeX output contains commands that cause it to shut
              up   about   hboxes  that  are  less  than  4pt  overfull.  When
              nosloppyhfuzz() appears before stating the document type,  LaTeX
              complaints are `vanilla'.

       notableofcontents()
              Prevents  the generation of a table of contents. This is default
              in, e.g., manpage and plainhtml documents.  When  present,  this
              option  must  appear  before  stating  the  document  type  with
              article, report etc..

       notitleclearpage()
              Prevents the generation of a clearpage() instruction  after  the
              typesetting of title information. This instruction is default in
              all non article documents.  When  present,  must  appear  before
              stating the document type with article, book or report.

       notocclearpage()
              With the LaTeX convertor, no clearpage() instruction is inserted
              immediately  beyond  the  document's  table  of  contents.   The
              clearpage()  instruction  is  default  in  all  but  the article
              document type. When present,  must  appear  before  stating  the
              document   type   with  article,  book  or  report.  With  other
              convertors than the LaTeX convertor, it is ignored.)

       notransinclude(filename)
              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's contents, not  even  a
              newline.

              NOTE:  Starting  with  Yodl  version  3.00.0 Yodl'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's file inclusion
              behavior now matches the way C's #include directive operates; it
              has  the  disadvantage that it may break some current documents.
              Conversion, however is simple but can be avoided  altogether  if
              Yodl's -L (--legacy-include) option is used.

       noxlatin()
              When  used  in  the  preamble,  the LaTeX converter disables the
              inclusion of the  file  xlatin1.tex.  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 xlatin1.tex comes with the YODL distribution.)

       nparagraph(title)
              Starts   a   non-numbered   paragraph   (duh,   corresponds   to
              subparagraph in latex).

       npart(title)
              Starts a part in a book document, but without numbering  it  and
              without entering the title of the part in the table of contents.

       nsect(title)
              Starts  a  section,  but  does  not generate a number before the
              title nor an entry in the table of contents. Further  sectioning
              commands are nsubsect, nsubsubsect and nsubsubsubsect.

       nsubsect(title)
              Starts a non-numbered subsection.

       nsubsubsect(title)
              Starts a non-numbered sub-sub section.

       nsubsubsect(title)
              Starts a non-numbered sub-subsection.

       paragraph(title)
              Starts  a  parapgraph. This level of sectioning is not numbered,
              in  contrast  to  `higher'  sectionings  (duh,  corresponds   to
              subparagraph in latex).

       part(title)
              Starts a new part in a book document.

       pindex()
              Generate an index entry for index p.

       plainhtml(title)
              Starts  a  document  for  only  a  plain  HTML  conversion.  Not
              available in other output formats. Similar  to  article,  except
              that an author- and date field are not needed.

       printindex()
              Make index for texinfo (?).

       quote(text)
              Sets  the  text  as  a quotation. Usually, the text is indented,
              depending on the output format.

       rangle()
              Inserts the right angle character (>).

       redef(nrofargs)(redefinition)
              Defines macro macro to expand to redefinition.  Similar to  def,
              but  any  pre-existing  definition is overruled. Use ARGx in the
              redefinition part to indicate  where  the  arguments  should  be
              pasted.  E.g.,  ARG1  places the first argument, ARG2 the second
              argument, etc...

       redefinemacro(nrofargs)(redefinition)
              Defines macro macro to expand to redefinition.  Similar to  def,
              but  any  pre-existing  definition is overruled. Use ARGx in the
              redefinition part to indicate  where  the  arguments  should  be
              pasted.  E.g.,  ARG1  places the first argument, ARG2 the second
              argument, etc... This commands is actually calling redef().

       ref(labelname)
              Sets the reference for labelname. Use label to define a label.

       report(title)(author)(date)
              Starts a report type document. The top-level sectioning  command
              in a report is chapter.

       roffcmd(dotcmd)(sameline)(secondline)(thirdline)
              Sets  a t/nroff command that starts with a dot, on its own line.
              The arguments are: dotcmd  -  the  command  itself,  e.g.,  .IP;
              sameline  - when not empty, set following the dotcmd on the same
              line; secondline -  when  not  empty,  set  on  the  next  line;
              thirdline  -  when  not  empty, set on the third line. Note that
              dotcmd and thirdline are not further expanded by YODL, the other
              arguments are.

       row(contents)
              The   argument   contents   may  contain  a  man-page  alignment
              specification (only one specification can be entered  per  row),
              using setmanalign(). If omitted, the standard alignment is used.
              Furthermore it contains the contents of the elements of the row,
              using   cell()   or   cells()   macros.   If  cells()  is  used,
              setmanalign() should have been used too. In this macro call only
              the  cell(),  cells() and setmanalign() macros should be called.
              Any other macro call may produce unexpected results.

              The row macro defines a counter XXcellnr 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 XXcellnr.

       rowline()
              Sets a horizontal line over the full width  of  the  table.  See
              also  columnline().  Use rowline() instead of a row() macro call
              to obtain a horizontal line-separator.

       sc(text)
              Set text in small caps (or tt).

       sect(title)
              Starts a new section.

       setaffilstring(name)
              Defines name as the `affiliation information' string, by default
              AFFILIATION INFORMATION. E.g., after setaffilstring(AFILIACION),
              YODL outputs this Spanish string  to  describe  the  affiliation
              information.  Currently, it is relevant only for txt.

       setauthorstring(name)
              Defines  name  as  the  `Author  information' string, by default
              AUTHOR INFORMATION.  E.g.,  after  setauthorstring(AUTOR),  YODL
              outputs   this   portuguese   string   to  describe  the  author
              information.  Currently, it is relevant only for txt.

       setchapterstring(name)
              Defines name as the `chapter' string, by default Chapter.  E.g.,
              after  setchapterstring(Hoofdstuk),  YODL  gains some measure of
              national language support for Dutch. Note that LaTeX support has
              its  own  NLS,  this  macro  doesn't affect the way LaTeX output
              looks.

       setdatestring(name)
              Defines name as the `date information' string, by  default  DATE
              INFORMATION.  E.g., after setdatestring(DATA), YODL outputs this
              portuguese string to describe the date information.   Currently,
              it is relevant only for txt.

       setfigureext(name)
              Defines the name as the `figure' extension. The extension should
              include the period, if used. E.g., use setfigureext(.ps) if  the
              extensions of the figure-images should end in .ps

       setfigurestring(name)
              Defines  the  name  as  the  `figure'  text, used e.g. in figure
              captions. E.g., after setfigurestring(Figuur), Yodl  uses  Dutch
              names for figures.

       sethtmlfigureext(ext)
              Defines  the  filename  extension  for HTML figures, defaults to
              .jpg. Note that a leading dot must be included in ext.  The  new
              extension  takes effect starting with the following usage of the
              figure macro.  It is only active in  html,  but  otherwise  acts
              identically as setfigureext().

       setincludepath(name)
              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.

       setlanguage(name)
              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

       setlatexalign(alignment)
              This macro defines the table alignment used when setting  tables
              in  LaTeX.   Use  as  many  l (for left-alignment), r (for right
              alignment), and c (for centered-alignment) characters  as  there
              are columns in the table. See also table()

       setlatexfigureext(ext)
              Defines  the  filename  extension  for  encapsulated  PostScript
              figures in LaTeX, defaults to .ps. The dot must be included in t
              new  extension ext. The new extension takes effect starting with
              a following usage of the figure macro.  It  is  only  active  in
              LaTeX, but otherwise acts identically as setfigureext().

       setlatexverbchar(char)
              Set the char used to quote LaTeX \verb sequences

       setmanalign(alignment)
              This  macro defines the table alignment used when setting tables
              used  in  man-pages  (see  tbl(1)).   Use   as   many   l   (for
              left-alignment),   r   (for   right   alignment),   and  c  (for
              centered-alignment) characters  as  there  are  columns  in  the
              table. Furthermore, s 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 convertable to a  manpage  may
              contain  a  separate  setmanalign()  call.   Note  that  neither
              rowline nor columnline requires setmanalign() 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.

       setpartstring(name)
              Defines  name as the `part' string, by default Part. E.g., after
              setpartstring(Teil), Yodl identifies parts in  the  German  way.
              Note  that  LaTeX output does its own national language support;
              this macro doesn't affect the way LaTeX output looks.

       setrofftab(x)
              Sets the character separating items in a line of input data of a
              roff  (manpage) table. By default it is set to ~. This separator
              is used internally, and needs only be changed (into some  unique
              character)   if   the   table   elements  themselves  contain  ~
              characters.

       setrofftableoptions(optionlist)
              Set the options for tbl table, default: none.  Multiple  options
              should  be  separated  by  blanks, by default no option is used.
              From the tbl(1) manpage, the following options are selected  for
              consideration:

       o      center Centers the table (default is left-justified)

       o      expand Makes the table as wide as the current line length

       o      box Encloses the table in a box

       o      allbox  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  setrofftab()  which  is  used  to  set  the character
              separating items in a line of input data.

       settitlestring(name)
              Defines name as the `title information' string, by default TITLE
              INFORMATION.  E.g.,  after  settitlestring(TITEL),  YODL outputs
              this Dutch string to describe the title information.  Currently,
              it is relevant only for txt.

       settocstring(name)
              Defines name as the `table of contents' string, by default Table
              of Contents. E.g., after settocstring(Inhalt),  YODL  identifies
              the  table of contents in the German way. Note that LaTeX output
              does its own  national  language  support;  this  macro  doesn't
              affect the way LaTeX output looks.

       sgmlcommand(cmd)
              Writes cmd to the output when converting to sgml. The cmd is not
              further expanded by Yodl.

       sgmltag(tag)(onoff)
              Similar to htmltag, but used in the SGML converter.

       sloppyhfuzz(points)
              By default, LaTeX output contains commands that cause it to shut
              up   about   hboxes  that  are  less  than  4pt  overfull.  When
              sloppyhfuzz() appears before stating the  document  type,  LaTeX
              complaints  occur  only  if  hboxes  are  overfull  by more than
              points.

       standardlayout()
              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
              standardlayout()   directive  must  appear  before  stating  the
              document type as article, report, etc..

       startcenter()
              DEPRECATED. center() should be used.

       startdit()
              DEPRECATED. Use description().

       starteit()
              DEPRECATED. Use enumeration().

       startit()
              DEPRECATED. Use itemization().

       startmenu()
              DEPRECATED. Use menu().

       starttable()
              DEPRECATED. Use table().

       subs(text)
              Sets text in subscript in supporting formats

       subsect(title)
              Starts  a  new  subsection.  Other   sectioning   commands   are
              subsubsect and subsubsubsect.

       subsubsect(title)
              Starts a sub-subsection.

       subsubsubsect(title)
              Starts a sub-sub-sub-subsection. This level of sectioning is not
              numbered, in contrast to `higher' sectionings.

       sups(text)
              Sets text in superscript in supporting formats

       table(nColumns)(alignment)(Contents)
              The table()-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 l for left-alignment, c
              for centered-alignment and r  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.

              See also the specialized setmanalign() macro.

       tcell(text)
              Roff  helper  to  set  a table textcell, i.e., a paragraph.  For
              LaTeX special table formatting p{} should be used.

       telycommand(cmd)
              Writes cmd to the output when converting to tely. The cmd is not
              further expanded by Yodl.

       TeX()  The TeX symbol.

       texinfocommand(cmd)
              Writes  cmd to the output when converting to texinfo. The cmd is
              not further expanded by Yodl.

       tindex()
              Generate an index entry for index t.

       titleclearpage()
              Forces the generation of a clearpage() directive  following  the
              title  of  a  document. This is already the default in books and
              reports, but can  be  overruled  with  notitleclearpage().  When
              present,  must appear in the preamble; i.e., before the document
              type is stated with article, book or report.

       tocclearpage()
              With the LaTeX convertor, a clearpage() directive  if  inserted,
              immediately  following the document's table of contents. This is
              already the default in all but the article document type, but it
              can  be  overruled  by  notocclearpage().  When present, it must
              appear in the preamble; i.e., before the document type is stated
              with  article,  book  or  report. With other convertors than the
              LaTeX convertor, it is ignored.

       tt(text)
              Sets text in teletype font, and prevents it from being expanded.
              For  unbalanced  parameter  lists,  use  CHAR(40)  to  get ( and
              CHAR(41) to get ).

       txtcommand(cmd)
              Writes cmd to the output when converting to txt. The cmd is  not
              further expanded by Yodl.

       url(description)(locator)
              In  LaTeX  documents  the description is sent to the output. For
              HTML, a link is created with the  descriptive  text  description
              and  pointing  to  locator.  The locator should be the full URL,
              including service; e.g,  http://www.icce.rug.nl,  but  excluding
              the  double  quotes  that  are  necessary in plain HTML. Use the
              macro link to create links within the same document.  For  other
              formats, something like description [locator] will appear.

       verb(text)
              Sets  text  in  verbatim mode: not subject to macro expansion or
              character table expansion. The text  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.  For
              unbalanced  parameter  lists, use CHAR(40) to get ( and CHAR(41)
              to get ).

       verbinclude(filename)
              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
              verb(...), when the text to set in verbatim mode is better  kept
              in a separate file.

              NOTE:  Starting  with  Yodl  version  3.00.0 Yodl'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's file inclusion
              behavior now matches the way C's #include directive operates; it
              has  the  disadvantage that it may break some current documents.
              Conversion, however is simple but can be avoided  altogether  if
              Yodl's -L (--legacy-include) option is used.

       verbpipe(command)(text)
              Pipe text through command, but don't expand the output.

       vindex()
              Generate an index entry for index v.

       whenhtml(text)
              Sends  text to the output when in HTML conversion mode. The text
              is further expanded if necessary.

       whenlatex(text)
              Sends text to the output when in LATEX conversion mode. The text
              is further expanded if necessary.

       whenman(text)
              Sends  text  to the output when in MAN conversion mode. The text
              is further expanded if necessary.

       whenms(text)
              Sends text to the output when in MS conversion mode. The text is
              further expanded if necessary.

       whensgml(text)
              Sends  text to the output when in SGML conversion mode. The text
              is further expanded if necessary.

       whentely(text)
              Sends text to the output when in TELY conversion mode. The  text
              is further expanded if necessary.

       whentexinfo(text)
              Sends  text  to  the output when in TEXINFO conversion mode. The
              text is further expanded if necessary.

       whentxt(text)
              Sends text to the output when in TXT conversion mode.  The  text
              is further expanded if necessary.

       whenxml(text)
              Sends  text  to the output when in XML conversion mode. The text
              is further expanded if necessary.

       xit(itemname)
              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.

              This macro is only available within the xml-conversion mode. The
              argument must be a full filename, including .xml  extension,  if
              applicable.

              No  .xml  extension indicates a subdirectory, containing another
              sub-menu.

       xmlcommand(cmd)
              Writes cmd to the output when converting to xml. The cmd is  not
              further expanded by Yodl.

       xmlmenu(order)(title)(menulist)
              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.

              Order is the the `order' of the menu. If omitted,  no  order  is
              defined.

       xmlnewfile()
              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'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  chapter
              definition.

       xmlsetdocumentbase(name)
              Defines  name  as  the  XML  document  base.  No  default.  Only
              interpreted with xml conversions. It is used with the figure and
              xmlmenu macros.

       xmltag(tag)(onoff)
              Similar to htmltag, but used in the XML converter.

OPTIONS

       No options are relevant in respect to the macros.

FILES

       The files in /usr/share/yodl define the converter's macro packages. The
       scripts yodl2tex, yodl2html, yodl2man etc. perform the conversions.

SEE ALSO

       yodlstriproff(1),    yodl(1),    yodlbuiltins(7),    yodlconverters(1),
       yodlletter(7), yodlmanpage(7), yodlpost(1), yodlverbinsert(1).

BUGS

       -

AUTHOR

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