From c91ee79dcb721a63e5371cc0d3b0bbea16bb43ef Mon Sep 17 00:00:00 2001 From: "G. Branden Robinson" Date: Sat, 25 Oct 2025 19:21:38 -0500 Subject: [PATCH] doc/nethack.6: Fix inelegant formatting Replace instances of blank line paragraphing with `PP` macro calls. There are three problems with the style of paragraphing that this commit fixes. 1. A `br` break request is redundant with an adjacent blank text line. 2. A `br` request is also redundant with a paragraphing macro call. 3. When you use a paragraphing macro call instead of a blank text line, you get the configured amount inter-paragraph space. When typesetting with the man(7) package, the default inter-paragraph space amount is 0.4v. A blank text line usually puts 1v of empty space into the document. See groff_man_style(7). Fixes: $ nroff -ww -z -rCHECKSTYLE=4 -man doc/*.[67] an.tmac:doc/nethack.6:435: style: blank line in input an.tmac:doc/nethack.6:442: style: blank line in input an.tmac:doc/nethack.6:535: style: blank line in input an.tmac:doc/nethack.6:539: style: blank line in input an.tmac:doc/nethack.6:543: style: blank line in input an.tmac:doc/nethack.6:568: style: blank line in input an.tmac:doc/nethack.6:572: style: blank line in input --- doc/nethack.6 | 21 +++++++-------------- 1 file changed, 7 insertions(+), 14 deletions(-) diff --git a/doc/nethack.6 b/doc/nethack.6 index a9c46e6fc..9e9fb97e0 100644 --- a/doc/nethack.6 +++ b/doc/nethack.6 @@ -429,15 +429,13 @@ Run-time configuration options were discussed above and use a platform specific name for a file in a platform specific location. For Unix, the name is '.nethackrc' in the user's home directory. - -.br +.PP All other files are in the playground directory, normally /usr/games/lib/nethackdir. If DLB was defined during the compile, the data files and special levels will be inside a larger file, normally nhdat, instead of being separate files. - -.br +.PP .DT .\" continuation lines begin with .ta \w'cmdhelp, opthelp, wizhelp\ \ \ 'u @@ -528,16 +526,13 @@ sysconf System-wide options. Required if \ program is built with 'SYSCF' option .br \ enabled, ignored if not. -.br - +.PP The location of 'sysconf' is specified at build time and can't be changed except by updating source file "config.h" and rebuilding the program. -.br - +.PP NetHack's Guidebook might not be present if whoever packaged or installed the program distribution neglected to include it. -.br - +.PP In a perfect world, 'paniclog' would remain empty. .SH ENVIRONMENT .DT @@ -561,12 +556,10 @@ MAILREADER Replacement for default reader NETHACKDIR or HACKDIR Playground. .br NETHACKOPTIONS String predefining several NetHack options. -.br - +.PP If the same option is specified in both NETHACKOPTIONS and .nethackrc, the value assigned in NETHACKOPTIONS takes precedence. -.br - +.PP SHOPTYPE and SPLEVTYPE can be used in debugging (wizard) mode. .br DEBUGFILES can be used if the program was built with 'DEBUG' enabled.