Reformat in mandoc.
This commit is contained in:
parent
ff7e0ad3ae
commit
a2fa91a9c4
|
@ -1,4 +1,4 @@
|
|||
.\" $NetBSD: jot.1,v 1.2 1994/11/14 20:27:36 jtc Exp $
|
||||
.\" $NetBSD: jot.1,v 1.3 1997/11/01 04:58:39 mycroft Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
|
@ -33,165 +33,169 @@
|
|||
.\"
|
||||
.\" @(#)jot.1 8.1 (Berkeley) 6/6/93
|
||||
.\"
|
||||
.TH JOT 1 "June 6, 1993"
|
||||
.UC 4
|
||||
.SH NAME
|
||||
jot \- print sequential or random data
|
||||
.SH SYNOPSIS
|
||||
.B jot [
|
||||
options
|
||||
.B ] [
|
||||
\fRreps \fB[\fP begin \fB[\fP end \fB[\fP s \fB] ] ] ]\fP
|
||||
.SH DESCRIPTION
|
||||
.I Jot
|
||||
is used to print out increasing, decreasing, random,
|
||||
or redundant data, usually numbers, one per line.
|
||||
.Dd November 1, 1997
|
||||
.Dt JOT 1
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm jot
|
||||
.Nd print sequential or random data
|
||||
.Sh SYNOPSIS
|
||||
.Nm jot
|
||||
.Op Fl rcn
|
||||
.Op Fl b Ar word
|
||||
.Op Fl w Ar word
|
||||
.Op Fl s Ar string
|
||||
.Op Fl p Ar precision
|
||||
.Oo Ar reps
|
||||
.Oo Ar begin
|
||||
.Oo Ar end
|
||||
.Op Ar s
|
||||
.Oc
|
||||
.Oc
|
||||
.Oc
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.I options
|
||||
are understood as follows.
|
||||
.IP \fB\-r\fP
|
||||
.Nm jot
|
||||
utility is used to print out increasing, decreasing, random,
|
||||
or redundant data (usually numbers) one per line.
|
||||
.Pp
|
||||
The following options are available:
|
||||
.Bl -tag -width indent
|
||||
.It Fl r
|
||||
Generate random data instead of sequential data, the default.
|
||||
.IP \fB\-b\fP\ word
|
||||
.It Fl b Ar word
|
||||
Just print
|
||||
.I word
|
||||
.Ar word
|
||||
repetitively.
|
||||
.IP \fB\-w\fP\ word
|
||||
.It Fl w Ar word
|
||||
Print
|
||||
.IR word
|
||||
.Ar word
|
||||
with the generated data appended to it.
|
||||
Octal, hexadecimal, exponential, ASCII, zero padded,
|
||||
and right-adjusted representations
|
||||
are possible by using the appropriate
|
||||
.IR printf (3)
|
||||
.Xr printf 3
|
||||
conversion specification inside
|
||||
.IR word ,
|
||||
.Ar word ,
|
||||
in which case the data are inserted rather than appended.
|
||||
.IP \fB\-c\fP
|
||||
.It Fl c
|
||||
This is an abbreviation for \fB\-w %c\fP.
|
||||
.IP \fB\-s\fP\ string
|
||||
.It Fl s Ar string
|
||||
Print data separated by
|
||||
.IR string .
|
||||
.Ar string .
|
||||
Normally, newlines separate data.
|
||||
.IP \fB\-n\fP
|
||||
.It Fl n
|
||||
Do not print the final newline normally appended to the output.
|
||||
.IP \fB\-p\fP\ precision
|
||||
.It Fl p Ar precision
|
||||
Print only as many digits or characters of the data
|
||||
as indicated by the integer
|
||||
.IR precision .
|
||||
.Ar precision .
|
||||
In the absence of
|
||||
.BR \-p ,
|
||||
.Fl p ,
|
||||
the precision is the greater of the precisions of
|
||||
.I begin
|
||||
.Ar begin
|
||||
and
|
||||
.IR end .
|
||||
.Ar end .
|
||||
The
|
||||
.B \-p
|
||||
.Fl p
|
||||
option is overridden by whatever appears in a
|
||||
.IR printf (3)
|
||||
.Xr printf 3
|
||||
conversion following
|
||||
.BR \-w .
|
||||
.PP
|
||||
.Fl w .
|
||||
.El
|
||||
.Pp
|
||||
The last four arguments indicate, respectively,
|
||||
the number of data, the lower bound, the upper bound,
|
||||
and the step size or, for random data, the seed.
|
||||
While at least one of them must appear,
|
||||
any of the other three may be omitted, and
|
||||
will be considered as such if given as
|
||||
.BR \- .
|
||||
.Dq - .
|
||||
Any three of these arguments determines the fourth.
|
||||
If four are specified and the given and computed values of
|
||||
.I reps
|
||||
.Ar reps
|
||||
conflict, the lower value is used.
|
||||
If fewer than three are specified, defaults are assigned
|
||||
left to right, except for
|
||||
.IR s ,
|
||||
.Ar s ,
|
||||
which assumes its default unless both
|
||||
.I begin
|
||||
.Ar begin
|
||||
and
|
||||
.I end
|
||||
.Ar end
|
||||
are given.
|
||||
.PP
|
||||
.Pp
|
||||
Defaults for the four arguments are, respectively,
|
||||
100, 1, 100, and 1, except that when random data are requested,
|
||||
.I s
|
||||
.Ar s
|
||||
defaults to a seed depending upon the time of day.
|
||||
.I Reps
|
||||
.Ar reps
|
||||
is expected to be an unsigned integer,
|
||||
and if given as zero is taken to be infinite.
|
||||
.I Begin
|
||||
.Ar begin
|
||||
and
|
||||
.I end
|
||||
.Ar end
|
||||
may be given as real numbers or as characters
|
||||
representing the corresponding value in ASCII.
|
||||
The last argument must be a real number.
|
||||
.PP
|
||||
.Pp
|
||||
Random numbers are obtained through
|
||||
.IR random (3).
|
||||
.Xr random 3 .
|
||||
The name
|
||||
.I jot
|
||||
.Nm jot
|
||||
derives in part from
|
||||
.IR iota ,
|
||||
.Nm iota ,
|
||||
a function in APL.
|
||||
.SH EXAMPLES
|
||||
.de IC
|
||||
.IP
|
||||
.ss 36
|
||||
.ft B
|
||||
..
|
||||
.de NC
|
||||
.br
|
||||
.ss 12
|
||||
.PP
|
||||
..
|
||||
.PP
|
||||
The command
|
||||
.IC
|
||||
jot 21 \-1 1.00
|
||||
.NC
|
||||
.Sh EXAMPLES
|
||||
The command:
|
||||
.Dl "jot 21 \-1 1.00"
|
||||
prints 21 evenly spaced numbers increasing from \-1 to 1.
|
||||
The ASCII character set is generated with
|
||||
.IC
|
||||
jot \-c 128 0
|
||||
.NC
|
||||
and the strings xaa through xaz with
|
||||
.IC
|
||||
jot \-w xa%c 26 a
|
||||
.NC
|
||||
while 20 random 8-letter strings are produced with
|
||||
.IC
|
||||
jot \-r \-c 160 a z | rs \-g 0 8
|
||||
.NC
|
||||
Infinitely many
|
||||
.IR yes 's
|
||||
may be obtained through
|
||||
.IC
|
||||
jot \-b yes 0
|
||||
.NC
|
||||
and thirty
|
||||
.IR ed (1)
|
||||
substitution commands applying to lines 2, 7, 12, etc. is
|
||||
the result of
|
||||
.IC
|
||||
jot \-w %ds/old/new/ 30 2 \- 5
|
||||
.NC
|
||||
The stuttering sequence 9, 9, 8, 8, 7, etc. can be
|
||||
produced by suitable choice of precision and step size,
|
||||
as in
|
||||
.IC
|
||||
jot 0 9 \- \-.5
|
||||
.NC
|
||||
and a file containing exactly 1024 bytes is created with
|
||||
.IC
|
||||
jot \-b x 512 > block
|
||||
.NC
|
||||
Finally, to set tabs four spaces apart starting
|
||||
from column 10 and ending in column 132, use
|
||||
.IC
|
||||
expand \-\`jot \-s, \- 10 132 4\`
|
||||
.NC
|
||||
and to print all lines 80 characters or longer,
|
||||
.IC
|
||||
grep \`jot \-s "" \-b . 80\`
|
||||
.NC
|
||||
.SH SEE ALSO
|
||||
ed(1), expand(1), rs(1), yes(1), printf(3), random(3), expand(1)
|
||||
.Pp
|
||||
The command:
|
||||
.Dl "jot \-c 128 0"
|
||||
prints the ASCII character set.
|
||||
.Pp
|
||||
The command:
|
||||
.Dl "jot \-w xa%c 26 a"
|
||||
prints the strings
|
||||
.Dq xaa
|
||||
through
|
||||
.Dq xaz .
|
||||
.Pp
|
||||
The command:
|
||||
.Dl "jot \-r \-c 160 a z | rs \-g 0 8"
|
||||
prints 20 random 8-letter strings.
|
||||
.Pp
|
||||
The command:
|
||||
.Dl "jot \-b y 0"
|
||||
is equivalent to
|
||||
.Xr yes 1 .
|
||||
.Pp
|
||||
The command:
|
||||
.Dl "jot \-w %ds/old/new/ 30 2 \- 5"
|
||||
prints thirty
|
||||
.Xr ed 1
|
||||
substitution commands applying to lines 2, 7, 12, etc.
|
||||
.Pp
|
||||
The command:
|
||||
.Dl "jot 0 9 \- \-.5"
|
||||
prints the stuttering sequence 9, 9, 8, 8, 7, etc.
|
||||
.Pp
|
||||
The command:
|
||||
.Dl "jot \-b x 512 > block"
|
||||
creates a file containing exactly 1024 bytes.
|
||||
.Pp
|
||||
The command:
|
||||
.Dl "expand \-\`jot \-s, \- 10 132 4\`"
|
||||
sets tabs four spaces apart starting
|
||||
from column 10 and ending in column 132.
|
||||
.Pp
|
||||
The command:
|
||||
.Dl "grep \`jot \-s """" \-b . 80\`"
|
||||
prints all lines 80 characters or longer.
|
||||
.Sh SEE ALSO
|
||||
.Xr ed 1 ,
|
||||
.Xr expand 1 ,
|
||||
.Xr rs 1 ,
|
||||
.Xr yes 1 ,
|
||||
.Xr printf 3 ,
|
||||
.Xr random 3
|
||||
|
|
Loading…
Reference in New Issue