aboutsummaryrefslogtreecommitdiff
path: root/unprotbas.rst
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-05-24 04:22:02 -0400
committerB. Watson <urchlay@slackware.uk>2024-05-24 04:25:34 -0400
commit79ba7b783def208893d13fe785e7d8bde76740a2 (patch)
treee24a0748b8d045465f700b6f2953e6e8d3761ddf /unprotbas.rst
parent0044a85e0ab54ebec7e1ba47f4a4a6ac2ad29360 (diff)
downloadbw-atari8-tools-79ba7b783def208893d13fe785e7d8bde76740a2.tar.gz
unprotbas: add -p/-pc/-pv to docs, plus verbose operation for them.
Diffstat (limited to 'unprotbas.rst')
-rw-r--r--unprotbas.rst18
1 files changed, 13 insertions, 5 deletions
diff --git a/unprotbas.rst b/unprotbas.rst
index cd55dd8..138b228 100644
--- a/unprotbas.rst
+++ b/unprotbas.rst
@@ -2,23 +2,24 @@
unprotbas
=========
----------------------------------------------------
-Unprotect LIST-protected Atari 8-bit BASIC programs
----------------------------------------------------
+-------------------------------------------------------------
+Unprotect or create LIST-protected Atari 8-bit BASIC programs
+-------------------------------------------------------------
.. include:: manhdr.rst
SYNOPSIS
========
-unprotbas [**-v**] [**-f**] [**-n**] [**-g**] [**-c**] [**-r** | **-w**] **input-file** **output-file**
+unprotbas [**-v**] [ [**-f**] [**-n**] [**-g**] [**-c**] [**-r** | **-w**] ] | [ [**-p** | **-pc** | **-pv**] ] **input-file** **output-file**
DESCRIPTION
===========
**unprotbas** modifies a LIST-protected Atari 8-bit BASIC program,
creating a new non-protected copy. See **DETAILS**, below, to
-understand how the protection and unprotection works.
+understand how the protection and unprotection works. It's also capable
+of LIST-protecting an unprotected program.
**input-file** must be a tokenized (SAVEd) Atari BASIC program. Use
*-* to read from standard input.
@@ -67,6 +68,13 @@ will be treated as options.
Read variable names from **varnames.txt**, and use them instead of
generating the names. See **VARIABLE NAMES**, below.
+**-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.
+
EXIT STATUS
===========