Re: Linux man-pages PDF book

["G. Branden Robinson" <g.branden.robinson@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 1282 bytes --]

Hi Alex,

At 2024-04-14T14:42:51+0200, Alejandro Colomar wrote:
> On Sun, Apr 14, 2024 at 02:32:25PM +0200, Alejandro Colomar wrote:
> > > groff_man(7):
> > >      -rC1     Number output pages consecutively, in strictly increasing
> > >               sequence, rather than resetting the page number to 1 (or
> > >               the value of register P) with each new man document.
> > 
> > Hmmmm.  Maybe I should follow v7's tradition and restart the page
> > number at each TH.  Let's call it an accidental improvement, and not
> > a regression.  :)
> > 
> > Although it would be interesting to learn when/why this changed.
> 
> It seems to have been here:
[...]
> -       | troff -Tpdf -dPDF.EXPORT=1 -dLABEL.REFS=1 -dpaper=a4 \
> -               -M"$(dirname "$0")" -mandoc -manmark -rC1 -rCHECKSTYLE=3 \
> -               2>&1 >/dev/null \
> -       | LC_ALL=C grep '^\. *ds ';
> -
> +       cat "$(dirname "$0")"/LMBfront.roff;
> +       cat "$(dirname "$0")"/an.tmac;
>         "$(dirname "$0")"/prepare.pl "$1";

I don't think there's one right choice here.  I _would_ make sure that
the PDF page numbering (visible in the PDF viewer's outline pane)
matches that used by the document.  To do otherwise will frustrate
users.

Regards,
Branden

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]