xref: /dragonfly/usr.bin/seq/seq.1 (revision 36a3d1d6) 
1.\"
2.\" Copyright (c) 2005 The DragonFly Project.  All rights reserved.
3.\"
4.\" This code is derived from software contributed to The DragonFly Project
5.\" by Brian Ginsbach.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. Neither the name of The DragonFly Project nor the names of its
16.\"    contributors may be used to endorse or promote products derived
17.\"    from this software without specific prior written permission.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
22.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
23.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
24.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
25.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
26.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
27.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
28.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
29.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" $DragonFly: src/usr.bin/seq/seq.1,v 1.4 2007/05/17 08:19:02 swildner Exp $
33.\"
34.Dd January 17, 2005
35.Dt SEQ 1
36.Os
37.Sh NAME
38.Nm seq
39.Nd print sequences of numbers
40.Sh SYNOPSIS
41.Nm
42.Op Fl f Ar format
43.Op Fl s Ar string
44.Op Fl t Ar string
45.Op Fl w
46.Op Ar first Op Ar incr
47.Ar last
48.Sh DESCRIPTION
49The
50.Nm
51utility prints a sequence of numbers, one per line
52.Pq default ,
53from
54.Ar first
55.Pq default 1 ,
56to near
57.Ar last
58as possible, in increments of
59.Ar incr
60.Pq default 1 .
61When
62.Ar first
63is larger than
64.Ar last
65the default
66.Ar incr
67is -1.
68.Pp
69All numbers are interpreted as floating point.
70.Pp
71Normally integer values are printed as decimal integers.
72.Pp
73The
74.Nm
75utility accepts the following options:
76.Bl -tag -width Ar
77.It Fl f Ar format
78Use a
79.Xr printf 3
80style
81.Ar format
82to print each number.  Only the
83.Cm e ,
84.Cm E ,
85.Cm f ,
86.Cm g ,
87.Cm G ,
88and
89.Cm %
90conversion characters are valid, along with any optional
91flags and an optional numeric minimum field width or precision.
92The
93.Ar format
94can contain character escape sequences in backslash notation as
95defined in
96.St -ansiC .
97The default is
98.Cm %g .
99.It Fl s Ar string
100Use
101.Ar string
102to separate numbers.
103The
104.Ar string
105can contain character escape sequences in backslash notation as
106defined in
107.St -ansiC .
108The default is
109.Cm \en .
110.It Fl t Ar string
111Use
112.Ar string
113to terminate sequence of numbers.
114The
115.Ar string
116can contain character escape sequences in backslash notation as
117defined in
118.St -ansiC .
119This option is useful when the default separator
120does not contain a
121.Cm \en .
122.It Fl w
123Equalize the widths of all numbers by padding with zeros as necessary.
124This option has no effect with the
125.Fl f
126option.
127If any sequence numbers will be printed in exponential notation,
128the default conversion is changed to
129.Cm %e .
130.El
131.Pp
132The
133.Nm
134utility exits 0 on success and non-zero if an error occurs.
135.Sh EXAMPLES
136.Bd -literal -offset indent
137seq 1 3
1381
1392
1403
141
142seq 3 1
1433
1442
1451
146
147seq -w 0 .05 .1
1480.00
1490.05
1500.10
151.Ed
152.Sh SEE ALSO
153.Xr jot 1 ,
154.Xr printf 1 ,
155.Xr printf 3
156.Sh HISTORY
157The
158.Nm
159command first appeared in
160.Tn "Plan 9 from Bell Labs" .
161A
162.Nm
163command appeared in
164.Nx 3.0 .
165This command was based on the command of the same name in
166.Tn "Plan 9 from Bell Labs"
167and the
168.Tn GNU
169core utilities.
170The
171.Tn GNU
172.Nm
173command first appeared in the 1.13 shell utilities release.
174.Sh BUGS
175The
176.Fl w
177option does not handle the transition from pure floating point
178to exponent representation very well.
179The
180.Nm
181command is not bug for bug compatible with the
182.Tn "Plan 9 from Bell Labs"
183or
184.Tn GNU
185versions of
186.Nm .
187