From e1adb1ee5766b4bcd8b13da6ccbbf5545a31d34a Mon Sep 17 00:00:00 2001 From: cuz Date: Mon, 16 Jun 2008 17:32:33 +0000 Subject: [PATCH] Several updates by Oliver Schmidt. git-svn-id: svn://svn.cc65.org/cc65/trunk@3845 b7a2c559-68d2-44c3-8de9-860c34a00d81 --- doc/apple2.sgml | 39 ++++++++++++++++++++++++++++++++++----- doc/apple2enh.sgml | 40 +++++++++++++++++++++++++++++++++++----- doc/debugging.sgml | 46 +++++----------------------------------------- 3 files changed, 74 insertions(+), 51 deletions(-) diff --git a/doc/apple2.sgml b/doc/apple2.sgml index 9f7209408..4d96ad917 100644 --- a/doc/apple2.sgml +++ b/doc/apple2.sgml @@ -35,10 +35,11 @@ more information. The standard binary output format generated by the linker for the Apple ][ target is a machine language program with a 4 byte DOS -3.3 header. The standard load address is $803. +3.3 header containing the load address and load size. The standard load address +is $803. -The DOS header is in its own segment named HEADER: start = $0000, size = $0004, file = %O; @@ -52,8 +53,13 @@ to in the linker configuration to have the linker remove it. -Please note that there is an 'Apple ][ ProDOS 8 system program -for loading binary programs' available in the cc65 User Contributions section. +) includes an option Limitations

+DOS 3.3 Limitations

+ +Although the standard binaries generated by the linker for the Apple ][ +generally run both on DOS 3.3 (with Applesoft BASIC) and on ProDOS 8 (with +BASIC.SYSTEM) there are some limitations for DOS 3.3: + + + + Disk File I/O + There's no disk file I/O support. Any attempt to use it yields an error with + Interrupts + There's no

+ Other hints

diff --git a/doc/apple2enh.sgml b/doc/apple2enh.sgml index 7fcae1523..e6825d151 100644 --- a/doc/apple2enh.sgml +++ b/doc/apple2enh.sgml @@ -35,10 +35,11 @@ more information. The standard binary output format generated by the linker for the enhanced Apple //e target is a machine language program with a 4 byte DOS -3.3 header. The standard load address is $803. +3.3 header containing the load address and load size. The standard load address +is $803. -The DOS header is in its own segment named HEADER: start = $0000, size = $0004, file = %O; @@ -52,8 +53,13 @@ to in the linker configuration to have the linker remove it. -Please note that there is an 'Apple ][ ProDOS 8 system program -for loading binary programs' available in the cc65 User Contributions section. +) includes an option Limitations

+DOS 3.3 Limitations

+ +Although the standard binaries generated by the linker for the enhanced Apple //e +generally run both on DOS 3.3 (with Applesoft BASIC) and on ProDOS 8 (with +BASIC.SYSTEM) there are some limitations for DOS 3.3: + + + + Disk File I/O + There's no disk file I/O support. Any attempt to use it yields an error with + Interrupts + There's no

+ + Other hints

diff --git a/doc/debugging.sgml b/doc/debugging.sgml index f2421e5b6..cf2df7c54 100644 --- a/doc/debugging.sgml +++ b/doc/debugging.sgml @@ -24,12 +24,12 @@ tools and the VICE CBM emulator. What is VICE?

-VICE is an emulator for many of the CBM machines. It runs on Unix, DOS and -Windows 95. It emulates the Commodore 64, 128, VIC20, PET and the 600/700 -machines. For more information see the VICE home page: +VICE is an emulator for many of the CBM machines. It runs on Unix, MS-DOS, +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: - + VICE has a builtin machine language monitor that may be used for debugging your programs. Using an emulator for debugging has some advantages: @@ -49,11 +49,6 @@ from the monitor. -Please note that you need at least VICE version 0.16 for the label file -feature to work. This version has still some problems (see ), but older versions had even more problems -and do How to prepare your programs

@@ -131,37 +126,6 @@ the compiler prepends an underline under most named labels). -Problems and workarounds

- -Older versions of VICE had several problems with labels. However, even those -versions were still tremendously useful, and all known problems are gone in -current versions. So, here is a list of the problems known to me as of version -0.16.1: - - - -The "VICE will crash if you use a label that is undefined. This is probably -the worst problem of all, since it needs just one typo to kill VICE. So, watch -your steps:-) - -Cheap labels, that is, labels starting with '@' or '?' are not accepted. - -The disassembly output is somewhat suboptimal. However, most things are -just cosmetical, e.g. labels appended to the right side of the disassembled -code. - - - -Note: All these problems are fixed in current (>= 1.0) VICE -versions. If you're really using such an old version, you should think about -an upgrade. - - -