listamsb: update man page.

1 files changed, 11 insertions, 5 deletions

diff --git a/listamsb.rst b/listamsb.rst
index dac3c1e..08f762f 100644
--- a/listamsb.rst
+++ b/listamsb.rst
@@ -20,10 +20,6 @@ DESCRIPTION
 tokenized (SAVEd) AMSB program and prints the code in human-readable
 format.
 
-By default, output is piped to **a8cat**\(1), which converts the
-ATASCII output to something that's human-readable on modern terminals.
-This means **a8cat** must be available somewhere in **$PATH**\.
-
 **listamsb** supports both versions of Atari Microsoft BASIC: the
 disk-based version 1 and the cartridge-based version 2. The language
 is the same for both versions, so there's no need to specify it.
@@ -40,6 +36,15 @@ options.
 
 If no **output-file** is given, output is to **stdout**.
 
+When listing a program to **stdout**, output is piped through
+**a8cat**\(1), which converts the ATASCII output to UTF-8 that's
+human-readable on modern terminals. This means **a8cat** must be
+available in your **PATH**\. If this is not convenient, you can set
+the location of **a8cat** via the **A8CAT** environment variable.
+
+**listamsb** will not write binary data (ATASCII or tokenized BASIC)
+directly to a terminal.
+
 OPTIONS
 =======
 
@@ -94,7 +99,7 @@ or **-U**.
   ATASCII to a terminal. **a8cat** is not used, with this option.
 
 **-c**
-  Check only. No output on stdout. Diagnostics are still printed on stderr,
+  Check only. No output on **stdout**. Diagnostics are still printed on stderr,
   and the exit status is unchanged. It's an error to give an **output-file** with
   this option.
 
@@ -130,6 +135,7 @@ Utility Options
 **-v**
   Verbose output, on **stderr**. May be given twice for extra verbosity,
   which shows each line number, its offset, length, and end-of-line pointer.
+  Can be used with any of the mode options (**-C**, **-D**, **-L**, **-U**).
 
 **-h**\, **--help**
   Print built-in help and exit.