aboutsummaryrefslogtreecommitdiff
path: root/unprotbas.1
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.1
parentc84cedb3337c2cdabb5f3ff91aa44810d9661091 (diff)
downloadbw-atari8-tools-74f632203d187148b3d063b7023051138e872d4c.tar.gz
unprotbas: add -s option.
Diffstat (limited to 'unprotbas.1')
-rw-r--r--unprotbas.117
1 files changed, 14 insertions, 3 deletions
diff --git a/unprotbas.1 b/unprotbas.1
index 7fb818c..0f34aec 100644
--- a/unprotbas.1
+++ b/unprotbas.1
@@ -32,7 +32,9 @@ 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] [\fB\-x\fP[\fIr|XX\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] \fBinput\-file\fP \fBoutput\-file\fP
+.sp
+unprotbas [\fB\-v\fP] [\fB\-p\fP | \fB\-pc\fP | \fB\-pv\fP] [\fB\-x\fP[\fIr|NN\fP] \fBinput\-file\fP \fBoutput\-file\fP
.SH DESCRIPTION
.sp
\fBunprotbas\fP modifies a LIST\-protected Atari 8\-bit BASIC program,
@@ -52,6 +54,10 @@ will refuse to write to standard output if it\(aqs a terminal (since
tokenized BASIC is binary data and may confuse the terminal).
.SH OPTIONS
.sp
+Options may appear in any order. The first non\-option argument is used
+for \fBinput\-file\fP; the second is \fBoutput\-file\fP\&. A third non\-option
+argument is an error.
+.sp
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.
@@ -108,12 +114,17 @@ 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)
and \fB\-x\fP can be used with these.
.TP
-.B \fB\-xr\fP, \fB\-xXX\fP
+.B \fB\-xr\fP, \fB\-xNN\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
+\fB\-pv\fP\&. \fINN\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.
+.TP
+.B \fB\-s\fP
+Shrink variable name table to one byte per variable name, with \fB\-p\fP or
+\fB\-pv\fP\&. Cannot be used with \fB\-xr\fP\&. Programs protected this way are
+very similar to ones protected with \fBPROTECT.BAS\fP\&.
.UNINDENT
.SH EXIT STATUS
.INDENT 0.0