d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

jot.1: Explain default argument values more precisely

Browse Source 
The way jot(1) defaults missing arguments doesn't match the behaviour
described in the manpage, which states that with fewer than 3 arguments
missing values are supplied from left to right.

In fact, with one or two arguments, the last (s which is step size or seed)
defaults to 1 (or -1 if begin and end specify a descending range), and then
omitted arguments are set to default starting with the leftmost until three
arguments are available.

This is why `jot 2 1000` prints 1000 and 1001 instead of 1000 and 100.

PR:		135475
Submitted by:	Jonathan McKeown <j.mckeown@ru.ac.za>
Approved by:	doc (bcr)
Differential Revision:	https://reviews.freebsd.org/D21736
Event:		EuroBSDcon 2019
This commit is contained in:
0mp 2019-09-21 15:01:11 +00:00
parent e5ff66aabc
commit df31a59323
1 changed files with 7 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
usr.bin/jot/jot.1
View File

@ -28,7 +28,7 @@
.\" @(#)jot.1 8.1 (Berkeley) 6/6/93 .\" @(#)jot.1 8.1 (Berkeley) 6/6/93
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd April 7, 2015 .Dd September 21, 2019
.Dt JOT 1 .Dt JOT 1
.Os .Os
.Sh NAME .Sh NAME
@ -108,14 +108,16 @@ Any three of these arguments determines the fourth.
If four are specified and the given and computed values of If four are specified and the given and computed values of
.Ar reps .Ar reps
conflict, the lower value is used. conflict, the lower value is used.
If fewer than three are specified, defaults are assigned If one or two are specified, defaults are assigned
left to right, except for starting with
.Ar s , .Ar s ,
which assumes a default of 1 or -1 if both which assumes a default of 1 (or -1 if
.Ar begin .Ar begin
and and
.Ar end .Ar end
are given. specify a descending range).
Then the default values are assigned to the leftmost omitted arguments until
three arguments are set.
.Pp .Pp
Defaults for the four arguments are, respectively, Defaults for the four arguments are, respectively,
100, 1, 100, and 1, except that when random data are requested, 100, 1, 100, and 1, except that when random data are requested,