diff --git a/doc/apple2.sgml b/doc/apple2.sgml index 036f37207..e58565359 100644 --- a/doc/apple2.sgml +++ b/doc/apple2.sgml @@ -4,7 +4,7 @@ Apple ][ specific information for cc65 <author><url url="mailto:ol.sc@web.de" name="Oliver Schmidt"> -<date>2009-10-07 +<date>2014-04-10 <abstract> An overview over the Apple ][ runtime system as it is @@ -24,7 +24,7 @@ Apple ][ specific header files, available drivers, and any pitfalls specific to that platform. Please note that Apple ][ specific functions are just mentioned -here, they are described in detail in the separate <htmlurl url="funcref.html" +here, they are described in detail in the separate <url url="funcref.html" name="function reference">. Even functions marked as "platform dependent" may be available on more than one platform. Please see the function reference for more information. @@ -45,7 +45,7 @@ containing DOS 3.3 as well as ProDOS 8. For ProDOS 8 system programs the load address is fixed to $2000 so there is no need for a header. Thus the linker configuration -<htmlurl url="apple2.html#ss4.3" name="apple2-system.cfg"> for those programs +<ref id="apple-sys-cfg" name="apple2-system.cfg"> for those programs omits the DOS 3.3 header. The right AppleCommander option to put system files without a header on a ProDOS 8 disk image is <tt/-p/. @@ -81,11 +81,11 @@ cc65 runtime system takes care of actually moving the code into the Language Card. The amount of memory available in the Language Card for generated code depends -on the chosen <htmlurl url="apple2.html#s4" name="linker configuration">. +on the chosen <ref id="link-configs" name="linker configuration">. -<sect>Linker configurations<p> +<sect>Linker configurations<label id="link-configs"><p> The ld65 linker comes with a default config file for the Apple ][, which is used via <tt/-t apple2/. @@ -138,7 +138,7 @@ vanilla DOS 3.3 doesn't make use of the Language Card at all. </descrip><p> -<sect1><tt/apple2-system.cfg/<p> +<sect1><tt/apple2-system.cfg/<label id="apple-sys-cfg"><p> Configuration for a system program running on ProDOS 8. @@ -159,7 +159,7 @@ Configuration for a system program running on ProDOS 8. </descrip><p> -<sect1><tt/apple2-loader.cfg/<p> +<sect1><tt/apple2-loader.cfg/<label id="apple-load-cfg"><p> Configuration optimized for a binary program running on ProDOS 8 without BASIC.SYSTEM. Intended to be used with <bf/LOADER.SYSTEM - an @@ -231,7 +231,7 @@ range. The easiest (and for really large programs in fact the only) way to have a cc65 program use the memory from $800 to $2000 is to link it as binary (as opposed to system) program using the linker configuration -<htmlurl url="apple2.html#ss4.4" name="apple2-loader.cfg"> with start address +<ref id="apple-load-cfg" name="apple2-loader.cfg"> with start address $803 and load it with the targetutil LOADER.SYSTEM. The program then works like a system program (i.e. quits to the ProDOS dispatcher). @@ -243,7 +243,7 @@ example the program <tt/MYPROG/ is loaded by <tt/MYPROG.SYSTEM/. <sect1>Heap<p> If the cc65 program can be successfully linked as system program using the linker -configuration <htmlurl url="apple2.html#ss4.3" name="apple2-system.cfg"> but +configuration <ref id="apple-sys-cfg" name="apple2-system.cfg">, but uses the heap either explicitly or implicitly (i.e. by loading a driver) then the memory from $800 to $2000 can be added to the heap by calling <tt/_heapadd ((void *) 0x0800, 0x1800);/ at the beginning of <tt/main()/. @@ -268,7 +268,7 @@ default I/O buffer allocation basically yields the same placement of I/O buffers in memory the primary benefit of <tt/apple2-iobuf-0800.o/ is a reduction in code size - and thus program file size - of more than 1400 bytes. -Using <tt/apple2-iobuf-0800.o/ is as simple as placing it on the linker command +Using <tt/apple2-iobuf-0800.o/ is as simple as placing it on the linker command line like this: <tscreen><verb> @@ -286,7 +286,7 @@ Programs containing Apple ][ specific code may use the <sect1>Apple ][ specific functions<p> The functions listed below are special for the Apple ][. See -the <htmlurl url="funcref.html" name="function reference"> for declaration and +the <url url="funcref.html" name="function reference"> for declaration and usage. <itemize> @@ -347,7 +347,7 @@ The names in the parentheses denote the symbols to be used for static linking of <tag><tt/a2.auxmem.emd (a2_auxmem_emd)/</tag> Gives access to 47.5 KB RAM (190 pages of 256 bytes each) on an Extended 80-Column Text Card. - + Note that this driver doesn't check for the actual existence of the memory and that it doesn't check for ProDOS 8 RAM disk content! @@ -373,7 +373,7 @@ The names in the parentheses denote the symbols to be used for static linking of Driver for the AppleMouse II Card. Searches all Apple II slots for an AppleMouse II Card compatible firmware. The default bounding box is [0..279,0..191]. - + Programs using this driver will have to be linked with <tt/--start-addr $4000/ to reserve the first hires page if they are intended to run on an Apple ][ (in contrast to an Apple //e) because the @@ -428,7 +428,7 @@ BASIC.SYSTEM) there are some limitations for DOS 3.3: 'FAILED TO ALLOC INTERRUPT' on program startup. This implicitly means that <tt/a2.stdmou.mou/ and <tt/a2.ssc.ser/ are not functional as they depend on interrupts. - + </descrip><p> @@ -477,7 +477,7 @@ The runtime for the Apple ][ uses routines marked as <tt/.INTERRUPTOR/ for ProDOS 8 interrupt handlers. Such routines must be written as simple machine language subroutines and will be called automatically by the interrupt handler code when they are linked into a -program. See the discussion of the <tt/.CONDES/ feature in the <htmlurl +program. See the discussion of the <tt/.CONDES/ feature in the <url url="ca65.html" name="assembler manual">. @@ -486,7 +486,7 @@ url="ca65.html" name="assembler manual">. <descrip> <tag/Drive ID/ - The function <htmlurl url="dio.html#s1" name="dio_open()"> has the single + The function <url url="dio.html#s1" name="dio_open()"> has the single parameter <tt/device/ to identify the device to be opened. Therefore an Apple II slot and drive pair is mapped to that <tt/device/ according to the formula @@ -498,7 +498,7 @@ url="ca65.html" name="assembler manual">. so that for example slot 6 drive 2 is mapped to <tt/device/ 14. <tag/Sector count/ - The function <htmlurl url="dio.html#s3" name="dio_query_sectcount()"> returns + The function <url url="dio.html#s3" name="dio_query_sectcount()"> returns the correct sector count for all ProDOS 8 disks. However for any non-ProDOS 8 disk it simply always returns 280 (which is only correct for a 140 KB disk). This condition is indicated by the <tt/_oserror/ value 82. diff --git a/doc/apple2enh.sgml b/doc/apple2enh.sgml index 95a8c084c..215c6d384 100644 --- a/doc/apple2enh.sgml +++ b/doc/apple2enh.sgml @@ -4,7 +4,7 @@ <title>Enhanced Apple //e specific information for cc65 <author><url url="mailto:ol.sc@web.de" name="Oliver Schmidt"> -<date>2009-10-07 +<date>2014-04-10 <abstract> An overview over the enhanced Apple //e runtime system as it is @@ -24,7 +24,7 @@ enhanced Apple //e specific header files, available drivers, and any pitfalls specific to that platform. Please note that enhanced Apple //e specific functions are just mentioned -here, they are described in detail in the separate <htmlurl url="funcref.html" +here, they are described in detail in the separate <url url="funcref.html" name="function reference">. Even functions marked as "platform dependent" may be available on more than one platform. Please see the function reference for more information. @@ -45,7 +45,7 @@ containing DOS 3.3 as well as ProDOS 8. For ProDOS 8 system programs the load address is fixed to $2000 so there is no need for a header. Thus the linker configuration -<htmlurl url="apple2enh.html#ss4.3" name="apple2enh-system.cfg"> for those programs +<ref id="apple-sys-cfg" name="apple2enh-system.cfg"> for those programs omits the DOS 3.3 header. The right AppleCommander option to put system files without a header on a ProDOS 8 disk image is <tt/-p/. @@ -81,11 +81,11 @@ cc65 runtime system takes care of actually moving the code into the Language Card. The amount of memory available in the Language Card for generated code depends -on the chosen <htmlurl url="apple2enh.html#s4" name="linker configuration">. +on the chosen <ref id="link-configs" name="linker configuration">. -<sect>Linker configurations<p> +<sect>Linker configurations<label id="link-configs"><p> The ld65 linker comes with a default config file for the enhanced Apple //e, which is used via <tt/-t apple2enh/. @@ -138,7 +138,7 @@ vanilla DOS 3.3 doesn't make use of the Language Card at all. </descrip><p> -<sect1><tt/apple2enh-system.cfg/<p> +<sect1><tt/apple2enh-system.cfg/<label id="apple-sys-cfg"><p> Configuration for a system program running on ProDOS 8. @@ -159,7 +159,7 @@ Configuration for a system program running on ProDOS 8. </descrip><p> -<sect1><tt/apple2enh-loader.cfg/<p> +<sect1><tt/apple2enh-loader.cfg/<label id="apple-load-cfg"><p> Configuration optimized for a binary program running on ProDOS 8 without BASIC.SYSTEM. Intended to be used with <bf/LOADER.SYSTEM - an @@ -231,7 +231,7 @@ range. The easiest (and for really large programs in fact the only) way to have a cc65 program use the memory from $800 to $2000 is to link it as binary (as opposed to system) program using the linker configuration -<htmlurl url="apple2enh.html#ss4.4" name="apple2enh-loader.cfg"> with start address +<ref id="apple-load-cfg" name="apple2enh-loader.cfg"> with start address $803 and load it with the targetutil LOADER.SYSTEM. The program then works like a system program (i.e. quits to the ProDOS dispatcher). @@ -243,7 +243,7 @@ example the program <tt/MYPROG/ is loaded by <tt/MYPROG.SYSTEM/. <sect1>Heap<p> If the cc65 program can be successfully linked as system program using the linker -configuration <htmlurl url="apple2enh.html#ss4.3" name="apple2enh-system.cfg"> but +configuration <ref id="apple-sys-cfg" name="apple2enh-system.cfg">, but uses the heap either explicitly or implicitly (i.e. by loading a driver) then the memory from $800 to $2000 can be added to the heap by calling <tt/_heapadd ((void *) 0x0800, 0x1800);/ at the beginning of <tt/main()/. @@ -286,7 +286,7 @@ Programs containing enhanced Apple //e specific code may use the <sect1>Enhanced Apple //e specific functions<p> The functions listed below are special for the enhanced Apple //e. See -the <htmlurl url="funcref.html" name="function reference"> for declaration and +the <url url="funcref.html" name="function reference"> for declaration and usage. <itemize> @@ -483,7 +483,7 @@ The runtime for the enhanced Apple //e uses routines marked as <tt/.INTERRUPTOR/ for ProDOS 8 interrupt handlers. Such routines must be written as simple machine language subroutines and will be called automatically by the interrupt handler code when they are linked into a -program. See the discussion of the <tt/.CONDES/ feature in the <htmlurl +program. See the discussion of the <tt/.CONDES/ feature in the <url url="ca65.html" name="assembler manual">. @@ -492,7 +492,7 @@ url="ca65.html" name="assembler manual">. <descrip> <tag/Drive ID/ - The function <htmlurl url="dio.html#s1" name="dio_open()"> has the single + The function <url url="dio.html#s1" name="dio_open()"> has the single parameter <tt/device/ to identify the device to be opened. Therefore an Apple II slot and drive pair is mapped to that <tt/drive_id/ according to the formula @@ -504,7 +504,7 @@ url="ca65.html" name="assembler manual">. so that for example slot 6 drive 2 is mapped to <tt/device/ 14. <tag/Sector count/ - The function <htmlurl url="dio.html#s3" name="dio_query_sectcount()"> returns + The function <url url="dio.html#s3" name="dio_query_sectcount()"> returns the correct sector count for all ProDOS 8 disks. However for any non-ProDOS 8 disk it simply always returns 280 (which is only correct for a 140 KB disk). This condition is indicated by the <tt/_oserror/ value 82. diff --git a/doc/atari.sgml b/doc/atari.sgml index 4b848575d..2b164ce35 100644 --- a/doc/atari.sgml +++ b/doc/atari.sgml @@ -6,7 +6,7 @@ <author> <url url="mailto:shawnjefferson@24fightingchickens.com" name="Shawn Jefferson"> and<newline> <url url="mailto:chris@groessler.org" name="Christian Groessler"> -<date>2014-03-27 +<date>2014-04-10 <abstract> An overview over the Atari runtime system as it is implemented for the cc65 C @@ -36,7 +36,7 @@ recommended to use the <tt/atari/ target unless lack of memory dictates the use of the <tt/atarixl/ target. Please note that Atari specific functions are just mentioned here, they are -described in detail in the separate <htmlurl url="funcref.html" name="function +described in detail in the separate <url url="funcref.html" name="function reference">. Even functions marked as "platform dependent" may be available on more than one platform. Please see the function reference for more information. @@ -264,7 +264,7 @@ header file. <sect1>Atari specific functions<p> The functions and global variable listed below are special for the Atari. -See the <htmlurl url="funcref.html" name="function reference"> for declaration and usage. +See the <url url="funcref.html" name="function reference"> for declaration and usage. <itemize> <item>get_ostype @@ -666,7 +666,7 @@ The runtime for the Atari uses routines marked as <tt/.INTERRUPTOR/ for interrupt handlers. Such routines must be written as simple machine language subroutines and will be called automatically by the VBI handler code when they are linked into a program. See the discussion of the <tt/.CONDES/ -feature in the <htmlurl url="ca65.html" name="assembler manual">. +feature in the <url url="ca65.html" name="assembler manual">. <sect1>Reserving a memory area inside a program<label id="memhole"><p> diff --git a/doc/c128.sgml b/doc/c128.sgml index 3309d68af..4154c0a8d 100644 --- a/doc/c128.sgml +++ b/doc/c128.sgml @@ -4,7 +4,7 @@ <title>Commodore 128-specific information for cc65 <author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> -<date>2014-03-24 +<date>2014-04-12 <abstract> An overview over the C128 runtime system as it is implemented for the cc65 C @@ -235,9 +235,8 @@ The default drivers, <tt/joy_stddrv (joy_static_stddrv)/, point to <tt/c128-stdj <tag><tt/c128-ptvjoy.joy (c128_ptvjoy_joy)/</tag> Driver for the Protovision 4-player adapter originally written by Groepaz - for the C64, and converted for the C128 by me. See <htmlurl - url="http://www.protovision-online.de/hardw/hardwstart.htm" - name="http://www.protovision-online.de/hardw/hardwstart.htm"> for prices and + for the C64, and converted for the C128 by Uz. See <url + url="http://www.protovision-online.de/hardw/hardwstart.htm"> for prices and building instructions. Up to four joysticks are supported. <tag><tt/c128-stdjoy.joy (c128_stdjoy_joy)/</tag> diff --git a/doc/c16.sgml b/doc/c16.sgml index a1317a0b5..1614516b7 100644 --- a/doc/c16.sgml +++ b/doc/c16.sgml @@ -4,7 +4,7 @@ <title>Commodore 16/116 specific information for cc65 <author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> -<date>2003-12-15 +<date>2014-04-10 <abstract> An overview over the C16 runtime system as it is implemented for the cc65 C @@ -23,13 +23,13 @@ cc65 C compiler. It describes the memory layout, C16/116 specific header files, available drivers, and any pitfalls specific to that platform. Please note that C16 specific functions are just mentioned here, they are -described in detail in the separate <htmlurl url="funcref.html" name="function +described in detail in the separate <url url="funcref.html" name="function reference">. Even functions marked as "platform dependent" may be available on more than one platform. Please see the function reference for more information. Since the C16/C116 and the Commodore Plus/4 are almost identical (the former -don't have the 6551 ACIA and only 16KB of memory), the <htmlurl +don't have the 6551 ACIA and only 16KB of memory), the <url url="plus4.html" name="Plus/4 documentation"> is also worth a look. The difference between both cc65 targets is that the Plus/4 runtime uses banking to support full 64K RAM, while the C16 does not use banking and supports up to @@ -97,7 +97,7 @@ There are currently no special C16/C116 functions. <sect1>CBM specific functions<p> Some functions are available for all (or at least most) of the Commodore -machines. See the <htmlurl url="funcref.html" name="function reference"> for +machines. See the <url url="funcref.html" name="function reference"> for declaration and usage. <itemize> @@ -232,7 +232,7 @@ The runtime for the C16 uses routines marked as <tt/.INTERRUPTOR/ for interrupt handlers. Such routines must be written as simple machine language subroutines and will be called automatically by the interrupt handler code when they are linked into a program. See the discussion of the <tt/.CONDES/ -feature in the <htmlurl url="ca65.html" name="assembler manual">. +feature in the <url url="ca65.html" name="assembler manual">. diff --git a/doc/c64.sgml b/doc/c64.sgml index cef7f6467..ca99e0061 100644 --- a/doc/c64.sgml +++ b/doc/c64.sgml @@ -4,7 +4,7 @@ <title>Commodore 64-specific information for cc65 <author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> -<date>2014-03-24 +<date>2014-04-14 <abstract> An overview over the C64 runtime system as it is implemented for the cc65 C @@ -273,15 +273,13 @@ The default drivers, <tt/joy_stddrv (joy_static_stddrv)/, point to <tt/c64-stdjo <descrip> <tag><tt/c64-hitjoy.joy (c64_hitjoy_joy)/</tag> - Driver for the Digital Excess & Hitmen adapter contributed by Groepaz. See - <htmlurl url="http://www.digitalexcess.de/downloads/productions.php" - name="http://www.digitalexcess.de/downloads/productions.php"> on + Driver for the Digital Excess & Hitmen adapter contributed by Groepaz. + See <url url="http://www.digitalexcess.de/downloads/productions.php"> on instructions how to build one. Up to four joysticks are supported. <tag><tt/c64-ptvjoy.joy (c64_ptvjoy_joy)/</tag> Driver for the Protovision 4-player adapter contributed by Groepaz. See - <htmlurl url="http://www.protovision-online.de/hardw/hardwstart.htm" - name="http://www.protovision-online.de/hardw/hardwstart.htm"> for prices and + <url url="http://www.protovision-online.de/hardw/hardwstart.htm"> for prices and building instructions. Up to four joysticks are supported. <tag><tt/c64-stdjoy.joy (c64_stdjoy_joy)/</tag> diff --git a/doc/ca65.sgml b/doc/ca65.sgml index 46c1f4457..caf022c16 100644 --- a/doc/ca65.sgml +++ b/doc/ca65.sgml @@ -3,7 +3,7 @@ <article> <title>ca65 Users Guide <author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> -<date>2000-07-19, 2000-11-29, 2001-10-02, 2005-09-08 +<date>2014-04-10 <abstract> ca65 is a powerful macro assembler for the 6502, 65C02 and 65816 CPUs. It is @@ -453,9 +453,8 @@ mnemonics: 6502X mode is an extension to the normal 6502 mode. In this mode, several mnemonics for illegal instructions of the NMOS 6502 CPUs are accepted. Since these instructions are illegal, there are no official mnemonics for them. The -unofficial ones are taken from <htmlurl -url="http://www.oxyron.de/html/opcodes02.html" -name="http://www.oxyron.de/html/opcodes02.html">. Please note that only the +unofficial ones are taken from <url +url="http://www.oxyron.de/html/opcodes02.html">. Please note that only the ones marked as "stable" are supported. The following table uses information from the mentioned web page, for more information, see there. @@ -502,8 +501,7 @@ nor does it call the interpreter. All this must be done by your program. Apple ][ programmers do probably know how to use sweet16 mode. For more information about SWEET 16, see -<htmlurl url="http://www.6502.org/source/interpreters/sweet16.htm" -name="http://www.6502.org/source/interpreters/sweet16.htm">. +<url url="http://www.6502.org/source/interpreters/sweet16.htm">. <sect1>Number format<p> diff --git a/doc/debugging.sgml b/doc/debugging.sgml index 320aa0359..c7c7792db 100644 --- a/doc/debugging.sgml +++ b/doc/debugging.sgml @@ -4,7 +4,7 @@ <title>Using emulators with cc65 <author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> -<date>03.12.2000 +<date>2014-04-11 <abstract> How to debug your code using the VICE and Oricutron emulators. @@ -29,7 +29,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: diff --git a/doc/dio.sgml b/doc/dio.sgml index fe0a89983..c85992a4a 100644 --- a/doc/dio.sgml +++ b/doc/dio.sgml @@ -3,7 +3,7 @@ <article> <title>Diskette Sector I/O Routines <author><url url="mailto:chris@groessler.org" name="Christian Groessler"> -<date>20-Feb-2005 +<date>2014-04-10 <abstract> The cc65 library provides functions to read and write raw disk sectors. @@ -89,8 +89,8 @@ The following function returns the sector size of the currently inserted disk: </verb></tscreen> On the Atari platform, the sector size is handled specially. Please refer -to the DIO section in the <htmlurl url="atari.html" name="Atari"> -specific platform documentation. +to the DIO section in the <url url="atari.html" name="Atari-specific +platform documentation">. <p> The following function returns the sector count of the currently inserted disk: diff --git a/doc/funcref.sgml b/doc/funcref.sgml index 85b4c266e..adfeaf4b2 100644 --- a/doc/funcref.sgml +++ b/doc/funcref.sgml @@ -3,7 +3,7 @@ <article> <title>cc65 function reference <author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> -<date>07.11.2002 +<date>2014-04-10 <abstract> cc65 is a C compiler for 6502 based systems. This function reference describes @@ -23,7 +23,7 @@ just some of the supported machines. This function refrence describes the available functions together with any limitations. For an overview about the available libraries, their purpose, and any -differences to the ISO standard, please have a look at the <htmlurl +differences to the ISO standard, please have a look at the <url url="library.html" name="cc65 Library Overview">. <bf/Note:/ Standard C functions are listed here, but not described in detail. @@ -276,8 +276,7 @@ function. <sect1><tt/dio.h/<label id="dio.h"><p> -<htmlurl url="dio.html" name="dio.html"> -Low-level disk I/O API. +<url url="dio.html" name="Low-level disk I/O API">. <sect1><tt/dirent.h/<label id="dirent.h"><p> @@ -416,8 +415,8 @@ Low-level disk I/O API. <sect1><tt/o65.h/<label id="o65.h"><p> The <tt/o65.h/ header file contains structure and constant definitions that -may be used when dealing with files in <htmlurl -url="http://www.6502.org/users/andre/o65/fileformat.html" name="o65 format">. +may be used when dealing with files in <url +url="http://www.6502.org/users/andre/o65/fileformat.html" name="the o65 format">. It does not declare any functions. diff --git a/doc/geos.sgml b/doc/geos.sgml index d1604bc9c..aa3725bdf 100644 --- a/doc/geos.sgml +++ b/doc/geos.sgml @@ -6,7 +6,7 @@ <title>GEOSLib docs <author><url url="mailto:ytm@elysium.pl" name="Maciej Witkowiak"> -<date>v1.5, 26.12.1999, 2000, 2001, 2002, 2003, 2005 +<date>2014-04-11 <abstract> This is the documentation of cc65's GEOSLib, but information contained here may be also useful for writing GEOS applications in general. @@ -71,22 +71,19 @@ programs. The software needed: <itemize> <item><em/cc65/ Excellent package containing a C crosscompiler, a crossassembler and a linker, you - can get it from: <htmlurl url="http://www.cc65.org/" - name="http://www.cc65.org/"> + can get it from: <url url="http://cc65.github.io/cc65/">. <item><em/VICE/ This is a portable C64, C128 and few other Commodore computers emulator, you - can obtain it from: <htmlurl url="http://www.viceteam.org/" - name="http://www.viceteam.org/">. The VICE package contains the - c1541 program that is able to convert/unconvert GEOS files to disk images. + can obtain it from: <url url="http://vice-emu.sourceforge.net/">. + The VICE package contains the <em/c1541/ program that is able + to convert/unconvert GEOS files to disk images. <item><em/The Star Commander/ This tool is only for DOS. You will need it for transferring object files from a PC to a 1541. There's also one important ability of this tool - it automatically un-converts .cvt files into GEOS native format on - disk image files. Check out: <htmlurl url="http://sta.c64.org/sc.html" - name="http://sta.c64.org/sc.html"> - <item><em/cbm4linux/ A Linux kernel module that allows for communication with a 1541 and + disk image files. Check out: <url url="http://sta.c64.org/sc.html">. + <item><em/opencbm/ A package that allows for communication directly with a 1541 and other Commodore IEC bus drives. It can be a replacement for Star Commander if you only want to transfer files to a disk and unconvert using GEOS program for - this purpose. Check out: <htmlurl url="http://www.lb.shuttle.de/puffin/cbm4linux/" - name="http://www.lb.shuttle.de/puffin/cbm4linux"> + this purpose. Check out: <url url="http://opencbm.sourceforge.net/">. </itemize> <p> VICE and cc65 are portable - they run on variety of platforms - DOS, Win32 and UNIX. GEOSLib only diff --git a/doc/ld65.sgml b/doc/ld65.sgml index c92761c0a..f3a3930b2 100644 --- a/doc/ld65.sgml +++ b/doc/ld65.sgml @@ -3,7 +3,7 @@ <article> <title>ld65 Users Guide <author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> -<date>02.12.2000, 02.10.2001 +<date>2014-04-13 <abstract> The ld65 linker combines object files into an executable file. ld65 is highly @@ -840,7 +840,7 @@ look like this: </verb></tscreen> The only other available output format is the o65 format specified by Andre -Fachat (see the <htmlurl url="http://www.6502.org/users/andre/o65/fileformat.html" +Fachat (see the <url url="http://www.6502.org/users/andre/o65/fileformat.html" name="6502 binary relocation format specification">). It is defined like this: <tscreen><verb> @@ -859,7 +859,7 @@ The necessary o65 attributes are defined in a special section labeled The <tt/FORMAT/ section is used to describe file formats. The default (binary) format has currently no attributes, so, while it may be listed in this section, the attribute list is empty. The second supported format, -<htmlurl url="http://www.6502.org/users/andre/o65/fileformat.html" name="o65">, +<url url="http://www.6502.org/users/andre/o65/fileformat.html" name="o65">, has several attributes that may be defined here. <tscreen><verb> @@ -949,7 +949,7 @@ The <tt/CONDES/ feature has several attributes: Without specifying the <tt/CONDES/ feature, the linker will not create any tables, even if there are <tt/condes/ entries in the object files. -For more information see the <tt/.CONDES/ command in the <htmlurl +For more information see the <tt/.CONDES/ command in the <url url="ca65.html" name="ca65 manual">. diff --git a/doc/library.sgml b/doc/library.sgml index 16bd2dc5e..9b923c308 100644 --- a/doc/library.sgml +++ b/doc/library.sgml @@ -4,7 +4,7 @@ <title>cc65 Library Overview <author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> -<date>2000-12-02, 2002-11-26 +<date>2014-04-12 <abstract> An overview over the runtime and C libraries that come with the cc65 compiler, @@ -19,7 +19,7 @@ including a discussion of the differences to the ISO standard. <sect>Overview<p> This file contains a short overview of the libraries available for the cc65 C -compiler. Please have a look at the <htmlurl url="funcref.html" name="function +compiler. Please have a look at the <url url="funcref.html" name="function reference"> for a list function by function. Since the function reference is not complete (I'm working on that) it may happen that you don't find a specific function. In this case, have a look into the header files. All diff --git a/doc/lynx.sgml b/doc/lynx.sgml index 720c68af6..73763f1dd 100644 --- a/doc/lynx.sgml +++ b/doc/lynx.sgml @@ -6,7 +6,7 @@ <author> <url url="mailto:karri@sipo.fi" name="Karri Kaksonen">,<newline> <url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> -<date>2011-04-01 +<date>2014-04-12 <abstract> An overview over the Atari Lynx runtime system as it is implemented for the @@ -25,7 +25,7 @@ with the cc65 C compiler. It describes the memory layout, Lynx specific header files, available drivers, and any pitfalls specific to that platform. Please note that Lynx specific functions are just mentioned here, they are -described in detail in the separate <htmlurl url="funcref.html" name="function +described in detail in the separate <url url="funcref.html" name="function reference">. Even functions marked as "platform dependent" may be available on more than one platform. Please see the function reference for more information. diff --git a/doc/nes.sgml b/doc/nes.sgml index b40a0d30d..ca9ce72b3 100644 --- a/doc/nes.sgml +++ b/doc/nes.sgml @@ -6,7 +6,7 @@ <author> <url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">,<newline> <url url="mailto:polluks@sdf.lonestar.org" name="Stefan A. Haubenthal"> -<date>2005-07-17 +<date>2014-04-12 <abstract> An overview over the NES runtime system as it is implemented for the @@ -25,7 +25,7 @@ with the cc65 C compiler. It describes the memory layout, NES specific header files, available drivers, and any pitfalls specific to that platform. Please note that NES specific functions are just mentioned here, they are -described in detail in the separate <htmlurl url="funcref.html" name="function +described in detail in the separate <url url="funcref.html" name="function reference">. Even functions marked as "platform dependent" may be available on more than one platform. Please see the function reference for more information. diff --git a/doc/od65.sgml b/doc/od65.sgml index 1f237b006..f5611a889 100644 --- a/doc/od65.sgml +++ b/doc/od65.sgml @@ -3,11 +3,11 @@ <article> <title>od65 Users Guide <author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> -<date>2010-07-30 +<date>2014-04-14 <abstract> od65 is the object file dump utility. It is able to output most parts of -<htmlurl url="ca65.html" name="ca65"> generated object files in readable form. +<htmlurl url="ca65.html" name="ca65-generated"> object files in readable form. </abstract> <!-- Table of contents --> @@ -19,7 +19,7 @@ od65 is the object file dump utility. It is able to output most parts of <sect>Overview<p> od65 is an object file dump utility. It is able to output most parts of -<htmlurl url="ca65.html" name="ca65"> generated object files in readable form. +<htmlurl url="ca65.html" name="ca65-generated"> object files in readable form. Since the contents and format of the object files are not documented elsewhere and may change at any time, this tool is a portable way to look at the contents. diff --git a/doc/pet.sgml b/doc/pet.sgml index 01a88c67c..7c5bd71ea 100644 --- a/doc/pet.sgml +++ b/doc/pet.sgml @@ -6,7 +6,7 @@ <author> <url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">,<newline> <url url="mailto:polluks@sdf.lonestar.org" name="Stefan A. Haubenthal"> -<date>2014-03-26 +<date>2014-04-12 <abstract> An overview over the PET runtime system as it is implemented for the cc65 C @@ -155,8 +155,7 @@ The default drivers, <tt/joy_stddrv (joy_static_stddrv)/, point to <tt/pet-stdjo <tag><tt/pet-ptvjoy.joy (pet_ptvjoy_joy)/</tag> Driver for the Protovision 4-player adapter contributed by Groepaz. See - <htmlurl url="http://www.protovision-online.de/hardw/hardwstart.htm" - name="http://www.protovision-online.de/hardw/hardwstart.htm"> for prices and + <url url="http://www.protovision-online.de/hardw/hardwstart.htm"> for prices and building instructions. Up to two joysticks are supported. <tag><tt/pet-stdjoy.joy (pet_stdjoy_joy)/</tag> diff --git a/doc/plus4.sgml b/doc/plus4.sgml index 3a3da728a..36d53e753 100644 --- a/doc/plus4.sgml +++ b/doc/plus4.sgml @@ -4,7 +4,7 @@ <title>Commodore Plus/4 specific information for cc65 <author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> -<date>2003-12-14 +<date>2014-04-12 <abstract> An overview over the Plus/4 runtime system as it is implemented for the cc65 C @@ -23,13 +23,13 @@ cc65 C compiler. It describes the memory layout, Plus/4 specific header files, available drivers, and any pitfalls specific to that platform. Please note that Plus/4 specific functions are just mentioned here, they are -described in detail in the separate <htmlurl url="funcref.html" name="function +described in detail in the separate <url url="funcref.html" name="function reference">. Even functions marked as "platform dependent" may be available on more than one platform. Please see the function reference for more information. Since the Plus/4 and the Commodore 16/116 are almost identical (the latter are -missing the 6551 ACIA and do only have 16KB of memory), the <htmlurl +missing the 6551 ACIA and do only have 16KB of memory), the <url url="c16.html" name="C16 documentation"> is also worth a look. The difference between both cc65 targets is that the Plus/4 runtime uses banking to support full 64K RAM, while the C16 does not use banking and supports up to 32K RAM. @@ -95,7 +95,7 @@ There are currently no special Plus/4 functions. <sect1>CBM specific functions<p> Some functions are available for all (or at least most) of the Commodore -machines. See the <htmlurl url="funcref.html" name="function reference"> for +machines. See the <url url="funcref.html" name="function reference"> for declaration and usage. <itemize> @@ -232,7 +232,7 @@ The runtime for the Plus/4 uses routines marked as <tt/.INTERRUPTOR/ for interrupt handlers. Such routines must be written as simple machine language subroutines and will be called automatically by the interrupt handler code when they are linked into a program. See the discussion of the <tt/.CONDES/ -feature in the <htmlurl url="ca65.html" name="assembler manual">. +feature in the <url url="ca65.html" name="assembler manual">. diff --git a/doc/supervision.sgml b/doc/supervision.sgml index fcf05878e..97495dea5 100644 --- a/doc/supervision.sgml +++ b/doc/supervision.sgml @@ -4,7 +4,7 @@ <title>Watara Supervision specific information for cc65 <author><url url="mailto:polluks@sdf.lonestar.org" name="Stefan A. Haubenthal"> -<date>2005-07-17 +<date>2014-04-12 <abstract> An overview over the Supervision runtime system as it is implemented for the @@ -23,7 +23,7 @@ with the cc65 C compiler. It describes the memory layout, Supervision specific h files, available drivers, and any pitfalls specific to that platform. Please note that Supervision specific functions are just mentioned here, they are -described in detail in the separate <htmlurl url="funcref.html" name="function +described in detail in the separate <url url="funcref.html" name="function reference">. Even functions marked as "platform dependent" may be available on more than one platform. Please see the function reference for more information. @@ -92,7 +92,7 @@ allow access to hardware located in the address space. No graphics drivers are currently available for the Supervision. <!--A TGI driver for the standard graphics mode (160×160 in 4 colors) is available, but must be statically linked, because no file I/O is available. -See the documentation for the <htmlurl url="co65.html" name="co65 utility"> +See the documentation for the <url url="co65.html" name="co65 utility"> for information on how to do that.--> <sect1>Extended memory drivers<p> @@ -105,7 +105,7 @@ No extended memory drivers are currently available for the Supervision. No joystick drivers are currently available for the Supervision. <!--A joystick driver for the standard buttons is available, but must be statically linked, because no file I/O is available. See the documentation for -the <htmlurl url="co65.html" name="co65 utility"> for information on how to do +the <url url="co65.html" name="co65 utility"> for information on how to do that.--> <sect1>Mouse drivers<p> diff --git a/doc/using-make.sgml b/doc/using-make.sgml index f104379f0..0c3c13a6e 100644 --- a/doc/using-make.sgml +++ b/doc/using-make.sgml @@ -4,7 +4,7 @@ <title>Using GNU Make with cc65 <author><url url="mailto:ol.sc@web.de" name="Oliver Schmidt"> -<date>2009-06-26 +<date>2014-04-12 <abstract> How to build your program using the GNU Make utility. @@ -114,10 +114,10 @@ of creating a <tt/CC65_HOME/ environment variable. <sect1>Understanding the sample Makefile<p> Most parts of the sample Makefile follow the guidelines in the -<htmlurl url="http://www.gnu.org/software/make/manual/make.html" name="GNU Make Manual"> +<url url="http://www.gnu.org/software/make/manual/make.html" name="GNU Make Manual"> that can be searched online for background information. The automatic generation of dependency however rather works as described by the GNU Make maintainer Paul D. Smith in -<htmlurl url="http://make.paulandlesley.org/autodep.html#advanced" name="Advanced Auto-Dependencies">. +<url url="http://make.paulandlesley.org/autodep.html#advanced" name="&dquot;Advanced Auto-Dependencies&dquot;">. Fortunately both GCC and cc65 directly support this method in the meantime. @@ -133,8 +133,8 @@ then the sample Makefile may be invoked from the Windows Command Prompt (cmd.exe by downloading the following programs: <itemize> -<item>make.exe: <url url="http://gnuwin32.sourceforge.net/packages/make.htm"> -<item>rm.exe: <url url="http://gnuwin32.sourceforge.net/packages/coreutils.htm"> +<item><url name="make.exe" url="http://gnuwin32.sourceforge.net/packages/make.htm"> +<item><url name="rm.exe" url="http://gnuwin32.sourceforge.net/packages/coreutils.htm"> </itemize> @@ -144,9 +144,9 @@ by downloading the following programs: The very limited resources of the cc65 target machines now and then require manual optimization of the build process by compiling individual source files with different compiler options. GNU Make offers -<htmlurl url="http://www.gnu.org/software/make/manual/html_node/Target_002dspecific.html" name="Target-specific Variable Values"> +<url url="http://www.gnu.org/software/make/manual/html_node/Target_002dspecific.html" name="Target-specific Variable Values"> perfectly suited for doing so. For example placing the code of the two modules -<tt/foo/ and <tt/bar/ in the segment <tt/FOOBAR/ can be archived with this +<tt/foo/ and <tt/bar/ in the segment <tt/FOOBAR/ can be achieved with this target-specific variable definition: <tscreen><verb> diff --git a/doc/vic20.sgml b/doc/vic20.sgml index ce58dad50..5fba59a13 100644 --- a/doc/vic20.sgml +++ b/doc/vic20.sgml @@ -6,7 +6,7 @@ <author> <url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">,<newline> <url url="mailto:polluks@sdf.lonestar.org" name="Stefan A. Haubenthal"> -<date>2014-03-26 +<date>2014-04-12 <abstract> An overview over the VIC20 runtime system as it is implemented for the cc65 C @@ -161,8 +161,7 @@ The default drivers, <tt/joy_stddrv (joy_static_stddrv)/, point to <tt/vic20-std <tag><tt/vic20-ptvjoy.joy (vic20_ptvjoy_joy)/</tag> Driver for the Protovision 4-player adapter contributed by Groepaz. See - <htmlurl url="http://www.protovision-online.de/hardw/hardwstart.htm" - name="http://www.protovision-online.de/hardw/hardwstart.htm"> for prices and + <url url="http://www.protovision-online.de/hardw/hardwstart.htm"> for prices and building instructions. Up to three joysticks are supported. </descrip><p>