bug-bash
[Top][All Lists]
Advanced

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

Re: Minor mistake in Bash manual


From: Todd Lehman
Subject: Re: Minor mistake in Bash manual
Date: Mon, 11 Mar 2019 23:15:14 -0500

On Mar 11, 2019, at 11:03 PM, Robert Elz <address@hidden> wrote:
> No, it was fine, I understood the context OK - it is just that this
> is one of those rock and hard place situations - the places where
> there is no period to end a sentence can just as easily be argued
> to be incorrect.

I would argue that readability of the document overrides pedantic English 
usage. (And I'm saying that as an extremely pedantic English user. :-)

> Certainly one cannot simply move the training period to a new line
> (and font style) all on its own, after the example.

Right; that would be bad. But at least it wouldn't be part of the verbatim text 
block anymore (which is the real bug).

> That's why the usual solution to all of this is to rewrite and simply
> avoid the issue (even if the final text then seems rather contrived and
> stilted).

Or, as is the case in at least a dozen other places in the same document, you 
could just omit the period altogether, making a grammatically incorrect 
sentence.

Better yet, use a colon before the verbatim text block. That's used quite a bit 
elsewhere in the document.

In any case, please fix as you see fit. (But I'm sure you will agree that the 
current state of that example cannot stand. It is a flagrant violation of 
sanity to include the period inside the verbatim text block. :-)

Thanks!
--Todd



reply via email to

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