]> git.sur5r.net Git - cc65/blob - doc/apple2enh.sgml
Implemented the requested changes.
[cc65] / doc / apple2enh.sgml
1 <!doctype linuxdoc system>
2
3 <article>
4
5 <title>Enhanced&nbsp;Apple&nbsp;//e specific information for cc65
6 <author><url url="mailto:ol.sc@web.de" name="Oliver Schmidt">
7 <date>2014-04-10
8
9 <abstract>
10 An overview over the enhanced&nbsp;Apple&nbsp;//e runtime system as it is
11 implemented for the cc65 C compiler.
12 </abstract>
13
14 <!-- Table of contents -->
15 <toc>
16
17 <!-- Begin the document -->
18
19 <sect>Overview<p>
20
21 This file contains an overview of the enhanced&nbsp;Apple&nbsp;//e runtime system
22 as it comes with the cc65 C compiler. It describes the memory layout,
23 enhanced&nbsp;Apple&nbsp;//e specific header files, available drivers, and any
24 pitfalls specific to that platform.
25
26 Please note that enhanced&nbsp;Apple&nbsp;//e specific functions are just mentioned
27 here, they are described in detail in the separate <url url="funcref.html"
28 name="function reference">. Even functions marked as "platform dependent" may
29 be available on more than one platform. Please see the function reference for
30 more information.
31
32
33
34 <sect>Binary format<p>
35
36 The standard binary file format generated by the linker for the
37 enhanced&nbsp;Apple&nbsp;//e target is a binary program with a 4 byte DOS 3.3 header
38 containing the load address and load length. The default load address is
39 &dollar;803.
40
41 <bf/AppleCommander 1.3.5/ or later (available at <url
42 url="http://applecommander.sourceforge.net/">) includes the option <tt/-cc65/
43 that allows to put binary files with a DOS 3.3 header onto disk images
44 containing DOS 3.3 as well as ProDOS 8.
45
46 For ProDOS 8 system programs the load address is fixed to &dollar;2000 so there
47 is no need for a header. Thus the linker configuration
48 <ref id="apple-sys-cfg" name="apple2enh-system.cfg"> for those programs
49 omits the DOS 3.3 header. The right AppleCommander option to put system files
50 without a header on a ProDOS 8 disk image is <tt/-p/.
51
52
53 <sect>Memory layout<p>
54
55 In the standard setup, cc65 generated programs use the memory from
56 &dollar;803 to &dollar;95FF, so 35.5 KB of RAM are available.
57
58 Special locations:
59
60 <descrip>
61
62   <tag/Stack/
63   The C runtime stack is located at HIMEM and grows downwards, regardless of
64   how your linker config file is setup.
65
66   <tag/Heap/
67   The C heap is located at the end of the program and grows towards the C
68   runtime stack.
69
70 </descrip><p>
71
72 While running <tt/main()/ the Language Card bank 2 is enabled for read access.
73 However while running module constructors/destructors the Language Card is disabled.
74
75 Enabling the Language Card allows to use it as additional memory for cc65
76 generated code. However code is never automatically placed there. Rather code
77 needs to be explicitly placed in the Language Card either per file by compiling
78 with <tt/--code-name LC/ or per function by enclosing in <tt/#pragma code-name
79 (push, "LC")/ and <tt/#pragma code-name (pop)/. In either case the cc65 runtime
80 system takes care of actually moving the code into the Language Card.
81
82 The amount of memory available in the Language Card for generated code depends
83 on the <ref id="link-configs" name="linker configuration"> parameters. There are
84 several usefull settings:
85
86 <descrip>
87
88   <tag>LC address: &dollar;D400, LC size: &dollar;C00</tag>
89   For plain vanilla ProDOS 8 which doesn't actually use the Language Card bank 2
90   memory from &dollar;D400 to &dollar;DFFF. This is the default setting.
91
92   <tag>LC address: &dollar;D000, LC size: &dollar;1000</tag>
93   For ProDOS 8 together with the function <tt/rebootafterexit()/. If a program
94   doesn't quit to the ProDOS 8 dispatcher but rather reboots the machine after
95   exit then a plain vanilla ProDOS 8 doesn't make use of the Language Card bank
96   2 at all.
97
98   <tag>LC address: &dollar;D000, LC size: &dollar;3000</tag>
99   For plain vanilla DOS 3.3 which doesn't make use of the Language Card at all.
100
101 </descrip><p>
102
103
104
105 <sect>Linker configurations<label id="link-configs"><p>
106
107 The ld65 linker comes with a default config file for the enhanced&nbsp;Apple&nbsp;//e,
108 which is used via <tt/-t apple2enh/.
109 The apple2enh package comes with additional secondary linker config files, which
110 are used via <tt/-t apple2enh -C &lt;configfile&gt;/.
111
112
113 <sect1>default config file (<tt/apple2enh.cfg/)<label id="apple-def-cfg"><p>
114
115 Default configuration for a binary program.
116
117 Parameters:
118
119 <descrip>
120
121   <tag><tt/STARTADDRESS:/ Program start address</tag>
122   Default: &dollar;803. Use <tt/-S &lt;addr&gt;/ to set a different start address.
123
124   <tag><tt/__EXEHDR__:/ Executable file header</tag>
125   Default: DOS 3.3 header (address and length). Use <tt/-D __EXEHDR__=0/ to omit
126   the header.
127
128   <tag><tt/__STACKSIZE__:/ C runtime stack size</tag>
129   Default: &dollar;800. Use <tt/-D __STACKSIZE__=&lt;size&gt;/ to set a different
130   stack size.
131
132   <tag><tt/__HIMEM__:/ Highest usable memory address presumed at link time</tag>
133   Default: &dollar;9600. Use <tt/-D __HIMEM__=&lt;addr&gt;/ to set a different
134   highest usable address.
135
136   <tag><tt/__LCADDR__:/ Address of code in the Language Card</tag>
137   Default: &dollar;D400. Use <tt/-D __LCADDR__=&lt;addr&gt;/ to set a different
138   code address.
139
140   <tag><tt/__LCSIZE__:/ Size of code in the Language Card</tag>
141   Default: &dollar;C00. Use <tt/-D __LCSIZE__=&lt;size&gt;/ to set a different
142   code size.
143
144 </descrip><p>
145
146
147 <sect1><tt/apple2enh-system.cfg/<label id="apple-sys-cfg"><p>
148
149 Configuration for a system program running on ProDOS 8 and using the memory from
150 &dollar;2000 to &dollar;BEFF.
151
152 Parameters:
153
154 <descrip>
155
156   <tag><tt/__STACKSIZE__:/ C runtime stack size</tag>
157   Default: &dollar;800. Use <tt/-D __STACKSIZE__=&lt;size&gt;/ to set a different
158   stack size.
159
160   <tag><tt/__LCADDR__:/ Address of code in the Language Card</tag>
161   Default: &dollar;D400. Use <tt/-D __LCADDR__=&lt;addr&gt;/ to set a different
162   code address.
163
164   <tag><tt/__LCSIZE__:/ Size of code in the Language Card</tag>
165   Default: &dollar;C00. Use <tt/-D __LCSIZE__=&lt;size&gt;/ to set a different
166   code size.
167
168 </descrip><p>
169
170
171 <sect1><tt/apple2enh-overlay.cfg/<p>
172
173 Configuration for overlay programs with the up to nine overlays. The overlay files
174 don't include the DOS 3.3 header. See <tt>samples/overlaydemo.c</tt> for more
175 information on overlays.
176
177 Parameters:
178
179 <descrip>
180
181   <tag><tt/STARTADDRESS:/ Program start address</tag>
182   Default: &dollar;803. Use <tt/-S &lt;addr&gt;/ to set a different start address.
183
184   <tag><tt/__EXEHDR__:/ Executable file header</tag>
185   Default: DOS 3.3 header (address and length). Use <tt/-D __EXEHDR__=0/ to omit
186   the header.
187
188   <tag><tt/__STACKSIZE__:/ C runtime stack size</tag>
189   Default: &dollar;800. Use <tt/-D __STACKSIZE__=&lt;size&gt;/ to set a different
190   stack size.
191
192   <tag><tt/__HIMEM__:/ Highest usable memory address presumed at link time</tag>
193   Default: &dollar;9600. Use <tt/-D __HIMEM__=&lt;addr&gt;/ to set a different
194   highest usable address.
195
196   <tag><tt/__LCADDR__:/ Address of code in the Language Card</tag>
197   Default: &dollar;D400. Use <tt/-D __LCADDR__=&lt;addr&gt;/ to set a different
198   code address.
199
200   <tag><tt/__LCSIZE__:/ Size of code in the Language Card</tag>
201   Default: &dollar;C00. Use <tt/-D __LCSIZE__=&lt;size&gt;/ to set a different
202   code size.
203
204   <tag><tt/__OVERLAYSIZE__:/ Size of code in the overlays</tag>
205   Default: &dollar;1000. Use <tt/-D __OVERLAYSIZE__=&lt;size&gt;/ to set a different
206   code size.
207
208 </descrip><p>
209
210
211 <sect1><tt/apple2enh-asm.cfg/<p>
212
213 Configuration for a assembler programs which don't need a special setup.
214
215 Parameters:
216
217 <descrip>
218
219   <tag><tt/STARTADDRESS:/ Program start address</tag>
220   Default: &dollar;803. Use <tt/-S &lt;addr&gt;/ to set a different start address.
221
222   <tag><tt/__EXEHDR__:/ Executable file header</tag>
223   Default: No header. Use <tt/-u __EXEHDR__ apple2enh.lib/ to add a DOS 3.3 header
224   (address and length).
225
226 </descrip><p>
227
228
229
230 <sect>ProDOS 8 system programs<p>
231
232 ProDOS 8 system programs are always loaded to the start address &dollar;2000.
233 For cc65 programs this means that the 6 KB from &dollar;800 to &dollar;2000 are
234 by default unused. There are however several options to make use of that memory
235 range.
236
237
238 <sect1>LOADER.SYSTEM<p>
239
240 The easiest (and for really large programs in fact the only) way to have a cc65
241 program use the memory from &dollar;800 to &dollar;2000 is to link it as binary
242 (as opposed to system) program using the default linker configuration
243 <ref id="apple-def-cfg" name="apple2enh.cfg"> with <tt/__HIMEM__/set to &dollar;BF00
244 and load it with the LOADER.SYSTEM utility. The program then works like a system
245 program (i.e. quits to the ProDOS dispatcher).
246
247 Using LOADER.SYSTEM is as simple as copying it to the ProDOS 8 directory of the
248 program to load under name &lt;program&gt;.SYSTEM as a system program. For
249 example the program <tt/MYPROG/ is loaded by <tt/MYPROG.SYSTEM/.
250
251
252 <sect1>Heap<p>
253
254 If the cc65 program can be successfully linked as system program using the linker
255 configuration <ref id="apple-sys-cfg" name="apple2enh-system.cfg">, but
256 uses the heap either explicitly or implicitly (i.e. by loading a driver) then
257 the memory from &dollar;800 to &dollar;2000 can be added to the heap by calling
258 <tt/_heapadd ((void *) 0x0800, 0x1800);/ at the beginning of <tt/main()/.
259
260
261 <sect1>ProDOS 8 I/O buffers<p>
262
263 ProDOS 8 requires for every open file a page-aligned 1 KB I/O buffer. By default
264 these buffers are allocated by the cc65 runtime system on the heap using
265 <tt/posix_memalign()/. While this is generally the best solution it means quite
266 some overhead for (especially rather small) cc65 programs which do open files
267 but don't make use of the heap otherwise.
268
269 The apple2enh package comes with the alternative ProDOS 8 I/O buffer allocation
270 module <tt/apple2enh-iobuf-0800.o/ which uses the memory between &dollar;800 and
271 the program start address for the 1 KB I/O buffers. For system programs (with
272 start address &dollar;2000) this results in up to 6 I/O buffers and thus up to 6
273 concurrently open files.
274
275 While using <tt/_heapadd()/ as described in the section above together with the
276 default I/O buffer allocation basically yields the same placement of I/O buffers
277 in memory the primary benefit of <tt/apple2enh-iobuf-0800.o/ is a reduction in code
278 size - and thus program file size - of more than 1400 bytes.
279
280 Using <tt/apple2enh-iobuf-0800.o/ is as simple as placing it on the linker command
281 line like this:
282
283 <tscreen><verb>
284 cl65 -t apple2enh -C apple2enh-system.cfg myprog.c apple2enh-iobuf-0800.o
285 </verb></tscreen>
286
287
288
289 <sect>Platform specific header files<p>
290
291 Programs containing enhanced&nbsp;Apple&nbsp;//e specific code may use the
292 <tt/apple2enh.h/ header file.
293
294
295 <sect1>Enhanced&nbsp;Apple&nbsp;//e specific functions<p>
296
297 The functions listed below are special for the enhanced&nbsp;Apple&nbsp;//e. See
298 the <url url="funcref.html" name="function reference"> for declaration and
299 usage.
300
301 <itemize>
302 <item>_auxtype
303 <item>_dos_type
304 <item>_filetype
305 <item>get_ostype
306 <item>rebootafterexit
307 <item>ser_apple2_slot
308 <item>textframe
309 <item>textframexy
310 <item>tgi_apple2_mix
311 <item>videomode
312 </itemize>
313
314
315 <sect1>Hardware access<p>
316
317 There's currently no support for direct hardware access. This does not mean
318 you cannot do it, it just means that there's no help.
319
320
321
322 <sect>Loadable drivers<p>
323
324 The names in the parentheses denote the symbols to be used for static linking of the drivers.
325
326
327 <sect1>Graphics drivers<p>
328
329 <descrip>
330
331   <tag><tt/a2e.lo.tgi (a2e_lo_tgi)/</tag>
332   This driver features a resolution of 40&times;48 with 16 colors.
333
334   The function <tt/tgi_apple2_mix()/ allows to activate 4 lines of text. The
335   function clears the corresponding area at the bottom of the screen.
336
337   <tag><tt/a2e.hi.tgi (a2e_hi_tgi)/</tag>
338   This driver features a resolution of 280&times;192 with 8 colors and two
339   hires pages. Note that programs using this driver will have to be linked
340   with <tt/-S $4000/ to reserve the first hires page or with <tt/-S $6000/
341   to reserve both hires pages.
342
343   Note that the second hires page is only available if the text display is not in
344   80 column mode. This can be asserted by calling <tt/videomode (VIDEOMODE_40COL);/
345   before installing the driver.
346
347   The function <tt/tgi_apple2_mix()/ allows to activate 4 lines of text. The
348   function doesn't clear the corresponding area at the bottom of the screen.
349
350   In memory constrained situations the memory from &dollar;803 to &dollar;1FFF
351   can be made available to a program by calling <tt/_heapadd ((void *) 0x0803, 0x17FD);/
352   at the beginning of <tt/main()/. Doing so is beneficial even if the program
353   doesn't use the the heap explicitly because loading the driver (and in fact
354   already opening the driver file) uses the heap implicitly.
355
356 </descrip><p>
357
358
359 <sect1>Extended memory drivers<p>
360
361 <descrip>
362
363   <tag><tt/a2e.auxmem.emd (a2e_auxmem_emd)/</tag>
364   Gives access to 47.5 KB RAM (190 pages of 256 bytes each) on an Extended
365   80-Column Text Card.
366
367   Note that this driver doesn't check for the actual existence of the memory
368   and that it doesn't check for ProDOS 8 RAM disk content!
369
370 </descrip><p>
371
372
373 <sect1>Joystick drivers<p>
374
375 <descrip>
376
377   <tag><tt/a2e.stdjoy.joy (a2e_stdjoy_joy)/</tag>
378   Supports up to two standard analog joysticks connected to the game port of
379   the enhanced&nbsp;Apple&nbsp;//e.
380
381 </descrip><p>
382
383
384 <sect1>Mouse drivers<p>
385
386 <descrip>
387
388   <tag><tt/a2e.stdmou.mou (a2e_stdmou_mou)/</tag>
389   Driver for the AppleMouse&nbsp;II Card. Searches all Apple&nbsp;II slots
390   for an AppleMouse&nbsp;II Card compatible firmware. The default bounding
391   box is &lsqb;0..279,0..191&rsqb;.
392
393   Note that the enhanced&nbsp;Apple&nbsp;//e default mouse callbacks support
394   text mode only.
395
396 </descrip><p>
397
398
399 <sect1>RS232 device drivers<p>
400
401 <descrip>
402
403   <tag><tt/a2e.ssc.ser (a2e_ssc_ser)/</tag>
404   Driver for the Apple&nbsp;II Super Serial Card. Supports up to 19200 baud,
405   hardware flow control (RTS/CTS) and interrupt driven receives. Note
406   that because of the peculiarities of the 6551 chip transmits are not
407   interrupt driven, and the transceiver blocks if the receiver asserts
408   flow control because of a full buffer.
409
410   The driver defaults to slot 2. Call <tt/ser_apple2_slot()/ prior to
411   <tt/ser_open()/ in order to select a different slot. <tt/ser_apple2_slot()/
412   succeeds for all Apple&nbsp;II slots, but <tt/ser_open()/ fails with
413   <tt/SER_ERR_NO_DEVICE/ if there's no SSC firmware found in the selected slot.
414
415 </descrip><p>
416
417
418
419 <sect>Limitations<p>
420
421
422 <sect1>DOS 3.3<p>
423
424 Although the standard binaries generated by the linker for the enhanced&nbsp;Apple&nbsp;//e
425 generally run both on DOS 3.3 (with Applesoft BASIC) and on ProDOS 8 (with
426 BASIC.SYSTEM) there are some limitations for DOS 3.3:
427
428 <descrip>
429
430   <tag>Disk File I/O</tag>
431   There's no disk file I/O support. Any attempt to use it yields an error with
432   <tt/errno/ set to <tt/ENOSYS/. This implicitly means that loadable drivers
433   are in general not functional as they depend on disk file I/O. Therefore the statically
434   linked drivers have to be used instead.
435
436   <tag/Interrupts/
437   There's no <tt/interruptor/ support. Any attempt to use it yields the message
438   'Failed to alloc interrupt' on program startup. This implicitly means that
439   joystick, mouse and RS232 device drivers are not functional as they depend on
440   interrupts.
441
442 </descrip><p>
443
444
445 <sect1>Direct console I/O<p>
446
447 <descrip>
448
449   <tag/Color/
450   The enhanced&nbsp;Apple&nbsp;//e has no color text mode. Therefore the functions
451   textcolor(), bgcolor() and bordercolor() have no effect.
452
453 </descrip><p>
454
455
456
457 <sect>Other hints<p>
458
459
460 <sect1>Passing arguments to the program<p>
461
462 Command line arguments can be passed to <tt/main()/ after BLOAD. Since this is not
463 supported by BASIC, the following syntax was chosen:
464
465 <tscreen><verb>
466 ]CALL2051:REM ARG1 " ARG2 IS QUOTED" ARG3 "" ARG5
467 </verb></tscreen>
468
469 <enum>
470 <item>Arguments are separated by spaces.
471 <item>Arguments may be quoted.
472 <item>Leading and trailing spaces around an argument are ignored. Spaces within
473       a quoted argument are allowed.
474 <item>The first argument passed to <tt/main/ is the program name.
475 <item>A maximum number of 10 arguments (including the program name) are
476       supported.
477 </enum>
478
479
480 <sect1>Function keys<p>
481
482 These are defined to be OpenApple + number key.
483
484
485 <sect1>Interrupts<p>
486
487 The runtime for the enhanced&nbsp;Apple&nbsp;//e uses routines marked as
488 <tt/.INTERRUPTOR/ for ProDOS 8 interrupt handlers. Such routines must be
489 written as simple machine language subroutines and will be called
490 automatically by the interrupt handler code when they are linked into a
491 program. See the discussion of the <tt/.CONDES/ feature in the <url
492 url="ca65.html" name="assembler manual">.
493
494
495 <sect1>DIO<p>
496
497 <descrip>
498
499   <tag/Drive ID/
500   The function <url url="dio.html#s1" name="dio_open()"> has the single
501   parameter <tt/device/ to identify the device to be opened. Therefore an
502   Apple&nbsp;II slot and drive pair is mapped to that <tt/device/ according
503   to the formula
504
505   <tscreen>
506     device = slot + (drive - 1) * 8
507   </tscreen>
508
509   so that for example slot 6 drive 2 is mapped to <tt/device/ 14.
510
511   <tag/Sector count/
512   The function <url url="dio.html#s3" name="dio_query_sectcount()"> returns
513   the correct sector count for all ProDOS 8 disks. However for any non-ProDOS 8
514   disk it simply always returns 280 (which is only correct for a 140 KB disk).
515   This condition is indicated by the <tt/_oserror/ value 82.
516
517 </descrip><p>
518
519
520 <sect1>Specifying file types for fopen<p>
521
522 <descrip>
523
524   <tag>Explanation of File Types</tag>
525
526   ProDOS associates a file type and an auxiliary type with each file.
527   These type specifications are separate from the file's name, unlike
528   Windows which uses the file name's suffix (a.k.a.
529   extension) to specify the file type. For example, <tt/.exe/, 
530   <tt/.doc/, or <tt/.bat/.
531   The ProDOS low-level 
532   Machine-Language Interface (MLI) functions for creating and opening 
533   files require these types to be specified. And if they don't match
534   with the file being opened, the operation may fail.
535
536   In contrast, the ISO C function <tt/fopen()/ and the POSIX function
537   <tt/open()/ have no parameter to specify either a file type or an
538   auxiliary type. Therefore, some additional mechanism for specifying
539   the file types is needed. 
540   
541   <tag>Specifying the File Type and Auxiliary Type</tag>
542
543   There are two global variables provided that allow the file type
544   and auxiliary type to be specified before a call to <tt/fopen()/
545   or <tt/open()/. They are defined in <tt/apple2_filetype.h/:
546
547   <tscreen>
548   <verb>
549   extern unsigned char _filetype;  /* Default: PRODOS_T_BIN */
550   extern unsigned int _auxtype;    /* Default: 0            */
551   </verb>
552   </tscreen>  
553
554   The header file <tt/apple2_filetype.h/ also defines many values
555   that can be used to set these variables. It is included in
556   <tt/apple2.h/, which is in turn included in <tt/apple2enh.h/.
557   So it isn't necessary to include it directly. Just
558   include one of <tt/apple2.h/ or <tt/apple2enh.h/.
559
560   <tag>Example</tag>
561
562   A text file cannot be created with just the
563   standard C functions because they default to the binary type 
564   <tt/PRODOS_T_BIN/. The <tt/_filetype/ variable must be set to
565   <tt/PRODOS_T_TXT/ to create a text file. 
566   
567   For a text file, 
568   <tt/_auxtype/ specifies the record length. A zero record
569   length text file is referred to as a sequential text file.
570   This is equivalent to text files on 
571   other operating systems, except that the line terminator is a
572   carriage return instead of a line-feed (Linux/BSD/MacOS) or 
573   carriage return, line-feed pair (Windows).
574   
575   The "sequential" text file terminology is in contrast to a 
576   "random-access" text file which would
577   have a fixed-length, non-zero record length, so that the 
578   file position of any individual record can be calculated.
579   
580   For this example, the
581   <tt/_auxtype/ does not need to be set because it defaults to
582   the desired value, which is zero. To be more explicit, 
583   <tt/_auxtype/ can also be set to <tt/PRODOS_AUX_T_TXT_SEQ/
584   which is defined as zero.
585
586   <tscreen>
587   <verb>
588     &num;include &lt;stdio.h&gt;
589     &num;include &lt;string.h&gt;
590     &num;include &lt;errno.h&gt;
591     &num;include &lt;apple2.h&gt;
592
593     void main(void)
594     {
595         FILE *out;
596         char *name = "MY.FAVS";
597
598         /*-----------------------------*/
599
600         _filetype = PRODOS_T_TXT;
601         _auxtype  = PRODOS_AUX_T_TXT_SEQ;
602
603         /*-----------------------------*/
604
605         if ((out = fopen(name, "w")) != NULL) {
606             fputs("Jorah Mormont\r", out);
607             fputs("Brienne of Tarth\r", out);
608             fputs("Daenerys Targaryen\r", out);
609             fputs("Sandor Clegane\r", out);
610             if (fclose(out) == EOF) {
611                 fprintf(stderr, "fclose failed for %s: %s", name, strerror(errno));
612             }
613         }
614         else {
615             fprintf(stderr, "fopen failed for %s: %s", name, strerror(errno));
616         }
617     }
618   </verb>
619   </tscreen>  
620
621 </descrip><p>
622
623
624 <sect>License<p>
625
626 This software is provided 'as-is', without any expressed or implied
627 warranty. In no event will the authors be held liable for any damages
628 arising from the use of this software.
629
630 Permission is granted to anyone to use this software for any purpose,
631 including commercial applications, and to alter it and redistribute it
632 freely, subject to the following restrictions:
633
634 <enum>
635 <item>  The origin of this software must not be misrepresented; you must not
636         claim that you wrote the original software. If you use this software
637         in a product, an acknowledgment in the product documentation would be
638         appreciated but is not required.
639 <item>  Altered source versions must be plainly marked as such, and must not
640         be misrepresented as being the original software.
641 <item>  This notice may not be removed or altered from any source
642         distribution.
643 </enum>
644
645 </article>