diff options
| author | B. Watson <urchlay@slackware.uk> | 2024-05-29 14:18:15 -0400 |
|---|---|---|
| committer | B. Watson <urchlay@slackware.uk> | 2024-05-29 14:20:36 -0400 |
| commit | c84cedb3337c2cdabb5f3ff91aa44810d9661091 (patch) | |
| tree | b36d5d2e7aeac3b06b4014b880bcaa5370c0f14f /unprotbas.rst | |
| parent | 377fd0927ce1daf97dcefea0b17ec5cbaf2f02b2 (diff) | |
| download | bw-atari8-tools-c84cedb3337c2cdabb5f3ff91aa44810d9661091.tar.gz | |
unprotbas: don't allow -x without -p or -pv, group options in doc.
Diffstat (limited to 'unprotbas.rst')
| -rw-r--r-- | unprotbas.rst | 29 |
1 files changed, 21 insertions, 8 deletions
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 =========== |