Provided by: yodl_2.15.2-2_i386

#### 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.

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.

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

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.

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

LaTeX  layout  commands.  The  command  is  terminated  with  an

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      letterfootitem(phone)(number), maybe e-mail too.

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

Adds an addendum at the  end  of  a  letter.  ‘type’  should  be
‘bijlagen’, ‘cc’ or ‘ps’.

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.

letterto(element)
letters.

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

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

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

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

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

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

nsect(title)
Starts  a  section,  but  does  not generate a number before the
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

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)
of Contents. E.g., after settocstring(Inhalt),  YODL  identifies
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().

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.

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,
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
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

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

Starts  an  xmlmenu. Use itemization() to define the items. Only
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

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.

#### SEEALSO

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

-

#### AUTHOR

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