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