[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Doc: NR - Doc CSS colour support (issue 551270043 by address@hidden)

From: rietveldpkx
Subject: Re: Doc: NR - Doc CSS colour support (issue 551270043 by address@hidden)
Date: Thu, 19 Dec 2019 03:35:06 -0800
File Documentation/notation/editorial.itely (right):
Documentation/notation/editorial.itely:496: symbol in the form
@code{'@var{FooBar}} or a string in the form
On 2019/12/18 18:02:33, lemzwerg wrote:
If you use 'FooBar' as an example for an argument, it's better to
*not* use
'@var'.  If you want to use '@var', say


to make 'color' a meta-variable and use @var{color} in the surrounding
text as a
reference to it.

Thanks, that is better. Done.
Documentation/notation/editorial.itely:579: Not all colors are
distinguishable in a web browser, i.e. a web browser
On 2019/12/18 18:02:33, lemzwerg wrote:
There should always a comma after 'i.e.', as far as I know.

Nope. It's grammatical dogma (in the same vein as not starting sentences
with the words 'And' or 'Because). I think commas after these
abbreviations look ugly. It's not CG policy either - I checked - and, in
fact, the examples we give in CG 5.4.7 don't use commas either.

And please avoid lines longer than 80 characters.
Thanks, fixed.
File Documentation/notation/notation-appendices.itely (right):
Documentation/notation/notation-appendices.itely:863: Any name that is
spelled as a single word with capitalization (e.g.
On 2019/12/18 18:02:33, lemzwerg wrote:
AFAIK, there should always be a comma after 'e.g.'.

See my comment on the other file about this.

This is especially important for the PDFs since by default
`texinfo.tex` doesn't
use frenchspacing, thus inserting a larger horizontal space after a
full stop.

So? If it were that bad why are we using two spaces after a full point

Which has nothing to do with grammar and would mean this would have to
be made policy (which it isn't) and fixed throughout the entire doc.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]