plan9port/man/man1/seq.1
Russ Cox 977b25a76a tmac: introduce real manual reference macro instead of overloading IR
The overloading of IR emits magic \X'...' sequences that turn into HTML manual links.
But not all such IR invocations should be manual links;
those had to be written to avoid the IR macro before.
Worse, the \X'...' ending the IR causes troff to emit only a single space after a period.

Defining a new IM macro for manual references fixes both problems.

Fixes #441.
2020-08-13 23:43:43 -04:00

75 lines
1.1 KiB
Groff

.TH SEQ 1
.SH NAME
seq \- print sequences of numbers
.SH SYNOPSIS
.B seq
[
.B -w
]
[
.BI -f format
]
[
.I first
[
.I incr
]
]
.I last
.SH DESCRIPTION
.I Seq
prints a sequence of numbers, one per line, from
.I first
(default 1) to as near
.I last
as possible, in increments of
.I incr
(default 1).
The loop is:
.sp
.EX
for(val = min; val <= max; val += incr) print val;
.EE
.sp
The numbers are interpreted as floating point.
.PP
Normally integer values are printed as decimal integers.
The options are
.TP "\w'\fL-f \fIformat\fLXX'u"
.BI -f format
Use the
.IM print (3) -style
.I format
.IR print
for printing each (floating point) number.
The default is
.LR %g .
.TP
.B -w
Equalize the widths of all numbers by padding with
leading zeros as necessary.
Not effective with option
.BR -f ,
nor with numbers in exponential notation.
.SH EXAMPLES
.TP
.L
seq 0 .05 .1
Print
.BR "0 0.05 0.1"
(on separate lines).
.TP
.L
seq -w 0 .05 .1
Print
.BR "0.00 0.05 0.10" .
.SH SOURCE
.B \*9/src/cmd/seq.c
.SH BUGS
Option
.B -w
always surveys every value in advance.
Thus
.L
seq -w 1000000000
is a painful way to get an `infinite' sequence.