From bbcfc474d0c68138de2f58679e4e4593c9a06684 Mon Sep 17 00:00:00 2001
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Date: Sat, 2 May 2026 14:26:51 -0500
Subject: [PATCH] doc/*.[67]: Drop redundant calls and requests

Sectioning and paragraphing macros always break the output line.

(Sub)sectioning macros always set text after the heading as a paragraph.

Fixes:

$ mandoc -T lint doc/*.[67] # output edited
doc/makedefs.6:49:2: WARNING: skipping paragraph macro: PP after SH
doc/nethack.6:367:2: WARNING: skipping paragraph macro: br after PP
doc/nethack.6:365:2: WARNING: skipping paragraph macro: PP empty
doc/nethack.6:157:2: WARNING: skipping paragraph macro: PP after SH
doc/nethack.6:431:2: WARNING: skipping paragraph macro: PP after SH
doc/nethack.6:673:2: WARNING: skipping paragraph macro: PP after SH
doc/nethack.6:676:2: WARNING: skipping paragraph macro: PP after SH
doc/recover.6:29:2: WARNING: skipping paragraph macro: PP after SH
doc/recover.6:125:2: WARNING: skipping paragraph macro: PP after SH
doc/recover.6:141:2: WARNING: skipping paragraph macro: PP after SH
doc/mnh.7:23:2: WARNING: skipping paragraph macro: PP after SH
doc/mnh.7:46:2: WARNING: skipping paragraph macro: PP after SH
---
 doc/makedefs.6 | 1 -
 doc/mnh.7      | 2 --
 doc/nethack.6  | 7 -------
 doc/recover.6  | 3 ---
 4 files changed, 13 deletions(-)

diff --git a/doc/makedefs.6 b/doc/makedefs.6
index fd6fe8941..3cc5926df 100644
--- a/doc/makedefs.6
+++ b/doc/makedefs.6
@@ -46,7 +46,6 @@ makedefs \- NetHack miscellaneous build-time functions
 .I file
 .BI \-\- command
 .SH DESCRIPTION
-.PP
 .B Makedefs
 is a build-time tool used for a variety of
 .BR NetHack (6)
diff --git a/doc/mnh.7 b/doc/mnh.7
index dd3b7e7a8..77c8d9bfb 100644
--- a/doc/mnh.7
+++ b/doc/mnh.7
@@ -20,7 +20,6 @@ mnh \- additional text formatting macros for the NetHack Guidebook
 .\".B "troff  \-mn"
 .\"[ options ]  file  ...
 .SH DESCRIPTION
-.PP
 This package of
 .IR nroff (1)
 and
@@ -43,7 +42,6 @@ mn(7)
 .SH AUTHOR
 Pat Rankin
 .SH REQUESTS
-.PP
 In the
 .I Note
 column,
diff --git a/doc/nethack.6 b/doc/nethack.6
index 35a92e8bf..92f813796 100644
--- a/doc/nethack.6
+++ b/doc/nethack.6
@@ -154,7 +154,6 @@ Also
 .\" Make sure path is not hyphenated below
 .hw nethackdir
 .SH DESCRIPTION
-.PP
 .I NetHack
 is a display oriented Dungeons & Dragons(tm) - like game.
 The standard tty display and command structure resemble rogue.
@@ -363,9 +362,6 @@ and the
 .B \-\-no\-nethackrc
 option can be used to skip any run-time configuration file.
 .PP
-.\" extra blank line
-.br
-.PP
 Some options provide feedback and then exit rather than play the game:
 .PP
 The
@@ -428,7 +424,6 @@ Use
 .RB \(oq "nethack \-\-usage | more" \(cq
 to read it a page at a time.
 .SH AUTHORS
-.PP
 Jay Fenlason (+ Kenny Woodland, Mike Thome and Jon Payne) wrote the
 original hack, very much like rogue (but full of bugs).
 .PP
@@ -670,10 +665,8 @@ can be used in debugging (wizard) mode.
 .I \%DEBUGFILES
 can be used if the program was built with 'DEBUG' enabled.
 .SH "SEE ALSO"
-.PP
 recover(6)
 .SH BUGS
-.PP
 Probably infinite.
 .SH COPYRIGHT
 .\" All troffs and nroffs support `\(co` except Plan 9 nroff, but Plan 9
diff --git a/doc/recover.6 b/doc/recover.6
index cf116e09d..b7298c015 100644
--- a/doc/recover.6
+++ b/doc/recover.6
@@ -26,7 +26,6 @@ recover \- recover a NetHack game interrupted by disaster
 ]
 .I "base1 base2" ...
 .SH DESCRIPTION
-.PP
 Occasionally, a NetHack game will be interrupted by disaster
 when the game or the system crashes.
 Prior to NetHack v3.1, these games were lost because various information
@@ -122,7 +121,6 @@ In either case,
 .I recover
 is easily compiled from the distribution utility directory.
 .SH NOTES
-.PP
 Like
 .I nethack
 itself,
@@ -138,7 +136,6 @@ will find them in the uncompressed form.
 .SH "SEE ALSO"
 nethack(6)
 .SH BUGS
-.PP
 .I recover
 makes no attempt to find out if a base name specifies a game in progress.
 If multiple machines share a playground, this would be impossible to