diff options
Diffstat (limited to 'listamsb.rst')
| -rw-r--r-- | listamsb.rst | 21 |
1 files changed, 18 insertions, 3 deletions
diff --git a/listamsb.rst b/listamsb.rst index b95bd99..b23d6a4 100644 --- a/listamsb.rst +++ b/listamsb.rst @@ -31,6 +31,10 @@ is the same for both versions, so there's no need to specify it. **input-file** must be a tokenized AMSB program. If no **input-file** is given, input is read from stdin. +Programs created with *SAVE "filename" LOCK* are autodetected, +and will be listed normally. It's also possible to convert a LOCKed +program to an unencrypted one, with the **-l** option. + Output is to stdout. Use shell redirection to save the output to a file. OPTIONS @@ -53,6 +57,17 @@ OPTIONS number is omitted (e.g. **100,**), it means "list until the end of the program". **-r,** is equivalent to not using the **-r** option at all. +**-l** + "Lock" or "unlock" the program. Locked programs are created with + *SAVE "filename" LOCK*. The "encryption" is reversible: locking and + unlocking are the same operation. The output will be the unlocked tokenized + program (rather than a listing), and you must + use redirection to save it to a file. Example:: + + listamsb -u LOCKED.AMB > UNLOCKED.AMB + + None of the other options have any effect with **-u**. + **-v** Verbose output, on stderr. @@ -78,10 +93,10 @@ These are errors in the program header at the start of the file. They generally mean the input isn't actually an tokenized Atari Microsoft BASIC file. -- not an AMSB file: first byte not $00 +- not an AMSB file: first byte not $00 or $01 - Pretty self-explanatory: if the file doesn't begin with a *$00* byte, - it's not a tokenized AMSB file. + Pretty self-explanatory: if the file doesn't begin with a *$00* or + *$01* byte, it's not a tokenized AMSB file. - not an AMSB file: too big (*N* bytes), won't fit in Atari memory |