JRH's RKRM Examples (Part Two)
==============================

(Part One of my RKRM translations are available from the same place
you got this, or as part of the v3.2a distribution of Amiga E.)

This archive contains translations of all the examples from the
following chapters of the RKRM (Libraries): Expansion, Graphics (all
the corresponding chapters), IFFParse, Keymap, Math (minus the FFP
examples) and Utility.  Also included are translations of all the
examples from the following chapters of the RKRM (Devices): Clipboard
and Console.

The examples retain most of the original comments, with comments
specific to these E versions beginning "-> E-Note:".  A lot of effort
has been put into showing how to effectively use E features such as
exceptions and lists.  A number of bugs in the original examples have
also been eliminated.

If you are new to E you should pay special attention to the effect of
using exceptions: error handling and clean-up are neatly separated
from the main code, and the code is generally much less indented.  You
should also notice the special care taken to initialise variables
appropriately so that clean-up is made much more simple in the
handlers.

Two standard support modules have been bug-fixed and included with
this archive.  They are 'tools/longreal' and 'tools/inithook' (which
is a replacement for 'tools/installhook').  The 'longreal' module had
the following problem: dFormat() did not print negative floats
properly (especially fractions between -1 and 0).  The 'installhook'
module needlessly used the 'data' element of a hook for its own
purposes.  'inithook' does not do this, and allows you to use an
optional third argument to specify the 'data' for your hook.

If you wish to recompile the sources (I expect you might...), you will
need my Typed Modules (V40), my AmigaLib modules and my UsefulV2
modules.  These archives should all be available where you found this
archive (Aminet? In 'dev/e'?.  Most are also part of the v3.2a
distribution of Amiga E.

These executables, E sources and E modules are all Copyright (C) 1995,
Jason R. Hulance.
The original RKRM examples are Copyright (C) 1992, Commodore-Amiga Inc.

You are free to use the files in this archive to help create your own
programs (whether they are freeware or commercial), but if you wish to
distribute any part of this archive you must include it all,
unmodified, and with this file.

(Hopefully, there will be a Part Three which will contain the
remainder of the RKRM examples.)

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
-rw-r--r--   748/102      1276    2651  48.1% -lh5- f13c Sep 21  1995 JRH-RKRM-2.readme
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 Modules/
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 Modules/Tools/
-rw-r--r--   748/102       141     178  79.2% -lh5- fab4 Sep 20  1995 Modules/Tools/inithook.m
-rw-r--r--   748/102      1937    6846  28.3% -lh5- 5f5a Sep 20  1995 Modules/Tools/longreal.m
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/Clipboard/
-rw-r--r--   748/102      2948    8230  35.8% -lh5- f307 Sep 20  1995 RKRM_PartTwo/Clipboard/cbio.e
-rw-r--r--   748/102      1259    2948  42.7% -lh5- aabf Sep 20  1995 RKRM_PartTwo/Clipboard/cbio.m
-rw-r--r--   748/102      2313    4988  46.4% -lh5- 6ad1 Sep 20  1995 RKRM_PartTwo/Clipboard/changehook_test
-rw-r--r--   748/102       956    2216  43.1% -lh5- 528d Sep 20  1995 RKRM_PartTwo/Clipboard/changehook_test.e
-rw-r--r--   748/102      3406    7712  44.2% -lh5- 831d Sep 20  1995 RKRM_PartTwo/Clipboard/clipdemo
-rw-r--r--   748/102      2360    6505  36.3% -lh5- c732 Sep 20  1995 RKRM_PartTwo/Clipboard/clipdemo.e
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/Console/
-rw-r--r--   748/102       876    1961  44.7% -lh5- 3cb5 Sep 20  1995 RKRM_PartTwo/Console/AskKeymap.e
-rw-r--r--   748/102      3006    8049  37.3% -lh5- 3a02 Sep 20  1995 RKRM_PartTwo/Console/Console.e
-rw-r--r--   748/102      1137    1732  65.6% -lh5- 168f Sep 20  1995 RKRM_PartTwo/Console/askkeymap
-rw-r--r--   748/102      2165    4052  53.4% -lh5- 641b Sep 20  1995 RKRM_PartTwo/Console/console
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/Expansion/
-rw-r--r--   748/102      1236    2096  59.0% -lh5- 8e47 Sep 20  1995 RKRM_PartTwo/Expansion/findboards
-rw-r--r--   748/102       984    2377  41.4% -lh5- e913 Sep 20  1995 RKRM_PartTwo/Expansion/findboards.e
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/Gameport/
-rw-r--r--   748/102      2902    8863  32.7% -lh5- 8bd0 Sep 20  1995 RKRM_PartTwo/Gameport/Absolute_Joystick.e
-rw-r--r--   748/102      2292    4700  48.8% -lh5- 37ed Sep 20  1995 RKRM_PartTwo/Gameport/absolute_joystick
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/Graphics_Libraries/
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/Graphics_Libraries/Layers/
-rw-r--r--   748/102      1223    1996  61.3% -lh5- bd70 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Layers/clipping
-rw-r--r--   748/102      1673    4568  36.6% -lh5- 0ef4 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Layers/clipping.e
-rw-r--r--   748/102      2567    6416  40.0% -lh5- 055a Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Layers/layers
-rw-r--r--   748/102      3023   11252  26.9% -lh5- a4a8 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Layers/layers.e
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/Graphics_Libraries/Primitives/
-rw-r--r--   748/102      2795    6978  40.1% -lh5- f96e Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Primitives/RGBBoxes.e
-rw-r--r--   748/102      3260    9520  34.2% -lh5- af59 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Primitives/WBClone.e
-rw-r--r--   748/102      2549    5868  43.4% -lh5- 99e1 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Primitives/genlockdemo
-rw-r--r--   748/102      4620   14775  31.3% -lh5- 1c11 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Primitives/genlockdemo.e
-rw-r--r--   748/102      1634    2912  56.1% -lh5- 0448 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Primitives/rgbboxes
-rw-r--r--   748/102      1352    2164  62.5% -lh5- 3662 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Primitives/usercopperexample
-rw-r--r--   748/102      1883    4729  39.8% -lh5- 28f2 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Primitives/usercopperexample.e
-rw-r--r--   748/102      2146    4296  50.0% -lh5- 83d9 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Primitives/wbclone
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/Graphics_Libraries/Sprites_Bobs/
-rw-r--r--   748/102      3995   13095  30.5% -lh5- 2930 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Sprites_Bobs/animtools.e
-rw-r--r--   748/102      1884    4640  40.6% -lh5- 8ec4 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Sprites_Bobs/animtools.m
-rw-r--r--   748/102      2648    5928  44.7% -lh5- 0640 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Sprites_Bobs/bob
-rw-r--r--   748/102      1733    4116  42.1% -lh5- 7d30 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Sprites_Bobs/bob.e
-rw-r--r--   748/102      4878   11052  44.1% -lh5- 3681 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Sprites_Bobs/collide
-rw-r--r--   748/102      6810   20518  33.2% -lh5- 5ebe Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Sprites_Bobs/collide.e
-rw-r--r--   748/102      1224    1940  63.1% -lh5- 24bf Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Sprites_Bobs/ssprite
-rw-r--r--   748/102      1432    3595  39.8% -lh5- 2fe9 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Sprites_Bobs/ssprite.e
-rw-r--r--   748/102      3171    7312  43.4% -lh5- 3285 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Sprites_Bobs/vsprite
-rw-r--r--   748/102      2172    5504  39.5% -lh5- 5254 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Sprites_Bobs/vsprite.e
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/Graphics_Libraries/Text/
-rw-r--r--   748/102      2578    6767  38.1% -lh5- 9b79 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Text/MeasureText.e
-rw-r--r--   748/102      2553    6012  42.5% -lh5- f45c Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Text/availfonts
-rw-r--r--   748/102      2979    9701  30.7% -lh5- 516e Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Text/availfonts.e
-rw-r--r--   748/102      2081    4148  50.2% -lh5- 975c Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Text/cliptext
-rw-r--r--   748/102      3821   10782  35.4% -lh5- b1a0 Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Text/cliptext.e
-rw-r--r--   748/102      2254    4248  53.1% -lh5- f30c Sep 20  1995 RKRM_PartTwo/Graphics_Libraries/Text/measuretext
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/IFFParse/
-rw-r--r--   748/102      2349    4040  58.1% -lh5- d12b Sep 20  1995 RKRM_PartTwo/IFFParse/clipftxt
-rw-r--r--   748/102      2224    5498  40.5% -lh5- b296 Sep 20  1995 RKRM_PartTwo/IFFParse/clipftxt.e
-rw-r--r--   748/102      1849    3148  58.7% -lh5- a625 Sep 20  1995 RKRM_PartTwo/IFFParse/sift
-rw-r--r--   748/102      2358    5535  42.6% -lh5- c6cd Sep 20  1995 RKRM_PartTwo/IFFParse/sift.e
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/Keymap/
-rw-r--r--   748/102      2240    6074  36.9% -lh5- c51f Sep 20  1995 RKRM_PartTwo/Keymap/appkeymap.e
-rw-r--r--   748/102      1004    2128  47.2% -lh5- a8b5 Sep 20  1995 RKRM_PartTwo/Keymap/appkeymap.m
-rw-r--r--   748/102      1274    2136  59.6% -lh5- 7bab Sep 20  1995 RKRM_PartTwo/Keymap/mapansi
-rw-r--r--   748/102      1027    2750  37.3% -lh5- f8bb Sep 20  1995 RKRM_PartTwo/Keymap/mapansi.e
-rw-r--r--   748/102      1286    1912  67.3% -lh5- 58de Sep 20  1995 RKRM_PartTwo/Keymap/maprawkey
-rw-r--r--   748/102      1093    2568  42.6% -lh5- 6123 Sep 20  1995 RKRM_PartTwo/Keymap/maprawkey.e
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/Math/
-rw-r--r--   748/102      2146    6524  32.9% -lh5- 48c7 Sep 20  1995 RKRM_PartTwo/Math/dpieee
-rw-r--r--   748/102       452     768  58.9% -lh5- c837 Sep 20  1995 RKRM_PartTwo/Math/dpieee.e
-rw-r--r--   748/102      2162    6540  33.1% -lh5- 40eb Sep 20  1995 RKRM_PartTwo/Math/dptrans
-rw-r--r--   748/102       429     735  58.4% -lh5- 27ec Sep 20  1995 RKRM_PartTwo/Math/dptrans.e
-rw-r--r--   748/102      1075    1488  72.2% -lh5- 5cee Sep 20  1995 RKRM_PartTwo/Math/spieee
-rw-r--r--   748/102       465     868  53.6% -lh5- bac2 Sep 20  1995 RKRM_PartTwo/Math/spieee.e
-rw-r--r--   748/102      1051    1416  74.2% -lh5- 58f2 Sep 20  1995 RKRM_PartTwo/Math/sptrans
-rw-r--r--   748/102       497     895  55.5% -lh5- a054 Sep 20  1995 RKRM_PartTwo/Math/sptrans.e
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 RKRM_PartTwo/Utility/
-rw-r--r--   748/102      1243    1916  64.9% -lh5- 94a8 Sep 20  1995 RKRM_PartTwo/Utility/a2d
-rw-r--r--   748/102       609    1394  43.7% -lh5- 0327 Sep 20  1995 RKRM_PartTwo/Utility/a2d.e
-rw-r--r--   748/102       772    1036  74.5% -lh5- 4f2a Sep 20  1995 RKRM_PartTwo/Utility/hooks1
-rw-r--r--   748/102       502     986  50.9% -lh5- 4efa Sep 20  1995 RKRM_PartTwo/Utility/hooks1.e
-rw-r--r--   748/102       881    1256  70.1% -lh5- b1ee Sep 20  1995 RKRM_PartTwo/Utility/istr
-rw-r--r--   748/102       491     902  54.4% -lh5- c35c Sep 20  1995 RKRM_PartTwo/Utility/istr.e
-rw-r--r--   748/102       792    1232  64.3% -lh5- 4c91 Sep 20  1995 RKRM_PartTwo/Utility/tag1
-rw-r--r--   748/102       782    2158  36.2% -lh5- e731 Sep 20  1995 RKRM_PartTwo/Utility/tag1.e
-rw-r--r--   748/102      1221    1976  61.8% -lh5- 2e3b Sep 20  1995 RKRM_PartTwo/Utility/uptime
-rw-r--r--   748/102       739    1670  44.3% -lh5- d1a5 Sep 20  1995 RKRM_PartTwo/Utility/uptime.e
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 Src/
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 Src/Tools/
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 Src/Tools/InitHook/
-rw-r--r--   748/102       353     662  53.3% -lh5- 1d29 Sep 20  1995 Src/Tools/InitHook/inithook.e
drwxr-xr-x   748/102         0       0 ****** -lhd- 0000 Sep 21  1995 Src/Tools/LongReal/
-rw-r--r--   748/102      1880    9875  19.0% -lh5- 0a6e Sep 20  1995 Src/Tools/LongReal/longreal.e
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        95 files  141378  351022  40.3%            Sep 23  1995