[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [groff] 03/07: groff_ms(7): Update table of contents discussion.
From: |
Keith Marshall |
Subject: |
Re: [groff] 03/07: groff_ms(7): Update table of contents discussion. |
Date: |
Sat, 2 Oct 2021 23:35:30 +0100 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.1.1 |
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.
- Re: [groff] 03/07: groff_ms(7): Update table of contents discussion.,
Keith Marshall <=