remote TABs in doc/ and test/

[cc65] / doc / debugging.sgml

diff --git a/doc/debugging.sgml b/doc/debugging.sgml
index cf2df7c54907c42946c437b76aae4fe087f6f01d..8b09db384c4c14d9d0607b2d2fd3510e894d5d96 100644 (file)
--- a/doc/debugging.sgml
+++ b/doc/debugging.sgml
@@ -1,13 +1,11 @@
 <!doctype linuxdoc system>
 
 <article>
-
-<title>Using VICE with cc65
-<author>Ullrich von Bassewitz, <htmlurl url="mailto:uz@cc65.org" name="uz@cc65.org">
-<date>03.12.2000
+<title>Using emulators with cc65
+<author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">
 
 <abstract>
-How to debug your code using the VICE emulator.
+How to debug your code using the VICE and Oricutron emulators.
 </abstract>
 
 <!-- Table of contents -->
@@ -29,7 +27,7 @@ Win32, OS/2, Acorn RISC OS, BeOS, QNX 6.x, Amiga, GP2X and Mac OS X. It emulates
 the Commodore 64, 128, VIC20, PET and the 600/700 machines. For more information
 see the VICE home page:
 
-<htmlurl url="http://www.viceteam.org/">
+<url url="http://vice-emu.sourceforge.net/">.
 
 VICE has a builtin machine language monitor that may be used for debugging
 your programs. Using an emulator for debugging has some advantages:
@@ -45,7 +43,7 @@ arbitary addresses), debug interrupt handlers and even debug routines that run
 inside the 1541 floppy.
 
 <item>You may use the label file generated by the linker to make much more use
-from the monitor.     
+from the monitor.
 
 </itemize>
 
@@ -90,7 +88,11 @@ file (I'm usually using a <tt/.lbl/ extension for these files). An example for
 a linker command line would be:
 
 <tscreen><verb>
-    ld65 -t c64 -Ln hello.lbl -m hello.map -o hello crt0 hello.o c64.lib
+    ld65 -o hello -t c64 -Ln hello.lbl -m hello.map hello.o c64.lib
+</verb></tscreen>
+or
+<tscreen><verb>
+    ld65 -o hello.tap -t atmos -Ln hello.sym -m hello.map hello.o atmos.lib
 </verb></tscreen>
 
 This will generate a file named hello.lbl that contains all symbols used in
@@ -101,13 +103,13 @@ debug info, so you don't have to care about this.
 
 
 
-<sect>How to use the label file<p>
+<sect>How to use the label file with VICE<p>
 
 Load your program, then enter the monitor and use the "<tt/ll/" command to
 load your label file like this:
 
 <tscreen><verb>
-               ll "hello.lbl"
+        ll "hello.lbl"
 </verb></tscreen>
 
 You will get lots of warnings and even a few errors. You may ignore safely all
@@ -118,7 +120,7 @@ After loading the labels, they are used by VICE in the disassembler listing,
 and you may use them whereever you need to specify an address. Try
 
 <tscreen><verb>
-       d ._main
+        d ._main
 </verb></tscreen>
 
 as an example (note that VICE needs a leading dot before all labels, and that
@@ -126,7 +128,25 @@ the compiler prepends an underline under most named labels).
 
 
 
-</article>
+<sect>How to use the label file with Oricutron<p>
+
+Load your program, then enter the monitor and use the "<tt/sl/" command to
+load your label file like this:
+
+<tscreen><verb>
+        sl hello.sym
+</verb></tscreen>
 
+After loading the labels, they are used by Oricutron in the disassembler listing,
+and you may use them whereever you need to specify an address. Try
 
+<tscreen><verb>
+        d ._main
+</verb></tscreen>
 
+as an example (note that VICE needs a leading dot before all labels, and that
+the compiler prepends an underline under most named labels).
+
+
+
+</article>