PDF book title: "GNU/Linux Programmer's Manual"

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux