Re: [PATCH 6/9] Slightly revise documentation of POSIX mode.

2024-12-30 Thread G. Branden Robinson
Hi Chet, At 2024-12-30T12:40:48-0500, Chet Ramey wrote: > On 12/16/24 12:48 PM, G. Branden Robinson wrote: > > * doc/bash.1: Introduce "POSIX mode" earlier in the document. Set > > the word "POSIX" in small caps (as traditionally done for acronyms) > > `POSIX' is not an acronym, despite the Open

Re: [PATCH 5/9] doc/bash.1: Stop manipulating adjustment.

2024-12-30 Thread G. Branden Robinson
I need to correct a point in my own explanation. No revision to the patch itself is necessary. At 2024-12-16T11:48:15-0600, G. Branden Robinson wrote: > Since AT&T troff also lacks a feature for hyphenless discretionary > breaks (groff's `\%`), I of course meant `\:` here. If you knew your man

Re: [PATCH 9/9] doc/bash.1: Resync w/ lib/readline/doc/readline.3.

2024-12-30 Thread Chet Ramey
On 12/16/24 12:48 PM, G. Branden Robinson wrote: Favor man(7) font selection/alternation macros over roff(7) font selection escape sequences. In general, I don't do this when it makes the man page source and the texinfo source lines align better. There are exceptions. -- ``The lyf so short, t

Re: Consolidate recommended options?

2024-12-30 Thread Dale R. Worley
Daniel Colascione writes: > I wonder whether it would be possible to add a simple catch-all command > that would encompass a set of options that can't be defaults but that > make writing shell scripts easier, e.g. set -euo pipefail, nullglob, > inherit_errexit, extglob, assoc_expand_once, and vari

Re: [PATCH 6/9] Slightly revise documentation of POSIX mode.

2024-12-30 Thread Chet Ramey
On 12/16/24 12:48 PM, G. Branden Robinson wrote: * doc/bash.1: Introduce "POSIX mode" earlier in the document. Set the word "POSIX" in small caps (as traditionally done for acronyms) `POSIX' is not an acronym, despite the Open Group's efforts to retcon it. It's historically been just a nam

Re: [PATCH 3/9] doc/bash.1, doc/bashref.texi: Align wording.

2024-12-30 Thread Chet Ramey
On 12/16/24 12:47 PM, G. Branden Robinson wrote: The @option{--norc} -option inhibits this behavior, and the -@option{--rcfile} -option makes Bash use a different file instead of +option will inhibit this behavior, and the +@option{--rcfile} option +will make Bash use a different file inste

Re: [PATCH 3/9] doc/bash.1, doc/bashref.texi: Align wording.

2024-12-30 Thread G. Branden Robinson
At 2024-12-30T11:12:12-0500, Chet Ramey wrote: > On 12/16/24 12:47 PM, G. Branden Robinson wrote: > > The > > @option{--norc} > > -option inhibits this behavior, and the > > -@option{--rcfile} > > -option makes Bash use a different file instead of > > +option will inhibit this behavior, and the

Re: [PATCH 9/9] doc/bash.1: Resync w/ lib/readline/doc/readline.3.

2024-12-30 Thread G. Branden Robinson
Hi Chet, At 2024-12-30T11:23:06-0500, Chet Ramey wrote: > On 12/16/24 12:48 PM, G. Branden Robinson wrote: > > > Favor man(7) font selection/alternation macros over roff(7) font > > selection escape sequences. > > In general, I don't do this when it makes the man page source and the > texinfo so