<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (c) 2010 Stijn van Dongen -->
<head>
<meta name="keywords" content="manual">
<style type="text/css">
/* START aephea.base.css */
body
{ text-align: justify;
margin-left: 0%;
margin-right: 0%;
}
a:link { text-decoration: none; }
a:active { text-decoration: none; }
a:visited { text-decoration: none; }
a:link { color: #1111aa; }
a:active { color: #1111aa; }
a:visited { color: #111166; }
a.local:link { color: #11aa11; }
a.local:active { color: #11aa11; }
a.local:visited { color: #116611; }
a.intern:link { color: #1111aa; }
a.intern:active { color: #1111aa; }
a.intern:visited { color: #111166; }
a.extern:link { color: #aa1111; }
a.extern:active { color: #aa1111; }
a.extern:visited { color: #661111; }
a.quiet:link { color: black; }
a.quiet:active { color: black; }
a.quiet:visited { color: black; }
div.verbatim
{ font-family: monospace;
margin-top: 1em;
margin-bottom: 1em;
font-size: 10pt;
margin-left: 2em;
white-space: pre;
}
div.indent
{ margin-left: 8%;
margin-right: 0%;
}
.right { text-align: right; }
.left { text-align: left; }
.nowrap { white-space: nowrap; }
.item_leader
{ position: relative;
margin-left: 8%;
}
.item_compact { position: absolute; vertical-align: baseline; }
.item_cascade { position: relative; }
.item_leftalign { text-align: left; }
.item_rightalign
{ width: 2em;
text-align: right;
}
.item_compact .item_rightalign
{ position: absolute;
width: 52em;
right: -2em;
text-align: right;
}
.item_text
{ position: relative;
margin-left: 3em;
}
.smallcaps { font-size: smaller; text-transform: uppercase }
/* END aephea.base.css */
.debug { border: solid; border-width: 1px; }
</style>
<title>Aephea base definitions</title>
</head>
<body>
<p style="text-align:right">
8 Jan 2010
<a class="local" href="aephea-base.ps"><b>aephea-base</b></a>
1.002, 10-008
</p>
<div class=" itemize " style="margin-top:1em; font-size:100%">
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">1.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#name">NAME</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">2.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#description">DESCRIPTION</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">3.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#itemintro">INTRODUCTION TO THE ITEMIZE ENVIRONMENT</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">4.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#itemuse">USING THE ITEMIZE ENVIRONMENT</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">5.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#spacing">THE SPACING ENVIRONMENT</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">6.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#macros">MACROS</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">7.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#issues">ISSUES</a>
</div>
</div>
<a name="name"></a>
<h2>NAME</h2>
<p style="margin-bottom:0" class="asd_par">
aephea-base — a description of Aephea base definitions</p>
<p style="margin-bottom:0" class="asd_par">
The macros in this package have been ported to both <abbr class="ucase" title="Hyper Text Markup Language">HTML</abbr> and
troff.</p>
<a name="description"></a>
<h2>DESCRIPTION</h2>
<p style="margin-bottom:0" class="asd_par">
<i>aephea-base</i> — A description of Aephea base definitions.
The macros in this package have been ported to both <abbr class="ucase" title="Hyper Text Markup Language">HTML</abbr> and troff.
This package is used by the Aephea <tt>simpledocument</tt> class
and by the Portable Unix Documentation (<acronym class="ucase" title="Portable Unix Documentation">PUD</acronym>) mini-languages for
authoring manual pages (<a class="local sibling" href="pud-man.html">pud-man</a>) and the <acronym class="ucase" title="Portable Unix Documentation">PUD</acronym> language
for <abbr class="ucase" title="Frequently Asked Questions">FAQ</abbr> authoring (<a class="local sibling" href="pud-faq.html">pud-faq</a>).</p>
<p style="margin-bottom:0" class="asd_par">
There is a small list of known issues in the <a class="intern" href="#issues">ISSUES</a> section,
mostly concerning the troff device. These should generally be of no
concern at all, but if you run into trouble look there first. A quick
glance through the list <i>before</i> you run into trouble may be the
wisest thing to do.</p>
<a name="itemintro"></a>
<h2>INTRODUCTION TO THE ITEMIZE ENVIRONMENT</h2>
<p style="margin-bottom:0" class="asd_par">
The <i>itemize</i> environemnt is the Aephea workhorse for lists,
enumerations, itemizations, and other tailed creatures. A simple and
valid use is for example
</p>
<div class="verbatim"> \begin{itemize}
\item{\bf{foo}}
\car{
For I am foo.
}
\items{
{\bf{barra}}
{\bf{zuttelezut}}
}
\car{
For we are bar and zut.
}
\end{itemize}</div>
<p style="margin-top:0em; margin-bottom:0em">
This source result in the following output:
</p>
<div class=" itemize " style="margin-top:1em; font-size:100%">
<div class=" item_cascade"><div class=" item_leftalign nowrap " ><b>foo</b></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
For I am foo.
</p>
</div>
<div class=" item_cascade item_leftalign nowrap" ><b>barra</b></div><div class=" item_cascade item_leftalign nowrap" ><b>zuttelezut</b></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
For we are bar and zut.
</p>
</div>
</div>
<p style="margin-bottom:0" class="asd_par">
This is not impressive at all, but it gives an idea of how itemize works.
The following example is a single itemize environment providing a
rollercoasterride through most of the features of the itemize environment.
As shown below, it is possible to change all the itemize settings and styles
at will even within a single itemize instance. Of course this is not useful
at all except for demonstrating the <i>itemize</i> capabilities, but it goes
to show that the itemize macros are quite robust (by virtue of modularity).
</p>
<p style="margin-bottom:0"><b>NOTE</b><br>
The entire listing below was put in Aephea's <i>spacing</i> environment,
described further below. The environment was used to create
extra margins on the two sides.
</p>
<div style="
margin-left:2em;
margin-right:2em;
">
<div class=" itemize " style="margin-top:1em; font-size:100%">
<div class=" item_compact"><div class=" item_rightalign " style="right:-2em">1</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
Spacing modes <i>compact</i> and <i>cascade</i> are determined by the key <i>flow</i>.
The current mode is <i>compact</i>, meaning that the itemize token and the ensuing text are on the same line.
Below, compact mode is switched off (approximately) halfway.
The <i>interitem</i> key determines the amount skipped between an item description
and the next item.
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_compact"><div class=" item_rightalign " style="right:-2em">2</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
Several item modes (custom, mark, enumeration).
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_compact"><div class=" item_rightalign " style="right:-2em">3</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
Several enumeration modes (roman, arabic, alphabetic).
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_compact"><div class=" item_rightalign " style="right:-2em">iv)</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
The style of a list can be changed while in the middle of it.
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_compact"><div class=" item_rightalign " style="right:-2em">v)</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
Nuther item.
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_compact"><div class=" item_rightalign " style="right:-2em">vi)</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
The list can be 'interupted' and resumed (by means of
the <tt>\intermezzo#1</tt> macro).
</p>
</div>
<div style="margin-top:0em"> </div>
<div style="position:relative; margin-left:0em">
Perhaps you wonder what good is THAT for, and justly so.
The <tt>\intermezzo#1</tt> macro should only be used inbetween different
items, i.e. it should <i>not</i> split content belonging to a single item.
</div>
<div style="margin-top:0em"> </div><div class=" item_compact"><div class=" item_rightalign " style="right:-2em">[7]</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
Items can be optionally and automatically
right and/or left delimited. The current
item is delimited with square brackets.
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_compact"><div class=" item_leftalign " >[8]</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
Items can be left or right aligned.
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_compact"><div class=" item_leftalign " >[9]</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
Items can be stacked, which is supported only when <i>flow</i> is set to <i>cascade</i>.
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign " >[10]</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
Beginning with this item, <i>flow</i> is set to <i>cascade</i>.
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade item_leftalign nowrap" >Implying</div><div class=" item_cascade item_leftalign nowrap" >That</div><div class=" item_cascade item_leftalign nowrap" >Stacking</div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
is now possible.
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_rightalign " style="right:-2em">[12]</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
(back to right-align) The itemcounter just keeps running by the way.
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_compact"><div class=" item_rightalign " style="right:-2em">[18]</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
(back to compact) But the counter can be manipulated at will.
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_compact"><div class=" item_rightalign " style="right:-2em"><span class="itembullet">•</span></div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
A bullet item.
</p>
</div>
<div class=" item_compact"><div class=" item_rightalign " style="right:-2em"><span class="itembullet">•</span></div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
Now <i>interitem</i> is set to 0 (affecting the current list), and a new list
is started contiguous to the present text (by having its margintop set to 0).
</p>
<div class=" itemize " style="margin-top:0em; font-size:100%">
<div class=" item_compact"><div class=" item_rightalign " style="right:-2em">a.</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">Hubris</p>
</div>
<div class=" item_compact"><div class=" item_rightalign " style="right:-2em">b.</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">Laziness</p>
</div>
<div class=" item_compact"><div class=" item_rightalign " style="right:-2em">c.</div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">Impatience</p>
</div>
</div>
<p style="margin-top:0em; margin-bottom:0em">Are the three virtues of programming.</p>
</div>
<div class=" item_compact"><div class=" item_rightalign " style="right:-2em"><span class="itembullet">•</span></div></div>
<div class=" item_text " style="margin-left:4em">
<p style="margin-top:0em; margin-bottom:0em">
This concludes a listing showing most of the itemize capabilities.
</p>
</div>
</div>
</div>
<a name="itemuse"></a>
<h2>USING THE ITEMIZE ENVIRONMENT</h2>
<p style="margin-bottom:0" class="asd_par">
You steer the itemize environment by providing it with tag-value pairs like so:
</p>
<div class="verbatim"> \begin{itemize}{
{flow}{compact}
{interitem}{1}
{align}{right}
{type}{abc}
{rp}{.}
}</div>
<p style="margin-top:0em; margin-bottom:0em">
This is the list of tags that you may use.
</p>
<div class=" itemize " style="margin-top:1em; font-size:100%">
<div class=" item_cascade"><div class=" item_leftalign nowrap " ><i>margintop</i></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">Top of table, anomalous unit (ems), default 0.</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign nowrap " ><i>interitem</i></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">Paragraph skip in <i>ems</i> inbetween items, default 0.</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign nowrap " ><i>flow</i></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">Set to compact or cascade</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign nowrap " ><i>textindent</i></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">Width of text indent in ems.</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign nowrap " ><i>itemmargin</i></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">Width of item margin in ems (for right-aligned items).</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign nowrap " ><i>mark</i></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">E.g. <tt>\*{itembullet}</tt> (if type=mark), affects <tt>\item</tt>.</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign nowrap " ><i>align</i></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">One of left or right (item alignment), default left.</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign nowrap " ><i>class_all</i></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">class name assigned to all block-level elements</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign nowrap " ><i>lp</i></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">What's printed immediately to the left of an item.</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign nowrap " ><i>rp</i></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">What's printed immediately to the right of an item.</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign nowrap " ><i>type</i></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">One of mark, roman, abc, arabic, affects <tt>\item</tt>.</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign nowrap " ><i>itemcount</i></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">The count of items seen so far, e.g. 13 right now.</p>
</div>
</div>
<p style="margin-bottom:0" class="asd_par">
You need to know that the itemize environment internally maps these tags
to dollar keys simply by prepending a dollar.
Thus, if you want to reset one of the values associated with such a tag,
you need to do e.g.
</p>
<div class="verbatim"> \set{$align}{right}
\set{$itemcount}{30}</div>
<p style="margin-top:0em; margin-bottom:0em">
A more robust to do this is to ensure that the modified key is retrieved
from the right dictionary, i.e. the top-level <i>itemize</i> dictionary,
as follows.
</p>
<div class="verbatim"> \set{{dict}{itemize}}{$align}{right}
\set{{dict}{itemize}}{$itemcount}{30}</div>
<a name="spacing"></a>
<h2>THE SPACING ENVIRONMENT</h2>
<p style="margin-bottom:0" class="asd_par">
Its syntax is identical to that of the <i>itemize</i> environment.
It accepts tags <i>left</i>, <i>right</i>, <i>top</i>, and <i>bottom</i>.
These should receive numeric values. The associated
unit is <i>em</i>.
</p>
<p style="margin-bottom:0" class="asd_par">
The troff device does not yet support the <i>top</i> and <i>bottom</i>
tags.
</p>
<a name="macros"></a>
<h2>MACROS</h2>
<div class=" itemize " style="margin-top:1em; font-size:100%">
<div class=" item_cascade item_leftalign nowrap" ><a name="optenref2">\<tt>enref#2</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optiref2">\<tt>iref#2</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optlref2">\<tt>lref#2</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optaref2">\<tt>aref#2</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="opthttpref1">\<tt>httpref#1</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optsibref1">\<tt>sibref#1</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optsibref2">\<tt>sibref#2</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optsibref3">\<tt>sibref#3</tt></a></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
<tt>\enref#2</tt> <i>creates</i> a link for which the first argument is the anchor
and for which the second argument is the content (which can be left empty).
<tt>\iref#2</tt> takes such an anchor as the first argument and it takes content
that carries the link as the second argument. <tt>\lref#2</tt> takes a file name
(possibly including a relative or absolute path) as the first argument and
content as the second argument. <tt>\aref#2</tt> takes a URL (later possibly a
URI) as the first argument and content as the second argument. <tt>\sibref#2</tt>
takes a label as argument which presumably is the name of some application.
It may append an extension depending on the current device, and it assumes
that <tt>label + extension</tt> is the name of a file in the current directory.
The second argument is displayed in the text. For <tt>\sibref#1</tt> the
displayed text is the same as the label. For <tt>\sibref#3</tt> the second
argument is an additional anchor within the file being linked to, and
the third argument is the displayed text.
<tt>\httpref#1</tt> simply prints a URL which will be active when html is output.</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade item_leftalign nowrap" ><a name="optpar1">\<tt>par#1</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optcpar2">\<tt>cpar#2</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optcar1">\<tt>car#1</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optccar2">\<tt>ccar#2</tt></a></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
These are all paragraph macros that carry the paragraph content as
the last argument. The first argument of <tt>\cpar#2</tt> and <tt>\ccar#2</tt>
is the caption. These macros will ensure well-formedness for devices
that support it, such as <abbr class="ucase" title="Hyper Text Markup Language">HTML</abbr>.
Use <tt>\car#1</tt> where you don't need a paragraph skip, but just need to
indicate that you are in text mode again. You can simply always use
<tt>\par#1</tt> and never use <tt>\car#1</tt>. If you care about the details of spacing
though, or if you have particular trouble for example in creating an itemize
environment where you do not want top and bottom margins, then it could be
worthwile to turn to <tt>\car#1</tt>. Examples for using <tt>\car#1</tt> are:
</p>
<div class=" itemize " style="margin-top:0em; font-size:100%">
<div class=" item_compact"><div class=" item_rightalign " style="right:-1em"><span class="itembullet">•</span></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">After an environment that always carries a bottom margin.</p>
</div>
<div class=" item_compact"><div class=" item_rightalign " style="right:-1em"><span class="itembullet">•</span></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
After an environment that does <i>not</i> carry a bottom margin,
and where you specifically want the environment to be contiguous to the
enclosing text. The listing you are currently reading is an
example of this.
</p>
</div>
</div>
<p style="margin-top:0em; margin-bottom:0em">
As promised. The <tt>\car</tt> macro may feel a little unusual. If you don't mind
standing the chance of a little spurious vertical white-space just use
<tt>\par</tt> all the time. If you really need it, such as in an 'inline' listing
as above, the <tt>\car</tt> macro is ready to do the job.
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade item_leftalign nowrap" ><a name="optbf1">\<tt>bf#1</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optit1">\<tt>it#1</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="opttt1">\<tt>tt#1</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optv1">\<tt>v#1</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optftinc2">\<tt>ftinc#2</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optftdec2">\<tt>ftdec#2</tt></a></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
The first four items set their argument in the <b>font</b> <i>specified</i>.
<tt>\tt#1</tt> and <tt>\v#1</tt> both denote a typewriter font. <i>These macros should
not be nested if troff is to be among the output devices</i>. Support for the
last two items is not yet very robust. They temporarily <span style="font-size:120%">increment</span>
respectively <span style="font-size:80%">decrement</span> the font by the amount of the first argument and
apply the resulting setting to the second argument.
</p>
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade item_leftalign nowrap" ><a name="optverbatim1">\<tt>verbatim#1</tt></a></div><div class=" item_cascade item_leftalign nowrap" ><a name="optverbatix1">\<tt>verbatix#1</tt></a></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Make the device output the contents verbatim in a mono-spaced font,
obeying spaces and newlines. This does not prohibit expansion of
macros, use <tt>\protect#1</tt> for that. The macro <tt>\verbatim#1</tt> will
create a non-breaking environment.
</p>
</div>
</div>
<a name="issues"></a>
<h2>ISSUES</h2>
<div class=" itemize " style="margin-top:0em; font-size:100%">
<div class=" item_cascade"><div class=" item_leftalign nowrap " ><b>Nesting</b></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Do not nest <tt>\bf#1</tt>, <tt>\it#1</tt>, <tt>\tt#1</tt>, or <tt>\v#1</tt> macros if troff is
among the output devices. It will yield unexpected results.
</p>
</div>
<div style="margin-top:0em"> </div>
<div style="position:relative; margin-left:0em">
The rest of this list pertains to the <i>itemize</i> environment.
</div>
<div style="margin-top:0em"> </div><div class=" item_cascade"><div class=" item_leftalign nowrap " ><b>Margins</b></div></div>
<div class=" item_text " style="margin-left:2em">
<p style="margin-top:0em; margin-bottom:0em">
Do not use fractional values for <tt>textindent</tt> and <tt>itemmargin</tt> in the itemize
environment, if troff is among the output devices.
The reason is that the Aephea macros use the difference between these two values
and pass them on to the output devices. Troff rounds all values it gets
and thus the additive relationship between the values may be lost.
</p>
</div>
</div>
</body>
</html>
distrib
>
Mageia
>
7
>
i586
>
media
>
core-release
>
by-pkgid
>
a47d51544ec63a4f57df69ffdfe2c320
>
files
>
12
