Martin Sebor
2014-08-12 17:39:31 UTC
The sentence in section 2.6.2 Parameter Expansion in the HTML
(and on page 2328, line 73947 in the PDF) is ever so slightly
inconsistently formatted, making one wonder about the intended
expansion in the example (which does become apparent after
a careful reading). The problem is in the sentence that reads:
(For example, ${foo-bar} xyz} would result in the expansion
of foo followed by the string xyz} if foo is set, else the
string "barxyz}").
In the HTML, the strings foo-bar, xyz, foo, and barxyz} are in
bold, while the rest of the text is in normal weight font. There
also is a space between ${ and foo-bar, and between ${foo-bar}
and xyz}.
In the PDF, the strings foo-bar, xyz and foo are also in bold,
but the string barxyz} is in monospace and normal weight. There
are no extra spaces.
In both the HTML and the PDF, only the string barxyz} is quoted.
I couldn't find the text that describes the notational conventions
used in the document but based on a quick review of a few examples
in the nearby text I would expect all the strings above to be in
monospace font, and both of the two possible results of the expansion,
namely "xyz}" and "barxyz}" to be quoted.
Is this worth opening an issue for or can it be left up to the
better judgment of the editor?
Martin
(and on page 2328, line 73947 in the PDF) is ever so slightly
inconsistently formatted, making one wonder about the intended
expansion in the example (which does become apparent after
a careful reading). The problem is in the sentence that reads:
(For example, ${foo-bar} xyz} would result in the expansion
of foo followed by the string xyz} if foo is set, else the
string "barxyz}").
In the HTML, the strings foo-bar, xyz, foo, and barxyz} are in
bold, while the rest of the text is in normal weight font. There
also is a space between ${ and foo-bar, and between ${foo-bar}
and xyz}.
In the PDF, the strings foo-bar, xyz and foo are also in bold,
but the string barxyz} is in monospace and normal weight. There
are no extra spaces.
In both the HTML and the PDF, only the string barxyz} is quoted.
I couldn't find the text that describes the notational conventions
used in the document but based on a quick review of a few examples
in the nearby text I would expect all the strings above to be in
monospace font, and both of the two possible results of the expansion,
namely "xyz}" and "barxyz}" to be quoted.
Is this worth opening an issue for or can it be left up to the
better judgment of the editor?
Martin