dumpbas: update man page.

1 files changed, 16 insertions, 82 deletions

diff --git a/dumpbas.rst b/dumpbas.rst
index 80b5653..aabff21 100644
--- a/dumpbas.rst
+++ b/dumpbas.rst
@@ -70,7 +70,7 @@ Line Header Markers
 **^**
   Prefix for line length.
 
-**(**, **)**
+**(** **)**
   Surrounds the 2 hex bytes for the line number.
 
 Statement Markers
@@ -88,7 +88,7 @@ Statement Markers
 **#**
   Prefix for the *0e* token, which introduces a BCD floating point constant.
 
-**[**, **]**
+**[** **]**
   Surrounds the 6 bytes of a BCD floating point constant.
 
 **$**
@@ -118,95 +118,29 @@ Line header
 Each line number begins with the line number (decimal) and offset from
 the start of the file (hex), followed by the 2 hex bytes for the line
 number in parentheses, followed by the line length (hex, preceded by
-^). From the example::
+^). Example::
 
-     10@0021 (0a 00): ^1b 
+     10@0018 (0a 00): ^19
 
-The line number is *10*, the file offset is *0021*. The *0a 00* are 10 again, in
-hex, LSB first. The *^1b* is the line length.
+The line number is *10*, and the file offset is *0018*. The *0a 00*
+are 10 again, in hex, LSB first. The *19* is the line length.
 
 Statements
 ----------
-Each statement within the line is displayed separately. Line 10's first statement::
+Each statement within the line is displayed separately. For this line of code::
 
-      >17 !28 $0f =0e "H/48 O/4f W/57  /20 M/4d A/41 N/4e Y/59  /20 T/54 I/49 M/4d E/45 S/53" 15 14: 
+  10 ? "HELLO":A=1
 
-This looks cryptic, but it includes a lot of information.
+The dump looks like::
 
-- *>* is the marker for the statement offset (*17*).
+   10@0018 (0a 00): ^19 
+    >0d !28 $0f =05 "H/48 E/45 L/4c L/4c O/4f" 14:
+    >19 !36 80 2d #0e [40 01 00 00 00 00] 16
 
-- *!* marks a command token (unmarked tokens are operator
-  tokens). *28* is the token for **?** (short form of PRINT, which has a
-  separate token).
-
-- *$* marks the string-constant token (*0f*).
-
-- *=* marks the string length byte (*0e*).
-
-- The string itself is printed inside double quotes, with each character in
-  both ASCII and hex (e.g. *H/48*).
-
-- The *15* is unmarked. It's the semicolon after the string.
-
-- There's a *:* at the end of the line (after the *14*, which is the end-of-statement
-  token).
-
-Line 10's second statement::
-
-      >1b !02 80 16 
-
-The *80* is a token for a variable (variable tokens always have bit 7 set, so they're
-always >= 80 hex). The *16* is the end-of-line token.
-
-Line 20's first statement has an example of a floating point constant::
-
-  #0e [40 01 00 00 00 00]
-
-- *#* marks the token for a FP constant.
-
-- The actual 6-byte constant is surrounded with *[* and *]*.
-
-- The last token is *16*, which is BASIC's end-of-line token.
-
-EXAMPLE
-=======
-If **dumpbas** is run on the following program::
-
-  10 ? "HOW MANY TIMES";:INPUT N
-  20 FOR I=1 TO N
-  30 ? "HELLO ";:? I;"/";N:NEXT I
-  40 REM WAIT FOR KEY
-  50 POKE 764,255
-  60 ? "PRESS ANY KEY"
-  70 IF PEEK(764)=255 THEN 70
-  80 POKE 764,255:GOTO 10
-
-**Note:** The "PRESS ANY KEY" was entered in inverse video.
-
-...it produces the following output::
-
-     10@0021 (0a 00): ^1b 
-      >17 !28 $0f =0e "H/48 O/4f W/57  /20 M/4d A/41 N/4e Y/59  /20 T/54 I/49 M/4d E/45 S/53" 15 14: 
-      >1b !02 80 16 
-     20@003c (14 00): ^11 
-      >11 !08 81 2d #0e [40 01 00 00 00 00] 19 80 16 
-     30@004d (1e 00): ^1d 
-      >0f !28 $0f =06 "H/48 E/45 L/4c L/4c O/4f  /20" 15 14: 
-      >19 !28 81 15 $0f =01 "//2f" 15 80 14: 
-      >1d !09 81 16 
-     40@006a (28 00): ^12 
-      >12 !00 57 41 49 54 20 46 4f 52 20 4b 45 59 9b 
-     50@007c (32 00): ^15 
-      >15 !1f #0e [41 07 64 00 00 00] 12 #0e [41 02 55 00 00 00] 16 
-     60@0091 (3c 00): ^15 
-      >15 !28 $0f =0d "|P/d0 |R/d2 |E/c5 |S/d3 |S/d3 | /a0 |A/c1 |N/ce |Y/d9 | /a0 |K/cb |E/c5 |Y/d9" 16 
-     70@00a6 (46 00): ^20 
-      >20 !07 46 3a #0e [41 07 64 00 00 00] 2c 22 #0e [41 02 55 00 00 00] 1b #0e [40 70 00 00 00 00] 16 
-     80@00c6 (50 00): ^1f 
-      >15 !1f #0e [41 07 64 00 00 00] 12 #0e [41 02 55 00 00 00] 14: 
-      >1f !0a #0e [40 10 00 00 00 00] 16 
-  32768@00e5 (00 80): ^0f 
-      >0f !19 $0f =07 "H/48 :/3a B/42 ./2e B/42 A/41 S/53" 16 
+There are two statements. The first one ends with token *14* (the
+end-of-statement or tokenized colon) and the second ends with *16*
+(the end-of-line token). The string *"HELLO"* is visible, and so is
+the floating point constant *1*.
 
 EXIT STATUS
 ===========