aboutsummaryrefslogtreecommitdiff
path: root/unprotbas.rst
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-05-29 15:00:43 -0400
committerB. Watson <urchlay@slackware.uk>2024-05-29 15:00:43 -0400
commit74f632203d187148b3d063b7023051138e872d4c (patch)
tree5ba65301e63afae1e4cb4a54a1e81c628b25e4e4 /unprotbas.rst
parentc84cedb3337c2cdabb5f3ff91aa44810d9661091 (diff)
downloadbw-atari8-tools-74f632203d187148b3d063b7023051138e872d4c.tar.gz
unprotbas: add -s option.
Diffstat (limited to 'unprotbas.rst')
-rw-r--r--unprotbas.rst17
1 files changed, 14 insertions, 3 deletions
diff --git a/unprotbas.rst b/unprotbas.rst
index a3f5e28..1840e71 100644
--- a/unprotbas.rst
+++ b/unprotbas.rst
@@ -11,7 +11,9 @@ Unprotect or create LIST-protected Atari 8-bit BASIC programs
SYNOPSIS
========
-unprotbas [**-v**] [ [**-f**] [**-n**] [**-g**] [**-c**] [**-r** | **-w**] ] | [ [**-p** | **-pc** | **-pv**] [**-x**\[*r|XX*] ] **input-file** **output-file**
+unprotbas [**-v**] [**-f**] [**-n**] [**-g**] [**-c**] [**-r** | **-w**] **input-file** **output-file**
+
+unprotbas [**-v**] [**-p** | **-pc** | **-pv**] [**-x**\[*r|NN*] **input-file** **output-file**
DESCRIPTION
===========
@@ -35,6 +37,10 @@ tokenized BASIC is binary data and may confuse the terminal).
OPTIONS
=======
+Options may appear in any order. The first non-option argument is used
+for **input-file**; the second is **output-file**. A third non-option
+argument is an error.
+
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.
@@ -89,13 +95,18 @@ Protection Options
**-p** does both. None of the other options except **-v** (verbose)
and **-x** can be used with these.
-**-xr**, **-xXX**
+**-xr**, **-xNN**
Character to use for variable name protection, with **-p** or
- **-pv**. *XX* is the character code in hex, e.g. **-x20** to use
+ **-pv**. *NN* 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.
+**-s**
+ Shrink variable name table to one byte per variable name, with **-p** or
+ **-pv**. Cannot be used with **-xr**. Programs protected this way are
+ very similar to ones protected with **PROTECT.BAS**.
+
EXIT STATUS
===========