diff options
| author | B. Watson <urchlay@slackware.uk> | 2024-07-01 19:13:14 -0400 |
|---|---|---|
| committer | B. Watson <urchlay@slackware.uk> | 2024-07-01 19:13:14 -0400 |
| commit | 869862a4db0c727e3797b15d41d6b865cb8f3350 (patch) | |
| tree | 42e46c21fa0617e4d3b811270a6805a8f595766a /listbas.rst | |
| parent | 2926604dc6651711ab525ab5fd84762748ce51ff (diff) | |
| download | bw-atari8-tools-869862a4db0c727e3797b15d41d6b865cb8f3350.tar.gz | |
listbas: use a8cat instead of a8utf8 or a8eol.
Diffstat (limited to 'listbas.rst')
| -rw-r--r-- | listbas.rst | 25 |
1 files changed, 13 insertions, 12 deletions
diff --git a/listbas.rst b/listbas.rst index c4a937a..d6d17b1 100644 --- a/listbas.rst +++ b/listbas.rst @@ -11,7 +11,7 @@ List the source of a tokenized Atari 8-bit BASIC program SYNOPSIS ======== -listbas [**-v**] [**-i**] [**-a** | **-u** ] **input-file** +listbas [**-v**] [**-i**] [**-a** | **-m** ] **input-file** DESCRIPTION =========== @@ -20,13 +20,12 @@ DESCRIPTION tokenized (SAVEd) BASIC program and prints the code in human-readable format. -By default, output is piped through **a8eol**\(1), to convert ATASCII -characters to human-readable sequences. Raw ATASCII and Unicode output -are also available. +By default, output is piped through **a8cat**\(1), to covert ATASCII +characters into Unicode equivalents. Raw ATASCII and "magazine listing" +mode are also available. -**a8eol**\(1) and **a8utf8**\(1) (for **-u**) are run as external -processes. The executables are searched for first in the current -directory, and then in *PATH*. +**a8cat** is run as an external processe. The executables is searched +for first in the current directory, and then in *PATH*. OPTIONS ======= @@ -41,8 +40,9 @@ List options Output raw ATASCII; no translation to the host character set. Must be used with redirection; **listbas** will not write ATASCII to the terminal. -**-u** - Use **a8utf8**\(1) to translate ATASCII to ASCII. +**-m** + Output "magazine listing". Pipes output through **a8cat -m**; see the man + page for **a8cat** for details. .. include:: genopts.rst @@ -61,9 +61,10 @@ protection. - **listbas** doesn't show information about the variables. Use **vxrefbas**\(1) for that. -- **listbas** will not write ATASCII data to your terminal. Instead, it uses - **a8eol**\(1) or **a8utf8**\(1) to convert the output to something human-readable - that won't confuse the terminal. +- **listbas** will not write ATASCII data to your terminal. By default, it uses + **a8cat**\(1) to convert the output to something human-readable + that won't confuse the terminal. When outputting raw ATASCII (**-a** option), + it refuses to run if standard output is a terminal. - **listbas** only lists line 32768 (the immediate mode command) if specifically asked to do so. |