usr.bin/jot/jot.1

   1 .\" Copyright (c) 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)jot.1       8.1 (Berkeley) 6/6/93
  33 .\" $FreeBSD$
  34 .\"
  35 .Dd June 6, 1993
  36 .Dt JOT 1
  37 .Os
  38 .Sh NAME
  39 .Nm jot
  40 .Nd print sequential or random data
  41 .Sh SYNOPSIS
  42 .Nm jot
  43 .Op Fl cnr
  44 .Op Fl b Ar word
  45 .Op Fl w Ar word
  46 .Op Fl s Ar string
  47 .Op Fl p Ar precision
  48 .Op reps Op begin Op end Op s
  49 .Sh DESCRIPTION
  50 .Nm Jot
  51 is used to print out increasing, decreasing, random,
  52 or redundant data, usually numbers, one per line.
  53 .Pp
  54 The following options are available:
  55 .Bl -tag -width indent
  56 .It Fl r
  57 Generate random data instead of the default sequential data.
  58 .It Fl b Ar word
  59 Just print
  60 .Ar word
  61 repetitively.
  62 .It Fl w Ar word
  63 Print
  64 .Ar word
  65 with the generated data appended to it.
  66 Octal, hexadecimal, exponential,
  67 .Tn ASCII ,
  68 zero padded,
  69 and right-adjusted representations
  70 are possible by using the appropriate
  71 .Xr printf 3
  72 conversion specification inside
  73 .Ar word ,
  74 in which case the data are inserted rather than appended.
  75 .It Fl c
  76 This is an abbreviation for
  77 .Fl w Ar %c .
  78 .It Fl s Ar string
  79 Print data separated by
  80 .Ar string .
  81 Normally, newlines separate data.
  82 .It Fl n
  83 Do not print the final newline normally appended to the output.
  84 .It Fl p Ar precision
  85 Print only as many digits or characters of the data
  86 as indicated by the integer
  87 .Ar precision .
  88 In the absence of
  89 .Fl p ,
  90 the precision is the greater of the precisions of
  91 .Ar begin
  92 and
  93 .Ar end .
  94 The
  95 .Fl p
  96 option is overridden by whatever appears in a
  97 .Xr printf 3
  98 conversion following
  99 .Fl w .
 100 .El
 101 .Pp
 102 The last four arguments indicate, respectively,
 103 the number of data, the lower bound, the upper bound,
 104 and the step size or, for random data, the seed.
 105 While at least one of them must appear,
 106 any of the other three may be omitted, and
 107 will be considered as such if given as
 108 .Fl "" .
 109 Any three of these arguments determines the fourth.
 110 If four are specified and the given and computed values of
 111 .Ar reps
 112 conflict, the lower value is used.
 113 If fewer than three are specified, defaults are assigned
 114 left to right, except for
 115 .Ar s ,
 116 which assumes its default unless both
 117 .Ar begin
 118 and
 119 .Ar end
 120 are given.
 121 .Pp
 122 Defaults for the four arguments are, respectively,
 123 100, 1, 100, and 1, except that when random data are requested,
 124 the seed,
 125 .Ar s ,
 126 is picked randomly.
 127 .Ar Reps
 128 is expected to be an unsigned integer,
 129 and if given as zero is taken to be infinite.
 130 .Ar Begin
 131 and
 132 .Ar end
 133 may be given as real numbers or as characters
 134 representing the corresponding value in
 135 .Tn ASCII .
 136 The last argument must be a real number.
 137 .Pp
 138 Random numbers are obtained through
 139 .Xr random 3 .
 140 The name
 141 .Nm
 142 derives in part from
 143 .Nm iota ,
 144 a function in APL.
 145 .Sh EXAMPLES
 146 The command
 147 .Dl jot 21 -1 1.00
 148 .Pp
 149 prints 21 evenly spaced numbers increasing from -1 to 1.
 150 The
 151 .Tn ASCII
 152 character set is generated with
 153 .Dl jot -c 128 0
 154 .Pp
 155 and the strings xaa through xaz with
 156 .Dl jot -w xa%c 26 a
 157 .Pp
 158 while 20 random 8-letter strings are produced with
 159 .Dl "jot -r -c 160 a z | rs -g 0 8"
 160 .Pp
 161 Infinitely many
 162 .Em yes Ns 's
 163 may be obtained through
 164 .Dl jot -b yes 0
 165 .Pp
 166 and thirty
 167 .Xr ed 1
 168 substitution commands applying to lines 2, 7, 12, etc. is
 169 the result of
 170 .Dl jot -w %ds/old/new/ 30 2 - 5
 171 .Pp
 172 The stuttering sequence 9, 9, 8, 8, 7, etc. can be
 173 produced by suitable choice of step size,
 174 as in
 175 .Dl jot - 9 0 -.5
 176 .Pp
 177 and a file containing exactly 1024 bytes is created with
 178 .Dl jot -b x 512 > block
 179 .Pp
 180 Finally, to set tabs four spaces apart starting
 181 from column 10 and ending in column 132, use
 182 .Dl expand -`jot -s, - 10 132 4`
 183 .Pp
 184 and to print all lines 80 characters or longer,
 185 .Dl grep `jot -s \&"\&" -b \&. 80`
 186 .Sh DIAGNOSTICS
 187 The
 188 .Nm
 189 utility exits 0 on success, and >0 if an error occurs.
 190 The following diagnostic messages deserve special explanation:
 191 .Bl -diag
 192 .It "illegal or unsupported format '%s'"
 193 The requested conversion format specifier for
 194 .Xr printf 3
 195 was not of the form
 196 .Dl %[#][ ][{+,-}][0-9]*[.[0-9]*]?
 197 where
 198 .Dq ?
 199 must be one of
 200 .Dl [l]{d,i,o,u,x}
 201 or
 202 .Dl {c,e,f,g,D,E,G,O,U,X}
 203 .It "range error in conversion"
 204 A value to be printed fell outside the range of the data type
 205 associated with the requested output format.
 206 .It "too many conversions"
 207 More than one conversion format specifier has been supplied,
 208 but only one is allowed.
 209 .El
 210 .Sh SEE ALSO
 211 .Xr ed 1 ,
 212 .Xr expand 1 ,
 213 .Xr rs 1 ,
 214 .Xr yes 1 ,
 215 .Xr printf 3 ,
 216 .Xr random 3