@ page 226 line 8736 section cd comment {bjh21:cd -LP}
Problem:
The SYNOPSIS for cd says:
cd [-L] [-P] [directory]
but -L and -P are mutually exclusive (albeit with defined priorities, but
that's allowed by rule 8 of section 12.1 of XBD). They should be marked
as such. This is necessary to satisfy Guideline 11 of the Utility Syntax
Guidelines.
Action:
Replace the SYNOPSIS for cd with:
cd [-L|-P] [directory]
@ page 79 line 3061 section export comment {bjh21:export =word}
Problem:
The SYNOPSIS for export includes:
export name[=word]...
but the meaning of the optional "=word" is never explained in the text.
The same problem exists with readonly.
Action:
Here and at
page 81 line 3135 section readonly comment
add to the end of the first paragraph of the description:
If the name of a variable is followed by =word, the value of that
variable shall be set to word.
@ page 90 line 2467 section trap editorial {bjh21:trap rationale}
Problem:
The square brackets are in the typeface used for literal text, but they're
intended as metacharacters to indicate optional arguments
Action:
Change the square brackets to be in the typeface used for "Optional Items
in Utility Syntax".
@ page 134 line 5023,5028 section ar comment {bjh21:ar -abi}
Problem:
In the SYNOPSIS for ar, the -a, -b and -i options and the posnmame operand
are shown as being independent. The text describing them, at lines 5057,
5058, 5065-5066 and 5116-5117, though, indictes that the options are
mutually exclusive (since a new member of the archive can't be placed
both before and after the same existing member) and that posname is
required if any of these options is specified. Since the syntax of the ar
command is otherwise ambiguous, I think it's also reasonable to state that
the posname operand is forbidden if none of these options is provided.
I believe the only way to accurately express the correct syntax is by
introducing two new synopses.
Action:
Replace line 5023 with:
ar -m [-v] archive file ...
ar -m -a|-b|-i [-v] posname archive file ...
Both of these lines should be XSI shaded.
Replace line 5028 with:
ar -r [-cuv] archive file ...
ar -r -a|-b|-i [-cuv] posname archive file ...
The second of these lines should be XSI shaded.
@ page 432 line 16698 section false editorial {bjh21:false stderr}
Problem:
The STDERR section contains "None.", but section 1.11 (Utility
Description Defaults, p 24, ll 979-998) doesn't provide a meaning for
this.
Action:
Replace "None." with "Not used."
@ page 929 line 35818 section true editorial {bjh21:false stderr}
Problem:
The STDERR section contains "None.", but section 1.11 (Utility
Description Defaults, p 24, ll 979-998) doesn't provide a meaning for
this.
Action:
Replace "None." with "Not used."
@ page 929 line 35824 section true editorial {bjh21:false stderr}
Problem:
The exit status of true is listed as "Default.", but section 1.11 (Utility
Description Defaults, p 25, ll 1037-1052) doesn't provide a meaning for
this.
Action:
Replace "Default." with "Zero."
|