From 2d3f9b8c217a63ae0725ac22ff39700d1b83361b Mon Sep 17 00:00:00 2001
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Date: Tue, 5 May 2026 20:12:58 -0500
Subject: [PATCH] doc/recover.6: Revise synopsis
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Tighten formatting: set synopsis syntax characters adjacently to
operands.  Rename `-d` option argument from "directory" to
"playground-directory" for clarity.

Set operands more idiomatically.  They are not given in pairs; instead
"base" can be repeated arbitrarily.  See, for example, the POSIX
reference page for ls(1).
  https://pubs.opengroup.org/onlinepubs/9799919799/utilities/ls.html

Format ellipsis idiomatically.

groff_man_style(7):

Notes
       ... The idiomatic roff ellipsis is three dots (periods) with thin
       space escape sequences \| internally separating them.  Since dots
       both begin control lines and are candidate end‐of‐sentence
       characters, however, it is sometimes necessary to prefix and/or
       suffix an ellipsis with the dummy character escape sequence \&.
---
 doc/recover.6 | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/doc/recover.6 b/doc/recover.6
index 5d78684ee..922981d00 100644
--- a/doc/recover.6
+++ b/doc/recover.6
@@ -22,11 +22,10 @@
 recover \- recover a NetHack game interrupted by disaster
 .SH SYNOPSIS
 .B recover
-[
-.B \-d
-.I directory
-]
-.I "base1 base2" ...
+.RB [ \-d
+.IR playground-directory ]
+.I base
+\&.\|.\|.
 .SH DESCRIPTION
 Occasionally, a NetHack game will be interrupted by disaster
 when the game or the system crashes.