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.
|
specific name for a file in a platform specific location.
|
||||||
For Unix, the
|
For Unix, the
|
||||||
name is '.nethackrc' in the user's home directory.
|
name is '.nethackrc' in the user's home directory.
|
||||||
|
.PP
|
||||||
.br
|
|
||||||
All other files are in the playground directory,
|
All other files are in the playground directory,
|
||||||
normally /usr/games/lib/nethackdir.
|
normally /usr/games/lib/nethackdir.
|
||||||
If DLB was defined during the compile, the data files and special levels
|
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
|
will be inside a larger file, normally nhdat, instead of being separate
|
||||||
files.
|
files.
|
||||||
|
.PP
|
||||||
.br
|
|
||||||
.DT
|
.DT
|
||||||
.\" continuation lines begin with <backslash><space><tab>
|
.\" continuation lines begin with <backslash><space><tab>
|
||||||
.ta \w'cmdhelp, opthelp, wizhelp\ \ \ 'u
|
.ta \w'cmdhelp, opthelp, wizhelp\ \ \ 'u
|
||||||
@@ -528,16 +526,13 @@ sysconf System-wide options. Required if
|
|||||||
\ program is built with 'SYSCF' option
|
\ program is built with 'SYSCF' option
|
||||||
.br
|
.br
|
||||||
\ enabled, ignored if not.
|
\ enabled, ignored if not.
|
||||||
.br
|
.PP
|
||||||
|
|
||||||
The location of 'sysconf' is specified at build time and can't be changed
|
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.
|
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
|
NetHack's Guidebook might not be present if whoever packaged or installed
|
||||||
the program distribution neglected to include it.
|
the program distribution neglected to include it.
|
||||||
.br
|
.PP
|
||||||
|
|
||||||
In a perfect world, 'paniclog' would remain empty.
|
In a perfect world, 'paniclog' would remain empty.
|
||||||
.SH ENVIRONMENT
|
.SH ENVIRONMENT
|
||||||
.DT
|
.DT
|
||||||
@@ -561,12 +556,10 @@ MAILREADER Replacement for default reader
|
|||||||
NETHACKDIR or HACKDIR Playground.
|
NETHACKDIR or HACKDIR Playground.
|
||||||
.br
|
.br
|
||||||
NETHACKOPTIONS String predefining several NetHack options.
|
NETHACKOPTIONS String predefining several NetHack options.
|
||||||
.br
|
.PP
|
||||||
|
|
||||||
If the same option is specified in both NETHACKOPTIONS and .nethackrc,
|
If the same option is specified in both NETHACKOPTIONS and .nethackrc,
|
||||||
the value assigned in NETHACKOPTIONS takes precedence.
|
the value assigned in NETHACKOPTIONS takes precedence.
|
||||||
.br
|
.PP
|
||||||
|
|
||||||
SHOPTYPE and SPLEVTYPE can be used in debugging (wizard) mode.
|
SHOPTYPE and SPLEVTYPE can be used in debugging (wizard) mode.
|
||||||
.br
|
.br
|
||||||
DEBUGFILES can be used if the program was built with 'DEBUG' enabled.
|
DEBUGFILES can be used if the program was built with 'DEBUG' enabled.
|
||||||
|
|||||||
Reference in New Issue
Block a user