listbas: exit with status 2 on invaid tokens, add note to doc about aha.

1 files changed, 18 insertions, 1 deletions

diff --git a/listbas.1 b/listbas.1
index 13d53f4..6170b6a 100644
--- a/listbas.1
+++ b/listbas.1
@@ -145,9 +145,26 @@ specifically asked to do so.
 \fBlistbas\fP tells you if the program is protected, and refuses to operate
 on variable\-protected programs.
 .UNINDENT
+.sp
+I thought about adding an HTML output option, but there\(aqs no need: if you want
+a colorful listing of an Atari BASIC program, install \fBaha\fP(1) from
+\fI\%https://github.com/theZiz/aha\fP (or your distro\(aqs package repo) and run
+something like:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+listbas PROGRAM.BAS | aha > program.html
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SH EXIT STATUS
 .sp
-0 for success, 1 for failure.
+0 for success, 1 if there was an error reading the input (e.g. file
+not found), or 2 if the input file has invalid tokens (if this
+happens, you will also see a warning about it on stderr).
 .SH COPYRIGHT
 .sp
 WTFPL. See \fI\%http://www.wtfpl.net/txt/copying/\fP for details.