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:
+7
-14
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user