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.rst | 29 +++++++++++++++++++++--------
 1 file changed, 21 insertions(+), 8 deletions(-)

(limited to 'unprotbas.rst')

diff --git a/unprotbas.rst b/unprotbas.rst
index 35a5069..a3f5e28 100644
--- a/unprotbas.rst
+++ b/unprotbas.rst
@@ -11,7 +11,7 @@ Unprotect or create LIST-protected Atari 8-bit BASIC programs
 SYNOPSIS
 ========
 
-unprotbas [**-v**] [ [**-f**] [**-n**] [**-g**] [**-c**] [**-r** | **-w**] ] | [ [**-p** | **-pc** | **-pv**] ] **input-file** **output-file**
+unprotbas [**-v**] [ [**-f**] [**-n**] [**-g**] [**-c**] [**-r** | **-w**] ] | [ [**-p** | **-pc** | **-pv**] [**-x**\[*r|XX*] ] **input-file** **output-file**
 
 DESCRIPTION
 ===========
@@ -39,9 +39,19 @@ Option bundling is not supported, use e.g. **-v -f**, not **-vf**.
 To use filenames beginning with *-*, write them as *./-file*, or they
 will be treated as options.
 
+General Options
+---------------
+**--help**
+  Print usage message and exit.
+
+**--version**
+  Print version number and exit.
+
 **-v**
   Verbose operation.
 
+Unprotection Options
+--------------------
 **-f**
   Force the variable name table to be rebuilt, even if it looks OK.
   This option cannot be combined with **-n**.
@@ -70,18 +80,21 @@ will be treated as options.
   Read variable names from **varnames.txt**, and use them instead of
   generating the names. See **VARIABLE NAMES**, below.
 
+Protection Options
+------------------
 **-p**, **-pc**, **-pv**
   LIST-protect the program, rather than unprotecting it. **-pc** sets
   an invalid (0) next-line pointer on the last line of code. **-pv**
   replaces the variable names with the Atari EOL character (**$9B**).
   **-p** does both. None of the other options except **-v** (verbose)
-  can be used with these.
-
-**--help**
-  Print usage message and exit.
-
-**--version**
-  Print version number and exit.
+  and **-x** can be used with these.
+
+**-xr**, **-xXX**
+  Character to use for variable name protection, with **-p** or
+  **-pv**. *XX* is the character code in hex, e.g. **-x20** to use
+  a space. Default is **9b** (the EOL character). **-xr** means random
+  codes. Do not put a space between the **-x** and the hex digits or **r**.
+  This option only works if **-p** or **-pv** is used.
 
 EXIT STATUS
 ===========
-- 
cgit v1.2.3