diff options
author | Mateusz Piotrowski <0mp@FreeBSD.org> | 2019-09-21 15:01:11 +0000 |
---|---|---|
committer | Mateusz Piotrowski <0mp@FreeBSD.org> | 2019-09-21 15:01:11 +0000 |
commit | a811237df2db8e1ccd19113e1da3f60dc34a8be3 (patch) | |
tree | 2f6c13869e10b3320cace0ef976b10c888ff70c7 /usr.bin/jot | |
parent | e100548404f355f626402efa6c5c5c56e674bdd8 (diff) | |
download | src-a811237df2db8e1ccd19113e1da3f60dc34a8be3.tar.gz src-a811237df2db8e1ccd19113e1da3f60dc34a8be3.zip |
jot.1: Explain default argument values more precisely
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
Notes
Notes:
svn path=/head/; revision=352578
Diffstat (limited to 'usr.bin/jot')
-rw-r--r-- | usr.bin/jot/jot.1 | 12 |
1 files changed, 7 insertions, 5 deletions
diff --git a/usr.bin/jot/jot.1 b/usr.bin/jot/jot.1 index d2e38c79aa45..5ba57d9117ad 100644 --- a/usr.bin/jot/jot.1 +++ b/usr.bin/jot/jot.1 @@ -28,7 +28,7 @@ .\" @(#)jot.1 8.1 (Berkeley) 6/6/93 .\" $FreeBSD$ .\" -.Dd April 7, 2015 +.Dd September 21, 2019 .Dt JOT 1 .Os .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 .Ar reps conflict, the lower value is used. -If fewer than three are specified, defaults are assigned -left to right, except for +If one or two are specified, defaults are assigned +starting with .Ar s , -which assumes a default of 1 or -1 if both +which assumes a default of 1 (or -1 if .Ar begin and .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 Defaults for the four arguments are, respectively, 100, 1, 100, and 1, except that when random data are requested, |