Use and redistribution is subject to the Berkeley Software License
Agreement and your Software Agreement with AT&T (Western Electric).
@(#)tt06 8.1 (Berkeley) 6/8/93
$FreeBSD: head/share/doc/usd/22.trofftut/tt06 96896 2002-05-19 03:33:24Z grog $
Local Motions: Drawing lines and characters
Remember `Area = \(*pr\u2\d' and the big `P' in the Paternoster. How are they done? troff provides a host of commands for placing characters of any size at any place. You can use them to draw special characters or to tune your output for a particular appearance. Most of these commands are straightforward, but messy to read and tough to type correctly.
If you won't use eqn , subscripts and superscripts are most easily done with the half-line local motions \eu and \ed . To go back up the page half a point-size, insert a \eu at the desired place; to go down, insert a \ed . \eu ( and \ed should always be used in pairs, as explained below.) Thus
1 Area = \e(*pr\eu2\ed
2 produces
1 Area = \(*pr\u2\d
2 To make the `2' smaller, bracket it with \es-2...\es0 . Since \eu and \ed refer to the current point size, be sure to put them either both inside or both outside the size changes, or you will get an unbalanced vertical motion.
Sometimes the space given by \eu and \ed isn't the right amount. The \ev command can be used to request an arbitrary amount of vertical motion. The in-line command
1 \ev'(amount)'
2 causes motion up or down the page by the amount specified in `(amount)'. For example, to move the `P' down, we used
1 2 ^in +0.6i (move paragraph in) ^ll -0.3i (shorten lines) ^ti -0.3i (move P back) \ev'2'\es36P\es0\ev'-2'ater noster qui est in caelis ...
2 A minus sign causes upward motion, while no sign or a plus sign means down the page. Thus \ev\(fm-2\(fm causes an upward vertical motion of two line spaces.
There are many other ways to specify the amount of motion _
1 \ev'0.1i' \ev'3p' \ev'-0.5m'
2 and so on are all legal. Notice that the scale specifier i or p or m goes inside the quotes. Any character can be used in place of the quotes; this is also true of all other troff commands described in this section.
Since troff does not take within-the-line vertical motions into account when figuring out where it is on the page, output lines can have unexpected positions if the left and right ends aren't at the same vertical position. Thus \ev , like \eu and \ed , should always balance upward vertical motion in a line with the same amount in the downward direction.
Arbitrary horizontal motions are also available _ \eh is quite analogous to \ev , except that the default scale factor is ems instead of line spaces. As an example,
1 \eh'-0.1i'
2 causes a backwards motion of a tenth of an inch. As a practical matter, consider printing the mathematical symbol `>>'. The default spacing is too wide, so eqn replaces this by
1 >\eh'-0.3m'>
2 to produce >\h'-.3m'>.
Frequently \eh is used with the `width function' \ew to generate motions equal to the width of some character string. The construction
1 \ew'thing'
2 is a number equal to the width of `thing' in machine units (1/432 inch). All troff computations are ultimately done in these units. To move horizontally the width of an `x', we can say
1 \eh'\ew'x'u'
2 As we mentioned above, the default scale factor for all horizontal dimensions is m , ems, so here we must have the u for machine units, or the motion produced will be far too large. troff is quite happy with the nested quotes, by the way, so long as you don't leave any out.
As a live example of this kind of construction, all of the command names in the text, like .sp , were done by overstriking with a slight offset. The commands for .sp are
1 ^sp\eh'-\ew'.sp'u'\eh'1u'.sp
2 That is, put out `.sp', move left by the width of `.sp', move right 1 unit, and print `.sp' again. (Of course there is a way to avoid typing that much input for each command name, which we will discuss in Section 11.) .WS
There are also several special-purpose troff commands for local motion. We have already seen \e0 , which is an unpaddable white space of the same width as a digit. `Unpaddable' means that it will never be widened or split across a line by line justification and filling. There is also \e (blank), .tr ^^ which is an unpaddable character the width of a space, \e| , which is half that width, \e^ , which is one quarter of the width of a space, and \e& , which has zero width. .tr ^. (This last one is useful, for example, in entering a text line which would otherwise begin with a `.'.)
The command \eo , used like
1 \eo'set of characters'
2 causes (up to 9) characters to be overstruck, centered on the widest. This is nice for accents, as in
1 2 syst\eo"e\e(ga"me t\eo"e\e(aa"l\eo"e\e(aa"phonique
2 which makes
1 syst\o"e\(ga"me t\o"e\(aa"l\o"e\(aa"phonique
2 The accents are \e(ga and \e(aa , or \e\` and \e\' ; remember that each is just one character to troff .
You can make your own overstrikes with another special convention, \ez , the zero-motion command. \ezx suppresses the normal horizontal motion after printing the single character x , so another character can be laid on top of it. Although sizes can be changed within \eo , it centers the characters on the widest, and there can be no horizontal or vertical motions, so \ez may be the only way to get what you want:
1 \s8\z\(sq\s14\z\(sq\s22\z\(sq\s36\(sq
2 is produced by
1 ^sp 2 \es8\ez\e(sq\es14\ez\e(sq\es22\ez\e(sq\es36\e(sq
2 The .sp is needed to leave room for the result.
As another example, an extra-heavy semicolon that looks like
1 \s+6\z,\v'-0.25m'.\v'0.25m'\s0 instead of ; or \s+6;\s0
2 can be constructed with a big comma and a big period above it:
1 \es+6\ez,\ev'-0.25m'.\ev'0.25m'\es0
2 `0.25m' is an experimentally-derived constant.
A more ornate overstrike is given by the bracketing function \eb , which piles up characters vertically, centered on the current baseline. Thus we can get big brackets, constructing them with piled-up smaller pieces:
1 \b'\(lt\(lk\(lb' \b'\(lc\(lf' x \b'\(rc\(rf' \b'\(rt\(rk\(rb'
2 by typing in only this:
1 0 ^sp \eb\(fm\e(lt\e(lk\e(lb\(fm \eb\(fm\e(lc\e(lf\(fm x \eb\(fm\e(rc\e(rf\(fm \eb\(fm\e(rt\e(rk\e(rb\(fm
2
troff also provides a convenient facility for drawing horizontal and vertical lines of arbitrary length with arbitrary characters. \el\(fm1i\(fm draws a line one inch long, like this: \l'1i'\|. The length can be followed by the character to use if the \(ru isn't appropriate; \el\(fm0.5i.\(fm draws a half-inch line of dots: \l'.5i.'. The construction \eL is entirely analogous, except that it draws a vertical line instead of horizontal.