The following drawing shows the dimensions which gtroff uses for
placing a line of output onto the page. They are labeled with the
request which manipulates each dimension.
-->| in |<--
|<-----------ll------------>|
+----+----+----------------------+----+
| : : : |
+----+----+----------------------+----+
-->| po |<--
|<--------paper width---------------->|
These dimensions are:
poinllA simple demonstration:
.ll 3i
This is text without indentation.
The line length has been set to 3\~inch.
.in +.5i
.ll -.5i
Now the left and right margins are both increased.
.in
.ll
Calling .in and .ll without parameters restore
the previous values.
Result:
This is text without indenta-
tion. The line length has
been set to 3 inch.
Now the left and
right margins are
both increased.
Calling .in and .ll without
parameters restore the previ-
ous values.
Set horizontal page offset to offset (or increment or decrement the current value by offset). Note that this request does not cause a break, so changing the page offset in the middle of text being filled may not yield the expected result. The initial value is 1i. For TTY output devices, it is set to 0 in the startup file troffrc; the default scaling indicator is ‘m’ (and not ‘v’ as incorrectly documented in the original UNIX troff manual).
The current page offset can be found in the read-only number register ‘.o’.
If
pois called without an argument, the page offset is reset to the previous value before the last call topo..po 3i \n[.o] ⇒ 720 .po -1i \n[.o] ⇒ 480 .po \n[.o] ⇒ 720
Set indentation to indent (or increment or decrement the current value by indent). This request causes a break. Initially, there is no indentation.
If
inis called without an argument, the indentation is reset to the previous value before the last call toin. The default scaling indicator is ‘m’.The indentation is associated with the current environment (see Environments).
If a negative indentation value is specified (which is not allowed),
gtroffemits a warning of type ‘range’ and sets the indentation to zero.The effect of
inis delayed until a partially collected line (if it exists) is output. A temporary indentation value is reset to zero also.The current indentation (as set by
in) can be found in the read-only number register ‘.i’.
Temporarily indent the next output line by offset. If an increment or decrement value is specified, adjust the temporary indentation relative to the value set by the
inrequest.This request causes a break; its value is associated with the current environment (see Environments). The default scaling indicator is ‘m’. A call of
tiwithout an argument is ignored.If the total indentation value is negative (which is not allowed),
gtroffemits a warning of type ‘range’ and sets the temporary indentation to zero. `Total indentation' is either offset if specified as an absolute value, or the temporary plus normal indentation, if offset is given as a relative value.The effect of
tiis delayed until a partially collected line (if it exists) is output.The read-only number register
.inis the indentation that applies to the current output line.The difference between
.iand.inis that the latter takes into account whether a partially collected line still uses the old indentation value or a temporary indentation value is active.
Set the line length to length (or increment or decrement the current value by length). Initially, the line length is set to 6.5i. The effect of
llis delayed until a partially collected line (if it exists) is output. The default scaling indicator is ‘m’.If
llis called without an argument, the line length is reset to the previous value before the last call toll. If a negative line length is specified (which is not allowed),gtroffemits a warning of type ‘range’ and sets the line length to zero.The line length is associated with the current environment (see Environments).
The current line length (as set by
ll) can be found in the read-only number register ‘.l’. The read-only number register.llis the line length that applies to the current output line.Similar to
.iand.in, the difference between.land.llis that the latter takes into account whether a partially collected line still uses the old line length value.