-----------------------------------------------------------------------------
                                  ROYAL BRIDGE
                        Copyright (c) 1998, Ivan Sturlic
-----------------------------------------------------------------------------
Version 28.26 (26 Apr 1998)

royalbridge.library is an Arexx external function library which acts as
a bridge to any Amiga shared library.

To call the library function royalbridge.library needs to know the library
base, function offset and information about which processor registers to use
for function arguments.

To make coding much easier you can use the Royal Bridge Arexx Preprocessor
which is also included. Arexx preprocessor requires a C compiler which will
be used to access C include files.

When using Arexx preprocessor you write an .app file which is nothing else
but normal Arexx program with some preprocessor commands which will be
replaced by real things in final .rexx file.

For example, to call the exec.library/AllocVec() function you would write:

#call 0 bmap = AllocVec(#{sizeof(struct BitMap)},#{MEMF_CLEAR})

This line would be replaced by preprocessor and would look like:

bmap = rbCall(0 || ' 2ac 1002',40,65536)

CURRENT LIMITATIONS
-------------------
 - It is not possible to call a library function which uses an a5 register
   for its argument
 - Won't work with floating point arguments

HISTORY
-------
 - 26 Apr 1998
   -----------
   First public release

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 5820   12364  47.1% -lh5- 1cb2 May  1  1998 royalbridge/app/app
[generic]                  102     137  74.5% -lh5- c275 May  1  1998 royalbridge/app/app.opts
[generic]                  568    1305  43.5% -lh5- 0142 May  1  1998 royalbridge/examples/exectest.app
[generic]                  517    1132  45.7% -lh5- d9d2 May  1  1998 royalbridge/examples/exectest.rexx
[generic]                  803    1920  41.8% -lh5- 5060 May  1  1998 royalbridge/examples/graphtest.app
[generic]                  700    1935  36.2% -lh5- 071a May  1  1998 royalbridge/examples/graphtest.rexx
[generic]                 2882    8038  35.9% -lh5- 0ca1 May  1  1998 royalbridge/docs/app.doc
[generic]                  353    1055  33.5% -lh5- cb8f May  1  1998 royalbridge/docs/app.doc.info
[generic]                 2123    6744  31.5% -lh5- 92ef May  1  1998 royalbridge/docs/royalbridge.doc
[generic]                  354    1055  33.6% -lh5- fdbc May  1  1998 royalbridge/docs/royalbridge.doc.info
[generic]                 2585    4488  57.6% -lh5- ab6c May  1  1998 royalbridge/libs/royalbridge.library
[generic]                  742    1592  46.6% -lh5- 4f2a May  1  1998 royalbridge/royalbridge.readme
[generic]                  522     777  67.2% -lh5- 2d5b May  1  1998 royalbridge/docs.info
[generic]                   62      80  77.5% -lh5- 9ddb May  1  1998 royalbridge/rb_install
[generic]                  518    1764  29.4% -lh5- a3b8 May  1  1998 royalbridge/rb_install.info
[generic]                  361    1055  34.2% -lh5- 9de3 May  1  1998 royalbridge/royalbridge.readme.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        16 files   19012   45441  41.8%            May  3  1998