]> git.sur5r.net Git - cc65/blobdiff - samples/README
New optimization step
[cc65] / samples / README
index 7b350c31085556e351db01a409dbf39893aa40a4..c5136517d047270a72c8e68c3d2350ce3149fc00 100644 (file)
@@ -1,4 +1,4 @@
-                                      
+
 This directory contains sample programs for the cc65 compiler.
 
 Below is a short description for each of the programs together with a list of
@@ -6,9 +6,9 @@ the supported platforms.
 
 Please note:
 
-  * The supplied makefile needs with GNU make. It works out of the box on
-    Linux and similar systems. If you're using Windows, you will have to
-    compile the programs manually.
+  * The supplied makefile needs GNU make. It works out of the box on Linux
+    and similar systems. If you're using Windows, you will have to compile
+    the programs manually.
 
   * The makefile specifies the C64 as the default target platform, because all
     of the programs run on this platform. When compiling for another platform,
@@ -18,12 +18,35 @@ Please note:
 
 List of supplied sample programs:
 
+-----------------------------------------------------------------------------
+Name:           ascii
+Description:   Shows the ASCII (or ATASCII, PETSCII) codes of typed
+               characters. Written and contributed by Greg King
+               <gngking@erols.com>.
+Platforms:             All platforms with conio or stdio (compile time
+               configurable).
+
 -----------------------------------------------------------------------------
 Name:           fire
 Description:   Another graphics demo written by groepaz/hitmen.
 Platforms:             The program is currently only running on the C64, but should
                be portable to the C128 and CBM510 (and maybe more machines).
 
+-----------------------------------------------------------------------------
+Name:           diodemo
+Description:   A disc copy program written and contributed by Oliver
+                Schmidt, <ol.sc@web.de>. Supports single or dual disc copy.
+Platforms:             The program does depend on conio and dio (direct disk i/o),
+                so it does currently compile for the Atari and Apple ][
+                machines.
+
+-----------------------------------------------------------------------------
+Name:           gunzip65
+Description:   A gunzip utility for 6502 based machines written by Piotr
+                Fusik <fox@scene.pl>.
+Platforms:             Runs on all platforms with file I/O (currently the Atari and
+                most Commodore machines).
+
 -----------------------------------------------------------------------------
 Name:          hello
 Description:   A nice "Hello world" type program that uses the conio
@@ -31,11 +54,19 @@ Description:        A nice "Hello world" type program that uses the conio
 Platforms:     Runs on all platforms that support conio, which means:
                Apple ][, Atari, C16, C64, C128, CBM510, CBM610, PET, Plus/4
 
+-----------------------------------------------------------------------------
+Name:           mandelbrot
+Description:   A mandelbrot demo using integer arithmetic. The demo was
+                written by groepaz/hitmen and converted to cc65 using TGI
+                graphics by Stephan Haubenthal.
+Platforms:     All systems with TGI support. You may have to change the
+                driver/resolution definition in the source.
+
 -----------------------------------------------------------------------------
 Name:           mousedemo
 Description:   Shows how to use the mouse.
-Platforms:     All systems with mouse and conio support:
-               Atari (untested), C64, C128 and CBM510
+Platforms:             All systems with mouse and conio support:
+               C64, C128, CBM510, Atari, Apple2
 
 -----------------------------------------------------------------------------
 Name:           nachtm
@@ -47,8 +78,9 @@ Platforms:    All systems that have the Commodore SID (Sound Interface
 -----------------------------------------------------------------------------
 Name:           plasma
 Description:   A fancy graphics demo written by groepaz/hitmen.
-Platforms:             The program needs a VIC, so it runs on the following systems:
-               C64, C128, CBM510
+Platforms:             The program needs a VIC, or a TED, so it runs on the following
+                systems:
+               C64, C128, CBM510, Plus/4
 
 -----------------------------------------------------------------------------
 Name:           sieve
@@ -57,10 +89,11 @@ Description:        Implements the "Sieve of Eratosthenes" as a way to find all
                a benchmark program.
 Platforms:     All systems with conio and clock support:
                Atari, C16, C64, C128, CBM510, CBM610, PET, Plus/4
+
 -----------------------------------------------------------------------------
 Name:           tgidemo
 Description:   Shows some of the graphics capabilities of the "tiny graphics
                interface".
 Platforms:     Runs on all platforms that have TGI support:
-               C64
+               Apple ][, C64, C128, Oric Atmos, Geos and Lynx.