From 51436978dd762b0f7ed9ccca60802665bcab3514 Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Mon, 17 Jun 2024 18:48:32 -0400
Subject: cxrefbas: update doc.

---
 cxrefbas.1 | 46 ++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 44 insertions(+), 2 deletions(-)

(limited to 'cxrefbas.1')

diff --git a/cxrefbas.1 b/cxrefbas.1
index 15dd6c1..6572532 100644
--- a/cxrefbas.1
+++ b/cxrefbas.1
@@ -37,8 +37,8 @@ cxrefbas [\fB\-v\fP] \fBinput\-file\fP
 .sp
 \fBcxrefbas\fP reads an Atari 8\-bit BASIC tokenized program. For each
 line number in the program, it prints a list of lines that reference
-it. Each reference is followed by a letter that indicates the type
-of reference:
+it. Each line number reference is followed by a letter that indicates
+the type of reference:
 .INDENT 0.0
 .TP
 .B \fBG\fP
@@ -82,6 +82,48 @@ Print version number and exit.
 Verbose operation. When displaying a number in verbose mode, it will
 be prefixed with \fI$\fP if it\(aqs in hex, or no prefix for decimal.
 .UNINDENT
+.SH EXAMPLE
+.sp
+This program:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+10 GOSUB 100:GOSUB 200
+100 RESTORE 1000:IF A THEN 120
+110 GOTO 200
+120 ON B GOTO 300,310,320
+200 RETURN
+300 PRINT 1
+310 PRINT 2
+1000 DATA XYZ
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Produces this output:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+100: 10:S
+120: 100:I
+200: 10:S 110:G
+300: 120:O
+310: 120:O
+!320: 120:O
+1000: 100:R
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Note that line 320 doesn\(aqt exist in the program, so it\(aqs shown with
+\fI!\fP in the output. Line 120 has \fI100:I\fP; if the \fITHEN 120\fP were
+changed to \fITHEN GOTO 120\fP, line 120 would read \fI100:G\fP\&.
 .SH EXIT STATUS
 .sp
 0 for success, 1 for failure.
-- 
cgit v1.2.3