From c84cedb3337c2cdabb5f3ff91aa44810d9661091 Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Wed, 29 May 2024 14:18:15 -0400
Subject: unprotbas: don't allow -x without -p or -pv, group options in doc.

---
 unprotbas.1 | 28 +++++++++++++++++++++-------
 1 file changed, 21 insertions(+), 7 deletions(-)

(limited to 'unprotbas.1')

diff --git a/unprotbas.1 b/unprotbas.1
index 437cfaf..7fb818c 100644
--- a/unprotbas.1
+++ b/unprotbas.1
@@ -32,7 +32,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 unprotbas \- Unprotect or create LIST-protected Atari 8-bit BASIC programs
 .SH SYNOPSIS
 .sp
-unprotbas [\fB\-v\fP] [ [\fB\-f\fP] [\fB\-n\fP] [\fB\-g\fP] [\fB\-c\fP] [\fB\-r\fP | \fB\-w\fP] ] | [ [\fB\-p\fP | \fB\-pc\fP | \fB\-pv\fP] ] \fBinput\-file\fP \fBoutput\-file\fP
+unprotbas [\fB\-v\fP] [ [\fB\-f\fP] [\fB\-n\fP] [\fB\-g\fP] [\fB\-c\fP] [\fB\-r\fP | \fB\-w\fP] ] | [ [\fB\-p\fP | \fB\-pc\fP | \fB\-pv\fP] [\fB\-x\fP[\fIr|XX\fP] ] \fBinput\-file\fP \fBoutput\-file\fP
 .SH DESCRIPTION
 .sp
 \fBunprotbas\fP modifies a LIST\-protected Atari 8\-bit BASIC program,
@@ -55,10 +55,20 @@ tokenized BASIC is binary data and may confuse the terminal).
 Option bundling is not supported, use e.g. \fB\-v \-f\fP, not \fB\-vf\fP\&.
 To use filenames beginning with \fI\-\fP, write them as \fI\&./\-file\fP, or they
 will be treated as options.
+.SS General Options
 .INDENT 0.0
 .TP
+.B \fB\-\-help\fP
+Print usage message and exit.
+.TP
+.B \fB\-\-version\fP
+Print version number and exit.
+.TP
 .B \fB\-v\fP
 Verbose operation.
+.UNINDENT
+.SS Unprotection Options
+.INDENT 0.0
 .TP
 .B \fB\-f\fP
 Force the variable name table to be rebuilt, even if it looks OK.
@@ -87,19 +97,23 @@ generating new ones. See \fBVARIABLE NAMES\fP, below.
 .B \fB\-r\fP
 Read variable names from \fBvarnames.txt\fP, and use them instead of
 generating the names. See \fBVARIABLE NAMES\fP, below.
+.UNINDENT
+.SS Protection Options
+.INDENT 0.0
 .TP
 .B \fB\-p\fP, \fB\-pc\fP, \fB\-pv\fP
 LIST\-protect the program, rather than unprotecting it. \fB\-pc\fP sets
 an invalid (0) next\-line pointer on the last line of code. \fB\-pv\fP
 replaces the variable names with the Atari EOL character (\fB$9B\fP).
 \fB\-p\fP does both. None of the other options except \fB\-v\fP (verbose)
-can be used with these.
+and \fB\-x\fP can be used with these.
 .TP
-.B \fB\-\-help\fP
-Print usage message and exit.
-.TP
-.B \fB\-\-version\fP
-Print version number and exit.
+.B \fB\-xr\fP, \fB\-xXX\fP
+Character to use for variable name protection, with \fB\-p\fP or
+\fB\-pv\fP\&. \fIXX\fP is the character code in hex, e.g. \fB\-x20\fP to use
+a space. Default is \fB9b\fP (the EOL character). \fB\-xr\fP means random
+codes. Do not put a space between the \fB\-x\fP and the hex digits or \fBr\fP\&.
+This option only works if \fB\-p\fP or \fB\-pv\fP is used.
 .UNINDENT
 .SH EXIT STATUS
 .INDENT 0.0
-- 
cgit v1.2.3