Re: [groff] 03/07: groff_ms(7): Update table of contents discussion.

[Keith Marshall]

Hi Branden,

On 02/10/2021 19:14, G. Branden Robinson wrote:
> gbranden pushed a commit to branch master
> in repository groff.
> 
> commit 256d165f40d8a630dacc8bcfc749088fa65152fb
> Author: G. Branden Robinson <g.branden.robinson@gmail.com>
> AuthorDate: Sat Oct 2 15:33:18 2021 +1000
> 
>     groff_ms(7): Update table of contents discussion.
>     
>     * Say "TC-LEADER" and "TC-MARGIN", not "TC_LEADER" and "TC_MARGIN".

Thanks for catching, and fixing these typos; unfortunately, you appear
to have missed a couple of instances, which I've now corrected myself.

>     * Update document control settings preamble to include mention of
>       special characters.
>     * Use \[aq] for literal neutral apostrophes.
>     * Document the `SN` string; it was documented in 4.2BSD (Kies/Tuthill).
>     * Revamp discussion of tables of contents.
>       - Recast and tighten wording.
>       - Offer advice about use of the `XS`, `XA`, and `XE` macros.
>       - Give each of the TOC macros a tagged paragraph to synopsize it.
>         Describe their operation in more detail.
>     
>     I feel a twinge about the name "TC-MARGIN"...isn't it more of a field
>     width?

Well, it is a field width, yes, but that field (which is designated to
display a page number) lies within the (extended) right-hand margin of
the TOC page, (on the premise that the leader extends to this margin).
If you want to name it something else, I'm open to suggestions; we would
then need to change it in s.tmac, groff_ms.7.man, and pdfmark.ms.

-- 
Regards,
Keith.