X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Fdebugging.sgml;h=8b09db384c4c14d9d0607b2d2fd3510e894d5d96;hb=74455508314bc2b007e812ec5f9429496b9fbd5f;hp=7f97712865cc4f92339e44107b63ddc001086da6;hpb=72d5d040d8cf4a8079cb0c76f3353ed238880b1d;p=cc65 diff --git a/doc/debugging.sgml b/doc/debugging.sgml index 7f9771286..8b09db384 100644 --- a/doc/debugging.sgml +++ b/doc/debugging.sgml @@ -1,13 +1,11 @@
- -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: @@ -92,6 +90,10 @@ a linker command line would be: <tscreen><verb> 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 your program. @@ -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>