From bdae11c61dd541d506b152b0f818d0d8b6cdf752 Mon Sep 17 00:00:00 2001
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Date: Tue, 5 May 2026 18:37:27 -0500
Subject: [PATCH] doc/nethack.6: Revise role info in synopsis

Revise presentation of backward-compatible role options.

- Give them a metasyntactic variable name and present them in the main
  command synopsis.

- Present the possible values in a typographical display, indented with
  filling disabled.
---
 doc/nethack.6 | 23 ++++++++---------------
 1 file changed, 8 insertions(+), 15 deletions(-)

diff --git a/doc/nethack.6 b/doc/nethack.6
index 1944df6a4..554b8dd16 100644
--- a/doc/nethack.6
+++ b/doc/nethack.6
@@ -55,6 +55,7 @@ nethack \- Exploring The Mazes of Menace
 .nr sA \n(.j \" Save the adjustment mode.
 .na
 .B nethack
+.RI [ role-option ]
 .RB [ \-d | \-\-directory\*_\c
 .IR directory ]
 .RB [ \-w | \-\-windowtype\*_\c
@@ -75,34 +76,26 @@ nethack \- Exploring The Mazes of Menace
 .IR race ]
 .RB [ \-@ ]
 .PP
-Also
-[
+.I role-option
+can be any of the following.
+.PP
+.RS
+.nf
 .BR \-A | \-Arc
-|
 .BR \-B | \-Bar
-|
 .BR \-C | \-Cav
-|
 .BR \-H | \-Hea
-|
 .BR \-K | \-Kni
-|
 .BR \-M | \-Mon
-|
 .BR \-P | \-Pri
-|
 .BR \-R | \-Rog
-|
 .B \-Ran
-|
 .BR \-S | \-Sam
-|
 .BR \-T | \-Tou
-|
 .BR \-V | \-Val
-|
 .BR \-W | \-Wiz
-]
+.fi
+.RE
 .HP
 .B nethack
 .RB { \-s | \-\-scores }