From 7f0baff792bd4f5b4937dc1d19811f310ba7b29f Mon Sep 17 00:00:00 2001
From: bbbradsmith <bbbradsmith@users.noreply.github.com>
Date: Sun, 7 May 2023 16:35:05 -0400
Subject: [PATCH] document how to return from assembly sim65 test

---
 doc/sim65.sgml | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/doc/sim65.sgml b/doc/sim65.sgml
index 310de4667..c838cd3b0 100644
--- a/doc/sim65.sgml
+++ b/doc/sim65.sgml
@@ -126,9 +126,17 @@ a set of built-in paravirtualization functions (<ref id="paravirt-internal" name
 <sect>Creating a Test in Assembly<p>
 
 Assembly tests may similarly be assembled and linked with
-<tt/--target sim6502/ or <tt/--target sim65c02/,
-and the sim65 library provides an <tt/exit/ symbol that the program may <tt/JMP/
-to terminate with the current A register value as an exit code.
+<tt/--target sim6502/ or <tt/--target sim65c02/.
+Define and export <tt/_main/ as an entry point,
+and the sim65 library provides two ways to return an 8-bit exit code:
+
+<itemize>
+
+<item>Return from <tt/_main/ with the exit code in <tt/A/.
+
+<item><tt/jmp exit/ with the code in <tt/A/.
+
+</itemize>
 
 The binary file has a 12 byte header: