doc/recover.6: Revise synopsis

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 \&.
This commit is contained in:
G. Branden Robinson
2026-05-06 04:53:12 -05:00
parent 561d08e53b
commit 2d3f9b8c21
+4 -5
View File
@@ -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.