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
This commit is contained in:
G. Branden Robinson
2026-05-06 04:39:57 -05:00
parent 723afcd51f
commit c91ee79dcb
+7 -14
View File
@@ -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 <backslash><space><tab>
.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.