summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authoresr <esr>2007-02-19 05:54:56 +0000
committeresr <esr>2007-02-19 05:54:56 +0000
commit2202d53e86df84185ea6c2d678bc5c838163691a (patch)
treeb6613eb9e712db0b3d2c058042d9781bae4dbdc2 /man
parent31a90833d3c5ce7e5fe9ef4d6433bf554c65393a (diff)
downloadgroff-2202d53e86df84185ea6c2d678bc5c838163691a.tar.gz
* tmac/groff.man: Get rid of the big, ugly, and totally
nonportable ExecFF macro. The code is simpler without it.
Diffstat (limited to 'man')
-rw-r--r--man/groff.man300
1 files changed, 227 insertions, 73 deletions
diff --git a/man/groff.man b/man/groff.man
index e7431539..1e9c7bf0 100644
--- a/man/groff.man
+++ b/man/groff.man
@@ -46,42 +46,6 @@ FDL in the main directory of the groff source package.
.de Text
. nop \)\$*
..
-.c ---------------------------------------------------------------------
-.c .ExecFF macro font1 font2 text1 text2 text1 text2 ...
-.c
-.c Concat text arguments using alternating fonts and feed into macro.
-.c For a trailing punctuation, terminate the call with \c.
-.c
-.de ExecFF
-. if (\n[.$] < 4) \
-. return
-. ds @a\"
-. ds @m \$1\"
-. ds @f1 \$2\"
-. ds @f2 \$3\"
-. shift 3
-. ds @s\"
-. while 1 \{\
-. if (\n[.$] = 0) \
-. break
-. ds @a \$1\"
-. as @s \f[\*[@f1]]\*[@a]\f[]\"
-. shift
-. if (\n[.$] = 0) \
-. break
-. ds @a \$1\"
-. as @s \f[\*[@f2]]\*[@a]\f[]\"
-. shift
-. \}
-. \*[@m] "\*[@s]\f[R]"
-. ft P \" to make \c happy
-. rm @m
-. rm @s
-. rm @a
-. rm @f1
-. rm @f2
-..
-.
.c --------- command line option ---------
.
.de option
@@ -91,20 +55,11 @@ FDL in the main directory of the groff source package.
.
.c --------- characters ---------
.
-.de character
-. ExecFF Text CB R \$*
-..
.de squoted_char
-. ds @1 \$1\"
-. shift
-. ExecFF Text R CB \[oq] \*[@1] "\[cq]\$*"
-. rm @1
+. Text \[oq]\f[CB]\$1\f[]\[cq]\$2
..
.de dquoted_char
-. ds @1 \$1\"
-. shift
-. ExecFF Text R CB \[lq] \*[@1] "\[rq]\$*"
-. rm @1
+. Text \[lq]\f[CB]\$1\f[]\[rq]\$2
..
.c --------- requests ---------
.
@@ -163,7 +118,7 @@ FDL in the main directory of the groff source package.
.de ESC
. if (\n[.$] < 1)
. ab .ESC needs 1 or 2 arguments.
-. ExecFF IP CB I "\[rs]\$1" "\,\$2\/"
+. Text "\f[CB]\[rs]\$1" "\,\f[I]\$2\/\fR"
..
.c ---------------------------------------------------------------------
.c .ESC[] name arg
@@ -177,7 +132,7 @@ FDL in the main directory of the groff source package.
.de ESC[]
. if !(\n[.$] = 2) \
. ab .ESC[] needs exactly 2 arguments.
-. ExecFF IP CB I "\[rs]\$1\[lB]" "\h'-0.2m'\$2\h'-0.15m'" \[rB]
+. Text "\f[CB]\[rs]\$1\[lB]\f[]\h'-0.2m'\f[I]\$2\f[]\h'-0.15m'\[rB]"
..
.c ---------------------------------------------------------------------
.c .ESCq name arg
@@ -191,7 +146,7 @@ FDL in the main directory of the groff source package.
.de ESCq
. if !(\n[.$] = 2) \
. ab .ESCq needs exactly 2 argument.
-. ExecFF IP CB I "\[rs]\$1\[cq]" "\h'-0.3m'\$2" \[cq]
+. Text "\f[CB]\[rs]\$1\[cq]\f[]\h'-0.3m'\f[I]\$2\f[]\[cq]"
..
.c ---------------------------------------------------------------------
.c .ESC? arg
@@ -204,7 +159,7 @@ FDL in the main directory of the groff source package.
.de ESC?
. if !(\n[.$] = 1) \
. ab .ESC? needs exactly 1 arguments.
-. ExecFF IP CB I \[rs]? "\$1" ?
+. Text "\f[CB]\[rs]?\f[I]\$1\f[CB]?\f[R]"
..
.c ---------------------------------------------------------------------
.c .esc name [punct]
@@ -269,11 +224,7 @@ FDL in the main directory of the groff source package.
.
.c synopsis for string, with \*[]
.de STRING
-. ds @1 \$1\"
-. shift 1
-. TP 10n
-. ExecFF Text R CB \[rs]*[ \*[@1]\f[]\f[R]] \$*
-. rm @1
+. Text \[rs]*[\f[CB]\$1\f[]] \$2
..
.c synopsis for a long string
.de string
@@ -287,11 +238,7 @@ FDL in the main directory of the groff source package.
.
.c synopsis for registers, with \n[]
.de REG
-. ds @1 \$1\"
-. shift 1
-. TP 10n
-. ExecFF Text R CB \[rs]n[ \*[@1]\f[]\f[R]] \$*
-. rm @1
+. Text \[rs]n[\f[CB]\$1\f[]]
..
.c reference of a register, without decoration
.de register
@@ -595,7 +542,7 @@ There is a small set of characters that have a special controlling
task in certain conditions.
.
.TP
-.character .
+\&\f[CB].\f[]
A dot is only special at the beginning of a line or after the
condition in the requests
.request if ,
@@ -622,7 +569,7 @@ In text paragraphs, it is advantageous to start each sentence at a
line of its own.
.
.TP
-.character '
+\&\f[CB]'\f[]
The single quote has two controlling tasks.
.
At the beginning of a line and in the conditional requests it is the
@@ -649,7 +596,7 @@ Groff provides a printable representation with the
escape sequence.
.
.TP
-.character \[dq]
+\&\f[CB]\[dq]\f[]
The double quote is used to enclose arguments in requests, macros, and
strings.
.
@@ -672,7 +619,7 @@ Groff provides a printable representation with the
escape sequence.
.
.TP
-.character \[rs]
+\&\f[CB]\[rs]\f[]
The backslash usually introduces an escape sequence (this can be
changed with the
.request ec
@@ -683,20 +630,20 @@ A printed version of the escape character is the
escape; a backslash glyph can be obtained by
.esc (rs .
.TP
-.character (
+\&\f[CB](\f[]
The open parenthesis is only special in escape sequences when
introducing an escape name or argument consisting of exactly two
characters.
.
In groff, this behavior can be replaced by the \f[CB][]\f[] construct.
.TP
-.character [
+\&\f[CB][\f[]
The opening bracket is only special in groff escape sequences; there
it is used to introduce a long escape name or long escape argument.
.
Otherwise, it is non-special, e.g.\& in macro calls.
.TP
-.character ]
+\&\f[CB]]\f[]
The closing bracket is only special in groff escape sequences; there
it terminates a long escape name or long escape argument.
.
@@ -891,21 +838,21 @@ added the following operators for numerical expressions:
.RS
.
.TPx
-.ExecFF Text I CB e1 >? e2
+\f[I]e1\f[CB]>?\f[I]e2\f[R]
The maximum of
.I e1
and
.IR e2 .
.
.TPx
-.ExecFF Text I CB e1 <? e2
+\f[I]e1\f[CB]<?\f[I]e2\f[R]
The minimum of
.I e1
and
.IR e2 .
.
.TPx
-.ExecFF Text CB I ( c ; e )
+\f[CB](\f[I]c\f[CB];\f[I]e\f[CB])\f[R]
Evaluate
.I e
using
@@ -1925,7 +1872,7 @@ Emit
directly to intermediate output, allowing leading whitespace if
.I string
starts with
-.character \[dq]
+\&\f[CB]\[dq]\f[]
(which is stripped off).
.
.REQ .pc
@@ -2226,7 +2173,7 @@ on terminal (UNIX standard message output), allowing leading
whitespace if
.I anything
starts with
-.character \[dq]
+\&\f[CB]\[dq]\f[]
(which is stripped off).
.
.REQ .tmc anything
@@ -2434,11 +2381,13 @@ request).
.
.\" --------- comments ---------
.
+.TP
.ESC \[dq]
Beginning of a comment.
.
Everything up to the end of the line is ignored.
.
+.TP
.ESC #
Everything up to and including the next newline is ignored.
.
@@ -2450,14 +2399,17 @@ except that the terminating newline is ignored as well.
.
.\" --------- strings ---------
.
+.TP
.ESC *\f[I]s\f[]
The string stored in the string variable with 1-character name
.IR s .
.
+.TP
.ESC *(\f[I]st\f[]
The string stored in the string variable with 2-character name
.IR st .
.
+.TP
.ESC[] * "stringvar arg1 arg2 .\|.\|."
The string stored in the string variable with arbitrary length name
.IR stringvar ,
@@ -2469,6 +2421,7 @@ as arguments.
.
.\" --------- macro arguments ---------
.
+.TP
.ESC $0
The name by which the current macro was invoked.
.
@@ -2476,6 +2429,7 @@ The
.request als
request can make a macro have more than one name.
.
+.TP
.ESC $ x
Macro or string argument with 1-place number
.IR x ,
@@ -2483,10 +2437,12 @@ where
.I x
is a digit between 1 and 9.
.
+.TP
.ESC $( xy
Macro or string argument with 2-digit number
.IR xy .
.
+.TP
.ESC[] $ nexp
Macro or string argument with number
.IR nexp ,
@@ -2494,14 +2450,17 @@ where
.I nexp
is a numerical expression evaluating to an integer \[>=]1.
.
+.TP
.ESC $*
In a macro or string, the concatenation of all the arguments separated
by spaces.
.
+.TP
.ESC $@
In a macro or string, the concatenation of all the arguments with each
surrounded by double quotes, and separated by spaces.
.
+.TP
.ESC $^
In a macro, the representation of all parameters as if they were an
argument to the
@@ -2510,6 +2469,7 @@ request.
.
.\" --------- escaped characters ---------
.
+.TP
.ESC \[rs]
reduces to a single backslash; useful to delay its interpretation as
escape character in copy mode.
@@ -2520,28 +2480,35 @@ or even better
.esc [rs] ,
to be independent from the current escape character.
.
+.TP
.ESC \[cq]
The acute accent \[aa]; same as
.esc (aa .
Unescaped: apostrophe, right quotation mark, single quote (ASCII 0x27).
.
+.TP
.ESC `
The grave accent \[ga]; same as
.esc (ga .
Unescaped: left quote, backquote (ASCII 0x60).
.
+.TP
.ESC \-
The \- sign in the current font.
.
+.TP
.ESC .
An uninterpreted dot (period), even at start of line.
.
+.TP
.ESC %
Default optional hyphenation character.
.
+.TP
.ESC !
Transparent line indicator.
.
+.TP
.ESC? anything
In a diversion, this transparently embeds
.I anything
@@ -2557,21 +2524,27 @@ and
.
.\" --------- spacing ---------
.
+.TP
.ESC \& space
Unpaddable space-size space character (no line break).
.
+.TP
.ESC 0
Digit width.
.
+.TP
.ESC |
1/6\ em narrow space character; zero width in nroff.
.
+.TP
.ESC ^
1/12\ em half-narrow space character; zero width in nroff.
.
+.TP
.ESC &
Non-printable, zero width character.
.
+.TP
.ESC )
Like
.esc &
@@ -2579,48 +2552,58 @@ except that it behaves like a character declared with the cflags
request to be transparent for the purposes of end of sentence
recognition.
.
+.TP
.ESC /
Increases the width of the preceding character so that the spacing
between that character and the following character is correct if
the following character is a roman character.
.
+.TP
.ESC ,
Modifies the spacing of the following character so that the spacing
between that character and the preceding character is correct if the
preceding character is a roman character.
.
+.TP
.ESC ~
Unbreakable space that stretches like a normal inter-word space when a
line is adjusted.
.
+.TP
.ESC :
Inserts a zero-width break point (similar to
.esc %
but without a soft hyphen character).
.
+.TP
.ESC "" newline
Ignored newline, for continuation lines.
.
.\" --------- structuring ---------
.
+.TP
.ESC {
Begin conditional input.
.
+.TP
.ESC }
End conditional input.
.
.\" --------- longer escape names ---------
.
+.TP
.ESC ( sc
The special character with 2-character name
.IR sc ,
see section
.BR "Special Characters" .
.
+.TP
.ESC[] "" name
The named character (or rather glyph) with arbitrary length name
.IR name .
.
+.TP
.ESC[] "" "comp1 comp2 .\|.\|."
A composite glyph with components
.IR comp1 ,
@@ -2629,27 +2612,33 @@ A composite glyph with components
.
.\" --------- alphabetical escapes ---------
.
+.TP
.ESC a
Non-interpreted leader character.
.
+.TP
.ESCq A anything
If
.I anything
is acceptable as a name of a string, macro, diversion, register,
environment or font it expands to\~1, and to\~0 otherwise.
.
+.TP
.ESCq b abc.\|.\|.\&
Bracket building function.
.
+.TP
.ESCq B anything
If
.I anything
is acceptable as a valid numeric expression it expands to\~1, and
to\~0 otherwise.
.
+.TP
.ESC c
Interrupt text processing.
.
+.TP
.ESCq C char
The character called
.IR char ;
@@ -2657,53 +2646,67 @@ same as
.esc[] "" char ,
but compatible to other roff versions.
.
+.TP
.ESC d
Forward (down) 1/2 em vertical unit (1/2 line in nroff).
.
+.TP
.ESCq D charseq
Draw a graphical element defined by the characters in
.IR charseq ;
see groff info file for details.
.
+.TP
.ESC e
Printable version of the current escape character.
.
+.TP
.ESC E
Equivalent to an escape character, but is not interpreted in copy-mode.
.
+.TP
.ESC f F
Change to font with 1-character name or 1-digit number
.IR F .
.
+.TP
.ESC fP
Switch back to previous font.
.
+.TP
.ESC f( fo
Change to font with 2-character name or 2-digit number
.IR fo .
.
+.TP
.ESC[] f font
Change to font with arbitrary length name or number expression
.IR font .
.
+.TP
.ESC[] f ""
Switch back to previous font.
.
+.TP
.ESC F f
Change to font family with 1-character name
.IR f .
.
+.TP
.ESC F( fm
Change to font family with 2-character name
.IR fm .
.
+.TP
.ESC[] F fam
Change to font family with arbitrary length name
.IR fam .
.
+.TP
.ESC[] F ""
Switch back to previous font family.
.
+.TP
.ESC[] g reg
Return format of register with name
.I reg
@@ -2715,15 +2718,18 @@ Alternative forms
and
.escarg g x .
.
+.TP
.ESCq h N
Local horizontal motion; move right
.I N
(left if negative).
.
+.TP
.ESCq H N
Set height of current font to
.IR N .
.
+.TP
.ESC[] k reg
Mark horizontal input place in register with arbitrary length name
.IR reg .
@@ -2732,14 +2738,17 @@ Alternative forms
and
.escarg k x .
.
+.TP
.ESCq l Nc
Horizontal line drawing function (optionally using character
.IR c ).
.
+.TP
.ESCq L Nc
Vertical line drawing function (optionally using character
.IR c ).
.
+.TP
.ESC[] m color
Change to color
.IR color .
@@ -2749,9 +2758,11 @@ Alternative forms
and
.escarg m c .
.
+.TP
.ESC[] m ""
Switch back to previous color.
.
+.TP
.ESC[] M color
Change filling color for closed drawn objects to color
.IR color .
@@ -2761,24 +2772,29 @@ Alternative forms
and
.escarg M c .
.
+.TP
.ESC[] M ""
Switch to previous fill color.
.
+.TP
.ESC n r
The numerical value stored in the register variable with the
1-character name
.IR r .
.
+.TP
.ESC n( re
The numerical value stored in the register variable with the
2-character name
.IR re .
.
+.TP
.ESC[] n reg
The numerical value stored in the register variable with arbitrary
length name
.IR reg .
.
+.TP
.ESCq N n
Typeset the character with code
.I n
@@ -2788,6 +2804,7 @@ Useful for adding characters to a font using the
.request char
request.
.
+.TP
.ESCq o abc.\|.\|.\&
Overstrike characters
.IR a ,
@@ -2795,28 +2812,34 @@ Overstrike characters
.IR c ,
etc.
.
+.TP
.ESC O 0
Disable glyph output.
.
Mainly for internal use.
.
+.TP
.ESC O 1
Enable glyph output.
.
Mainly for internal use.
.
+.TP
.ESC p
Break and spread output line.
.
+.TP
.ESC r
Reverse 1\ em vertical motion (reverse line in nroff).
.
+.TP
.ESCq R "name\~\[+-]n"
The same as
.request .nr
.I name
.IR \[+-]n .
.
+.TP
.ESC[] s \[+-]N
Set the point size to
.I N
@@ -2838,22 +2861,27 @@ Same as
.request ps
request.
.
+.TP
.ESCq S N
Slant output
.I N
degrees.
.
+.TP
.ESC t
Non-interpreted horizontal tab.
.
+.TP
.ESC u
Reverse (up) 1/2 em vertical motion (1/2 line in nroff).
.
+.TP
.ESCq v N
Local vertical motion; move down
.I N
(up if negative).
.
+.TP
.ESC[] V env
The contents of the environment variable
.IR env .
@@ -2863,18 +2891,22 @@ Alternative forms
and
.escarg V x .
.
+.TP
.ESCq w string
The width of the character sequence
.IR string .
.
+.TP
.ESCq x N
Extra line-space function (negative before, positive after).
.
+.TP
.ESCq X string
Output
.I string
as device control function.
.
+.TP
.ESC[] Y name
Output string variable or macro
.I name
@@ -2885,11 +2917,13 @@ Alternative forms
and
.escarg Y x .
.
+.TP
.ESC z c
Print
.I c
with zero width (without spacing).
.
+.TP
.ESCq Z anything
Print
.I anything
@@ -2949,44 +2983,64 @@ list can be found in
.P
.PD 0
.
+.TP
.ESC (bu
Bullet sign
+.TP
.ESC (co
Copyright
+.TP
.ESC (ct
Cent
+.TP
.ESC (dd
Double dagger
+.TP
.ESC (de
Degree
+.TP
.ESC (dg
Dagger
+.TP
.ESC (rq
Printable double quote
+.TP
.ESC (em
Em-dash
+.TP
.ESC (hy
Hyphen
+.TP
.ESC (rg
Registered sign
+.TP
.ESC (rs
Printable backslash character
+.TP
.ESC (sc
Section sign
+.TP
.ESC (ul
Underline character
+.TP
.ESC (==
Identical
+.TP
.ESC (>=
Larger or equal
+.TP
.ESC (<=
Less or equal
+.TP
.ESC (!=
Not equal
+.TP
.ESC (->
Right arrow
+.TP
.ESC (<-
Left arrow
+.TP
.ESC (+-
Plus-minus sign
.PD
@@ -3012,6 +3066,7 @@ leads to unpredictable results.
.
The following strings are predefined in groff.
.
+.TP 10n
.STRING .T
The name of the current output device as specified by the
.option -T
@@ -3066,13 +3121,16 @@ results from request calls.
.P
.PD 0
.
+.TP 10n
.REG .$
Number of arguments in the current macro or string.
.
+.TP 10n
.REG .a
Post-line extra line-space most recently utilized using
.escq x N .
.
+.TP 10n
.REG .A
Set to\~1 in
.B troff
@@ -3081,143 +3139,180 @@ if option
is used; always\~1 in
.BR nroff .
.
+.TP 10n
.REG .br
Within a macro, set to\~1 if macro called with the `normal' control
character, and to\~0 otherwise.
.
+.TP 10n
.REG .c
Current input line number.
.
+.TP 10n
.REG .C
1\~if compatibility mode is in effect, 0\~otherwise.
.
+.TP 10n
.REG .cdp
The depth of the last character added to the current environment.
It is positive if the character extends below the baseline.
.
+.TP 10n
.REG .ce
The number of lines remaining to be centered, as set by the
.request ce
request.
.
+.TP 10n
.REG .cht
The height of the last character added to the current environment.
It is positive if the character extends above the baseline.
.
+.TP 10n
.REG .color
1\~if colors are enabled, 0\~otherwise.
.
+.TP 10n
.REG .csk
The skew of the last character added to the current environment.
The skew of a character is how far to the right of the center of a character
the center of an accent over that character should be placed.
.
+.TP 10n
.REG .d
Current vertical place in current diversion; equal to
.register nl .
.
+.TP 10n
.REG .ev
The name or number of the current environment (string-valued).
.
+.TP 10n
.REG .f
Current font number.
.
+.TP 10n
.REG .fam
The current font family (string-valued).
.
+.TP 10n
.REG .fn
The current (internal) real font name (string-valued).
.
+.TP 10n
.REG .fp
The number of the next free font position.
.
+.TP 10n
.REG .g
Always 1 in GNU troff.
.
Macros should use it to test if running under groff.
.
+.TP 10n
.REG .h
Text base-line high-water mark on current page or diversion.
.
+.TP 10n
.REG .H
Available horizontal resolution in basic units.
.
+.TP 10n
.REG .height
The current font height as set with
.request \[rs]H .
.
+.TP 10n
.REG .hla
The current hyphenation language as set by the
.B .hla
request.
.
+.TP 10n
.REG .hlc
The number of immediately preceding consecutive hyphenated lines.
.
+.TP 10n
.REG .hlm
The maximum allowed number of consecutive hyphenated lines, as set by
the
.request hlm
request.
.
+.TP 10n
.REG .hy
The current hyphenation flags (as set by the
.request hy
request).
.
+.TP 10n
.REG .hym
The current hyphenation margin (as set by the
.request hym
request).
.
+.TP 10n
.REG .hys
The current hyphenation space (as set by the
.request hys
request).
.
+.TP 10n
.REG .i
Current ident.
.
+.TP 10n
.REG .in
The indent that applies to the current output line.
.
+.TP 10n
.REG .int
Positive if last output line contains
.esc c .
.
+.TP 10n
.REG .kern
1\~if pairwise kerning is enabled, 0\~otherwise.
.
+.TP 10n
.REG .l
Current line length.
.
+.TP 10n
.REG .lg
The current ligature mode (as set by the
.request lg
request).
.
+.TP 10n
.REG .linetabs
The current line-tabs mode (as set by the
.request linetabs
request).
.
+.TP 10n
.REG .ll
The line length that applies to the current output line.
.
+.TP 10n
.REG .lt
The title length (as set by the
.request lt
request).
.
+.TP 10n
.REG .m
The current drawing color (string-valued).
.
+.TP 10n
.REG .M
The current background color (string-valued).
.
+.TP 10n
.REG .n
Length of text portion on previous output line.
.
+.TP 10n
.REG .ne
The amount of space that was needed in the last
.request ne
@@ -3226,74 +3321,93 @@ request that caused a trap to be sprung.
Useful in conjunction with
.register .trunc .
.
+.TP 10n
.REG .ns
1\~if in no-space mode, 0\~otherwise.
.
+.TP 10n
.REG .o
Current page offset.
.
+.TP 10n
.REG .p
Current page length.
.
+.TP 10n
.REG .pe
1\~during page ejection, 0\~otherwise.
.
+.TP 10n
.REG .pn
The number of the next page: either the value set by a
.request pn
request, or the number of the current page plus\ 1.
.
+.TP 10n
.REG .ps
The current pointsize in scaled points.
.
+.TP 10n
.REG .psr
The last-requested pointsize in scaled points.
.
+.TP 10n
.REG .pvs
The current post-vertical line spacing.
.
+.TP 10n
.REG .rj
The number of lines to be right-justified as set by the rj request.
.
+.TP 10n
.REG .s
Current point size as a decimal fraction.
.
+.TP 10n
.REG .slant
The slant of the current font as set with
.request \[rs]S .
.
+.TP 10n
.REG .sr
The last requested pointsize in points as a decimal fraction
(string-valued).
.
+.TP 10n
.REG .ss
The value of the parameters set by the first argument of the
.request ss
request.
.
+.TP 10n
.REG .sss
The value of the parameters set by the second argument of the
.request ss
request.
.
+.TP 10n
.REG .sty
The current font style (string-valued).
.
+.TP 10n
.REG .t
Distance to the next trap.
.
+.TP 10n
.REG .T
Set to\~1
if option
.B \-T
is used.
.
+.TP 10n
.REG .tabs
A string representation of the current tab settings suitable for use
as an argument to the
.request ta
request.
.
+.TP 10n
.REG .trunc
The amount of vertical space truncated by the most recently sprung
vertical position trap, or, if the trap was sprung by a
@@ -3308,40 +3422,52 @@ the trap, and what the vertical position actually is.
Useful in conjunction with the
.register .ne .
.
+.TP 10n
.REG .u
Equal to 1 in fill mode and 0 in nofill mode.
.
+.TP 10n
.REG .U
Equal to 1 in safer mode and 0 in unsafe mode.
.
+.TP 10n
.REG .v
Current vertical line spacing.
.
+.TP 10n
.REG .V
Available vertical resolution in basic units.
.
+.TP 10n
.REG .vpt
1\~if vertical position traps are enabled, 0\~otherwise.
.
+.TP 10n
.REG .w
Width of previous character.
.
+.TP 10n
.REG .warn
The sum of the number codes of the currently enabled warnings.
.
+.TP 10n
.REG .x
The major version number.
.
+.TP 10n
.REG .y
The minor version number.
.
+.TP 10n
.REG .Y
The revision number of groff.
.
+.TP 10n
.REG .z
Name of current diversion.
.PD
.
+.TP 10n
.REG .zoom
Zoom factor for current font (in multiples of 1/1000th; zero if no
magnification).
@@ -3357,100 +3483,124 @@ customizing a document.
.
.P
.PD 0
+.TP 10n
.REG %
Current page number.
.
+.TP 10n
.REG c.
Current input line number.
.
+.TP 10n
.REG ct
Character type (set by width function
.esc w ).
.
+.TP 10n
.REG dl
Maximal width of last completed diversion.
.
+.TP 10n
.REG dn
Height of last completed diversion.
.
+.TP 10n
.REG dw
Current day of week (1-7).
.
+.TP 10n
.REG dy
Current day of month (1-31).
.
+.TP 10n
.REG hours
The number of hours past midnight.
.
Initialized at start-up.
.
+.TP 10n
.REG hp
Current horizontal position at input line.
.
+.TP 10n
.REG llx
Lower left x-coordinate (in PostScript units) of a given PostScript
image (set by
.request .psbb ).
.
+.TP 10n
.REG lly
Lower left y-coordinate (in PostScript units) of a given PostScript
image (set by
.request .psbb ).
.
+.TP 10n
.REG ln
Output line number.
.
+.TP 10n
.REG minutes
The number of minutes after the hour.
.
Initialized at start-up.
.
+.TP 10n
.REG mo
Current month (1-12).
.
+.TP 10n
.REG nl
Vertical position of last printed text base-line.
.
+.TP 10n
.REG rsb
Like
.register sb ,
but takes account of the heights and depths of characters.
.
+.TP 10n
.REG rst
Like
.register st ,
but takes account of the heights and depths of characters.
.
+.TP 10n
.REG sb
Depth of string below base line (generated by width function
.esc w ).
.
+.TP 10n
.REG seconds
The number of seconds after the minute.
.
Initialized at start-up.
.
+.TP 10n
.REG skw
Right skip width from the center of the last character in the
.esc w
argument.
.
+.TP 10n
.REG slimit
If greater than 0, the maximum number of objects on the input stack.
.
If \[<=]0 there is no limit, i.e., recursion can continue until virtual
memory is exhausted.
.
+.TP 10n
.REG ssc
The amount of horizontal space (possibly negative) that should be
added to the last character before a subscript (generated by width
function
.esc w ).
.
+.TP 10n
.REG st
Height of string above base line (generated by width function
.esc w ).
.
+.TP 10n
.REG systat
The return value of the
.I system()
@@ -3458,19 +3608,23 @@ function executed by the last
.request sy
request.
.
+.TP 10n
.REG urx
Upper right x-coordinate (in PostScript units) of a given PostScript
image (set by
.request .psbb ).
.
+.TP 10n
.REG ury
Upper right y-coordinate (in PostScript units) of a given PostScript
image (set by
.request .psbb ).
.
+.TP 10n
.REG year
The current year (year 2000 compliant).
.
+.TP 10n
.REG yr
Current year minus 1900.
.