OVERVIEW:
-----------

THIS LIBRARY IS SHAREWARE. Only developers using this library to develop own
applications have to pay the shareware fee, for 'users' the library is for
free. See the Installation manual for details.

This shared runtime library and the according link library can be used by every
application that needs to store information in a database. The library contains
all functions that are required to create and edit large databases of several
datatables and their according indexes.

The library could be used from every programming language that is able to call
Amiga shared runtime libraries (C-headerfiles included).

The library doesn't provides any graphical user interface (GUI); use whichever
you want for your database application, respectively use the database func-
tionality from any application.

The datatables are organized like XBase-datafiles but they are not compatible
to the several XBase-clones. I renounced to make them compatible because I've
missed several options by the XBase-datatables. So XBase doesn't support the
basic numerical datatypes, XBase use an own format for numerical values stored
in the datatables. They use a fixed-point value but since there is no support
for fixed-point algebra in any known (known by me) operating-system/hardware
this will always result in rounding errors when these values are converted to a
floating-point value to do any arithmetics. So I decided to add support for the
basic numeric datatypes. This library can store simple integer types as single
byte-values, 2 byte words, 4 byte longs, and 8 byte (64-bit) doublelong values
and also floating-point values in single or double precision.
The datatables also support fixed-point numerical values (simular to XBase),
date and time values, strings of fixed and variable length.

The library supports simultaneous multiuser access to these files and does the
required lockings so the accesses of the different instances are serialized to
avoid conflicts. The library supports automatically locking or manual locking
of the records of the datatables. Automatically locking will do it for most
purposes but manual locking may be required for finetuning of an application.

The records of every datatable may be indexed using several indexes. The
indexes are stored in own index-files and the keys in these indexes are
automatically added/changed/removed, whenever the contents of a record is
changed. The keys are build according to a key-expression, that has to be
specified for every index. This key-expression allows to combine several
columns of a datatable to a single key-value, e.g. in an address-datatable you
may combine the columns for the 'name' and 'first name' for an index that is
primary ordered by the 'name' and all entries with equal 'name' are ordered by
the 'first name'. There are also a couple of supported functions that may be
used to manipulate the key-values, e.g. the function "Upper()" that allows to
create an index where the case of the strings doesn't matter for the sorting
order.
Nearly every column-type of the datatables may be indexed, except the columns
containg a variable length string (or custom datatypes that are not
representable by a string or a 64-bit integer).


You should first have a look into the installation manual and then use the
developer manual to learn how to create own applications using the
Database.library.


 FEATURES:
-----------
   - runs on any Amiga with at least AmigaOS 2.0
   - supports simultan multiuser access to the database using record locking
   - supports databases located on network devices
   - supports several datatypes to be stored in the databases
   - expandable concept, write your own extensions for custom datatypes to be
     stored in a database.
   - any number of indexes per datatable allowing to order and seek for nearly
     any contents on the database
   - more than 200 pages english documentation (.guide and .dvi) describing
     installation, usage, performance, and programming containing several
     examples and a   complete tutorial.
   - it's very easy to learn how to create own databases using this library
   - ...(have a look into the documentation contained in this archive)


 INCLUDED DEVELOPER FILES:
---------------------------
  - Autodocs
  - C header files (also protos, pragmas)
  - several C examples showing how to use the database.library
  - complete RKM-alike manual (>160 pages) describing the library and its
    functions including a complete tutorial and additional information,
    required if own enhancements should be added to the functionality.


 FILES:
--------
   This archive should contain the following files:

   README                       - this file
   joinOS.readme                - basic information about joinOS.library
   database.library             - the shared database.library
   joinOS.library               - additional library containing support fct.
   documents/Installation.guide - installation guide as AmigaGuide document
   documents/Installation.dvi   - installation guide as dvi document
   documents/Developer.guide    - developers manual as AmigaGuide document
   documents/Developer.dvi      - developers manual as dvi document
   autodoc/Database.guide       - Autodoc file of the database.library
   autodoc/joinOS.guide         - Autodoc file of the joinOS.library
   lib/Database.lib             - C link-library with additional functions
   lib/joinOS.lib               - C link-library with additional functions
   include/joinOS/...           - C include files required for development
   examples/...                 - several example files inclusive source


 HISTORY
---------
 - Version 1.0, 10. May 2004
      first public release

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                33238   65648  50.6% -lh5- d9de May 10  2004 Database/database.library
[generic]                  115     213  54.0% -lh5- a1f6 Jan 29  2004 Database/Examples/Data/relMedia.mcr
[generic]                  208     300  69.3% -lh5- aca8 Jan 31  2004 Database/Examples/Data/tv.mcr
[generic]                 3115    9337  33.4% -lh5- 53e4 May 11  2004 Database/Examples/Examples.readme
[generic]                20895   39320  53.1% -lh5- 45b4 May  7  2004 Database/joinOS.library
[generic]                 1348    2913  46.3% -lh5- ef8b May 10  2004 Database/joinOS.readme
[generic]                  297    3199   9.3% -lh5- 2444 May 11  2004 Database/joinOS.readme.info
[generic]                  105     169  62.1% -lh5- abe2 May 11  2004 Database/Examples/Data/album.mcr
[generic]                  223     484  46.1% -lh5- 1790 Jan 23  2004 Database/Examples/Data/math.mcr
[generic]                  121     161  75.2% -lh5- f28e Jan 29  2004 Database/Examples/Data/media.mcr
[generic]                  352     562  62.6% -lh5- c0fb May 11  2004 Database/Examples/Data/music.mcr
[generic]                  117     253  46.2% -lh5- 59af Feb  1  2004 Database/Examples/Data/relation.mcr
[generic]                  926    2140  43.3% -lh5- 43b2 May 10  2004 Database/Examples/TVDB.c
[generic]                  161     320  50.3% -lh5- 3c74 May 10  2004 Database/Examples/smakefile.album
[generic]                  163     274  59.5% -lh5- eda4 May 10  2004 Database/Examples/smakefile.math
[generic]                  161     320  50.3% -lh5- c761 May 10  2004 Database/Examples/smakefile.media
[generic]                  173     339  51.0% -lh5- 4f0a May 10  2004 Database/Examples/smakefile.music
[generic]                  159     299  53.2% -lh5- 6dc9 May 10  2004 Database/Examples/smakefile.tv
[generic]                17455   42676  40.9% -lh5- e404 May 10  2004 Database/Examples/TVDB
[generic]                17887   44716  40.0% -lh5- 5324 May 10  2004 Database/Examples/MathDB
[generic]                  875    2197  39.8% -lh5- 282d Feb  5  2004 Database/Examples/MathDB.c
[generic]                17197   42168  40.8% -lh5- 0927 May 10  2004 Database/Examples/MediaDB
[generic]                  752    1781  42.2% -lh5- f951 Feb  5  2004 Database/Examples/MediaDB.c
[generic]                17359   42468  40.9% -lh5- 694f May 11  2004 Database/Examples/MusicDB
[generic]                  855    1992  42.9% -lh5- 9caf May 11  2004 Database/Examples/MusicDB.c
[generic]                   51      56  91.1% -lh5- f8e7 Feb  6  2004 Database/Examples/SCOPTIONS
[generic]                17210   42200  40.8% -lh5- 3ca9 May 10  2004 Database/Examples/AlbumDB
[generic]                  755    1771  42.6% -lh5- faff Feb  5  2004 Database/Examples/AlbumDB.c
[generic]                 3128   10509  29.8% -lh5- d0ff May 10  2004 Database/Examples/Main.c
[generic]                 1366    2512  54.4% -lh5- b248 May 10  2004 Database/Examples/Main.o
[generic]                 5558    9276  59.9% -lh5- d77b Apr  6  2004 Database/Examples/Tutorial/AlbumDB
[generic]                 2178    6432  33.9% -lh5- f3c1 Apr  6  2004 Database/Examples/Tutorial/Tutorial_1.c
[generic]                 1554    5379  28.9% -lh5- 7ffb May  4  2004 Database/Examples/SpeedTest/ReadWords.c
[generic]                   51      56  91.1% -lh5- f8e7 Feb  6  2004 Database/Examples/TableEdit/SCOPTIONS
[generic]                22336   87909  25.4% -lh5- 59ee Feb  6  2004 Database/Examples/TableEdit/TableEdit.c
[generic]                  721    1703  42.3% -lh5- 21bd Feb  5  2004 Database/Examples/TableEdit/TableEdit.h
[generic]                16983   41460  41.0% -lh5- 323a May 10  2004 Database/Examples/TableEdit/TableEdit.o
[generic]                   51      56  91.1% -lh5- f8e7 Feb  6  2004 Database/Examples/SpeedTest/SCOPTIONS
[generic]                  215     430  50.0% -lh5- 9778 May 10  2004 Database/Examples/SpeedTest/smakefile.speed
[generic]                20815   52268  39.8% -lh5- ae4b May 10  2004 Database/Examples/SpeedTest/SpeedTest
[generic]                11751   47730  24.6% -lh5- f04c May 10  2004 Database/Examples/SpeedTest/Speedtest.c
[generic]                 2918    8769  33.3% -lh5- a87a Feb  6  2004 Database/Examples/SpeedTest/Startup.c
[generic]                 4629    7980  58.0% -lh5- 9ed9 May 10  2004 Database/Examples/ExtractAutodoc/ExtractAD
[generic]                   51      56  91.1% -lh5- f8e7 Feb  6  2004 Database/Examples/ExtractAutodoc/SCOPTIONS
[generic]                 2918    8769  33.3% -lh5- a87a Feb  6  2004 Database/Examples/ExtractAutodoc/Startup.c
[generic]                  306     408  75.0% -lh5- 7621 Feb  6  2004 Database/Examples/ExtractAutodoc/Startup.o
[generic]                  306     408  75.0% -lh5- 7621 Feb  6  2004 Database/Examples/SpeedTest/Startup.o
[generic]                13910   50133  27.7% -lh5- c010 May  7  2004 Database/Examples/ExtractAutodoc/ExtractAutodoc.c
[generic]                 1431    4676  30.6% -lh5- d623 May  6  2004 Database/Examples/ExtractAutodoc/ReadLines.c
[generic]                 2453    4140  59.3% -lh5- 3bc9 May  6  2004 Database/Examples/ExtractAutodoc/RemoveTabs
[generic]                  194     326  59.5% -lh5- e759 May  5  2004 Database/Examples/ExtractAutodoc/smakefile.EAD
[generic]                 5248   17965  29.2% -lh5- f9ef May  6  2004 Database/Examples/ExtractAutodoc/RemoveTabs.c
[generic]                  175     299  58.5% -lh5- e0b1 May  6  2004 Database/Examples/ExtractAutodoc/smakefile.tab
[generic]                  710    1569  45.3% -lh5- 78d8 Feb  5  2004 Database/Include/joinOS/database/Memo.h
[generic]                  854    1931  44.2% -lh5- 618b Feb  5  2004 Database/Include/joinOS/database/Numeric.h
[generic]                 3669   11258  32.6% -lh5- 4eb1 Mar 17  2004 Database/Include/joinOS/database/DataServer.h
[generic]                 3420   10109  33.8% -lh5- 3715 Feb 27  2004 Database/Include/joinOS/database/DataTable.h
[generic]                  910    2766  32.9% -lh5- 7dea Feb 27  2004 Database/Include/joinOS/database/FunctionTypes.h
[generic]                 2639    8321  31.7% -lh5- 303c Feb  5  2004 Database/Include/joinOS/database/Index.h
[generic]                  486    1221  39.8% -lh5- 0b1a Feb  5  2004 Database/Include/joinOS/database/Parse.h
[generic]                 2672    8138  32.8% -lh5- 2a6e Feb 13  2003 Database/Include/joinOS/misc/TagItems.h
[generic]                  770    1833  42.0% -lh5- 99cf Jul  5  2002 Database/Include/joinOS/misc/TextBox.h
[generic]                  848    3917  21.6% -lh5- 0dc6 Feb  6  2004 Database/Include/joinOS/pragmas/DatabasePragma.h
[generic]                  978    4018  24.3% -lh5- 9fcf May  7  2004 Database/Include/joinOS/pragmas/JoinOSPragma.h
[generic]                 4130   14308  28.9% -lh5- 5161 Aug 14  2003 Database/Include/joinOS/protos/AmigaDOSProtos.h
[generic]                 3892   15103  25.8% -lh5- 7139 Mar 11  2004 Database/Include/joinOS/protos/DatabaseProtos.h
[generic]                 5412   19055  28.4% -lh5- dc27 Jan  5  2004 Database/Include/joinOS/protos/JoinOSProtos.h
[generic]                  616    2027  30.4% -lh5- facc Feb  5  2004 Database/Include/joinOS/protos/NumericProtos.h
[generic]                 4688   12855  36.5% -lh5- e044 Aug 14  2003 Database/Include/joinOS/dos/DOSBase.h
[generic]                 2822    6958  40.6% -lh5- 9db3 Mar 21  2002 Database/Include/joinOS/dos/MatchPattern.h
[generic]                 2986    7533  39.6% -lh5- 2ab0 Mar 21  2002 Database/Include/joinOS/dos/rdargs.h
[generic]                 3606   13205  27.3% -lh5- f94a Mar 21  2002 Database/Include/joinOS/protos/ExecProtos.h
[generic]                  559    1735  32.2% -lh5- d999 Mar 21  2002 Database/Include/joinOS/protos/UtilityProtos.h
[generic]                 8481   23114  36.7% -lh5- e627 Nov  1  2002 Database/Include/joinOS/dos/AmigaDOS.h
[generic]                 2137    5613  38.1% -lh5- 580c Aug 14  2003 Database/Include/joinOS/dos/DOSPacket.h
[generic]                 2350    6170  38.1% -lh5- 21dc Mar 21  2002 Database/Include/joinOS/dos/DOSProcess.h
[generic]                 1732    4899  35.4% -lh5- ee93 Mar 21  2002 Database/Include/joinOS/dos/DOSTags.h
[generic]                  835    1704  49.0% -lh5- 5040 Mar 21  2002 Database/Include/joinOS/dos/DOSVars.h
[generic]                  727    1763  41.2% -lh5- 17bc Jan 23  2004 Database/Include/joinOS/exec/defines.h
[generic]                 1597    4014  39.8% -lh5- 66f1 Mar 21  2002 Database/Include/joinOS/exec/Memory.h
[generic]                 1477    3483  42.4% -lh5- 698b Mar 21  2002 Database/Include/joinOS/exec/Ports.h
[generic]                  683    1692  40.4% -lh5- 698a Mar 21  2002 Database/Include/joinOS/exec/Semaphore.h
[generic]                 2349    5827  40.3% -lh5- cfe3 Aug 14  2003 Database/Include/joinOS/exec/Tasks.h
[generic]                41432  177167  23.4% -lh5- de66 May  6  2004 Database/Autodoc/database.doc
[generic]                45263  209083  21.6% -lh5- 7800 May  7  2004 Database/Autodoc/database.guide
[generic]                 3978   11927  33.4% -lh5- bac1 Mar 21  2002 Database/Include/joinOS/exec/Alerts.h
[generic]                 1916    4784  40.1% -lh5- d608 Mar 21  2002 Database/Include/joinOS/exec/Exec.h
[generic]                 2200    5764  38.2% -lh5- acb1 Mar 21  2002 Database/Include/joinOS/exec/Lists.h
[generic]                  168     204  82.4% -lh5- 4925 May  7  2004 Database/Lib/joinOS.lib
[generic]                 1169    3581  32.6% -lh5- ed54 May  6  2004 Database/Autodoc/include/FunctionTypes.h
[generic]                 3296   11836  27.8% -lh5- cc0f May  6  2004 Database/Autodoc/include/Index.h
[generic]                  955    2270  42.1% -lh5- a182 May  6  2004 Database/Autodoc/include/Memo.h
[generic]                 1070    2568  41.7% -lh5- fc82 May  6  2004 Database/Autodoc/include/Numeric.h
[generic]                39108  131193  29.8% -lh5- 85d5 May  7  2004 Database/Autodoc/joinOS.doc
[generic]                42711  157054  27.2% -lh5- b4ca May  7  2004 Database/Autodoc/joinOS.guide
[generic]                 4777   17515  27.3% -lh5- 607d May  6  2004 Database/Autodoc/include/DataServer.h
[generic]                 4320   14818  29.2% -lh5- 9265 May  6  2004 Database/Autodoc/include/DataTable.h
[generic]                 3439    9486  36.3% -lh5- bd20 May  7  2004 Database/Autodoc/include/MatchPattern.h
[generic]                 3409    9496  35.9% -lh5- b115 May  7  2004 Database/Autodoc/include/rdargs.h
[generic]                 1050    2670  39.3% -lh5- 9d9b May  7  2004 Database/Autodoc/include/TextBox.h
[generic]                  305    3205   9.5% -lh5- 2f05 May 11  2004 Database/Autodoc/database.guide.info
[generic]                11096   34473  32.2% -lh5- 13c6 May  7  2004 Database/Autodoc/include/AmigaDOS.h
[generic]                  305    3205   9.5% -lh5- 92e3 May 11  2004 Database/Autodoc/joinOS.guide.info
[generic]                  467     937  49.8% -lh5- 39e8 May 11  2004 Database/Documents/Installation.dvi.info
[generic]                16903   46714  36.2% -lh5- 1d5a May  3  2004 Database/Documents/Installation.guide
[generic]               157055  511716  30.7% -lh5- 6156 Apr 30  2004 Database/Documents/Developer.dvi
[generic]                  463     937  49.4% -lh5- 778a May 11  2004 Database/Documents/Developer.dvi.info
[generic]               105342  367405  28.7% -lh5- 9b07 May  4  2004 Database/Documents/Developer.guide
[generic]                24772   59216  41.8% -lh5- 8412 May  3  2004 Database/Documents/Installation.dvi
[generic]                  306    3205   9.5% -lh5- f6ec May 11  2004 Database/Documents/Installation.guide.info
[generic]                  274     628  43.6% -lh5- 47c8 May 11  2004 Database.info
[generic]                  273     628  43.5% -lh5- 6c97 May 11  2004 Database/Autodoc.info
[generic]                  271     628  43.2% -lh5- 3d3e May 11  2004 Database/Documents.info
[generic]                  305    3205   9.5% -lh5- 42fe May 11  2004 Database/Documents/Developer.guide.info
[generic]                 2376    6003  39.6% -lh5- 78a4 May 11  2004 Database/README
[generic]                  296    3199   9.3% -lh5- 3322 May 11  2004 Database/README.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total       116 files  863624 2740784  31.5%            May 13  2004