From 44c012e9cf6200c9ac98369f413355549888f196 Mon Sep 17 00:00:00 2001 From: "G. Branden Robinson" Date: Mon, 6 Nov 2023 14:01:56 -0600 Subject: [PATCH] doc/Guidebook.mn: Fix overset lines in nroff mode One can observe the following problems when generating or viewing plain text versions of the Guidebook. (There are three; "Guidebook" and "Guidebook.txt" are identical, and are paginated; "Guidebook.dat" is not paginated.) 1. The line "(Edited and expanded for NetHack 3.7.0 by Mike Stephenson and others)" is overset. 2. So are Figures 1 and 2, by one character cell, when rendered with groff 1.23.0 because of the way it handles boxed tables and those with vertical rules at table boundaries. https://git.savannah.gnu.org/cgit/groff.git/commit/?id=8f066786ea3cb5e1dbade1149e7d50ae978da202 3. When viewing the Guidebook in an 80-column terminal, the left and right margins are asymmetric; you get 10 columns on the left but only 5 on the right. So: * doc/Guidebook.mn: In nroff mode, set page offset to 5n and increase line and title line lengths by 5n to 70n. Now, the margins are symmetric, there's ample room for the figures, and the expansion credit fits. (One diagnostic remains when formatting with groff 1.23.0. troff:tmac.n:762: error: cannot load font 'S' for emboldening This is a groff bug and will be fixed in the next release. The diagnostic is spurious and can be ignored. See .) --- doc/Guidebook.mn | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/Guidebook.mn b/doc/Guidebook.mn index 58f342a8a..7386fcd63 100644 --- a/doc/Guidebook.mn +++ b/doc/Guidebook.mn @@ -25,6 +25,12 @@ .\" with an optional filtering step between 'cat' and 'tbl': .\" cat... |../util/makedefs --grep --input - --output - |tbl... . +.if n \{\ +.po 5n +.ll 70n +.lt 70n +.\} +. .so tmac.nh \" extra macros which aren't in tmac.n . .\" building Guidebook.txt doesn't have CR font available; groff 1.23 issues