Hi all, I've done a restorative change to the PDF book title. The manual pages in this project had historically used the 5th argument to TH, with the string "Linux Programmer's Manual". This was showed as the center-top title of the pages. This was incidentally consistent with the UNIX Programmer's Manual. A few years ago, I removed the 5th argument to TH to use the default string, to follow conventions. At the same time, I put the project name and version in the 4th argument to TH: "Linux man-pages X.Y". When we added the scripts written by Deri to produce a PDF book, the title of the book was "The Linux Manpage Book", and the front page said "GNU/Linux\nTHE MAN PAGES BOOK". For consistency with the project name, I changed those some time ago to be title: "The Linux man-pages Book" and front: "GNU/Linux\nTHE MAN-PAGES BOOK". However, for consistency with the UNIX Programmer's Manual, and with the old title used within the project, I'm now (partially) restoring the title of the book and its front page to be both: "GNU/Linux Programmer's Manual". (It's not fully restorative, because it has GNU/Linux where the old title had just Linux, but half of our documentation is for glibc, so I think it's deserved.) (I was never convinced by the old front text: why should it have the word "book"?) I'll hold this change for a few days in case anyone has comments for it. Have a lovely day! Alex commit 9926e7cefe109b1752b166e5105025db3615b9ca (HEAD -> contrib) Author: Alejandro Colomar <alx@xxxxxxxxxx> Date: Tue Aug 27 11:48:58 2024 +0200 share/mk/: build-pdf-book: Rename book to "GNU/Linux Programmer's Manual" This more closely resembles the historical name used in the project. The manual pages had "Linux Programmer's Manual" in the 5th argument to TH, until that was changed a few years ago to follow groff(7) conventions. This restoration of the title is also consistent with the UNIX Programmer's Manual. Signed-off-by: Alejandro Colomar <alx@xxxxxxxxxx> diff --git a/share/mk/build/pdf/book/front.roff b/share/mk/build/pdf/book/front.roff index fdf1a9820..c18ab6b92 100644 --- a/share/mk/build/pdf/book/front.roff +++ b/share/mk/build/pdf/book/front.roff @@ -17,7 +17,7 @@ \m[maroon]GNU/Linux\m[] .sp 18p .ps 16 -\f[BMB]THE MAN-PAGES BOOK\fP +\f[BMB]Programmer's Manual\fP .sp 6i .ps 12 \f[HB]Maintainers:\fP diff --git a/share/mk/build/pdf/book/prepare.pl b/share/mk/build/pdf/book/prepare.pl index 800715d82..ef8c17b18 100755 --- a/share/mk/build/pdf/book/prepare.pl +++ b/share/mk/build/pdf/book/prepare.pl @@ -83,7 +83,7 @@ BuildBook(); sub BuildBook { - print ".pdfpagenumbering D . 1\n.nr PDFOUTLINE.FOLDLEVEL 0\n.defcolor pdf:href.colour rgb 0.00 0.25 0.75\n.pdfinfo /Title \"The Linux man-pages Book\"\n.special TinosR S\n"; + print ".pdfpagenumbering D . 1\n.nr PDFOUTLINE.FOLDLEVEL 0\n.defcolor pdf:href.colour rgb 0.00 0.25 0.75\n.pdfinfo /Title \"GNU/Linux Programmer's Manual\"\n.special TinosR S\n"; foreach my $bkmark (sort sortman keys %files) { BuildPage($bkmark); -- <https://www.alejandro-colomar.es/>
Attachment:
signature.asc
Description: PGP signature