Provided by: yodl_2.12.2-1_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.

       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.

       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

       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 and defines  a  label  with  the  same  name.  The
              default extension .yo is supplied if necessary.

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

       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.

       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.

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

       sups(text)
              Sets superscript in formats allowing so

       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 superscript in formats allowing so

       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.

       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

       yodl(1), yodlmanpage(7), yodlconverters(1)

DIAGNOSTICS

       Error messages and warnings are printed to stderr. There are  too  many
       warnings  or  error  messages  to  enumerate,  but they should be self-
       explanatory.

BUGS

       The  macro  package  may  contain  bugs,  but  I’m   working   on   it.
       Furthermore, the macro package may not be complete.

AUTHOR

           Frank B. Brokken (f.b.brokken@rug.nl),
           Original version by Karel Kubat (karel@e-tunity.nl),