linfo2172-databases/P1/Rel/doc
Brieuc Dubois 9ff77877b4 mix end of lines 2024-05-15 09:22:25 +02:00
..
AUTHORS.txt Initial commit - P1 2024-04-24 10:41:39 +02:00
CHANGES.txt mix end of lines 2024-05-15 09:22:25 +02:00
LIBRARIES.txt Initial commit - P1 2024-04-24 10:41:39 +02:00
LICENSE.txt mix end of lines 2024-05-15 09:22:25 +02:00
README.txt Initial commit - P1 2024-04-24 10:41:39 +02:00
TODO.txt Initial commit - P1 2024-04-24 10:41:39 +02:00

README.txt

Rel -- An implementation of Date and Darwen's Tutorial D.

Rel is a self-contained, complete, desktop database management system
with a user-friendly graphical user interface, ideal for creating and
maintaining personal, workgroup, and classroom databases.

*** GETTING STARTED ***

1. Download the file appropriate for your platform:

   Rel3.xxx.windows.zip      Windows 64 bit
   Rel3.xxx.dmg              MacOS 64 bit
   Rel3.xxx.linux.tar.gz     Linux 64 bit

   Note: xxx represents the current version number.
   
2. Open the downloaded archive to extract the Rel folder.
   Move the Rel folder to a convenient location.
   
   On MacOS, running the .dmg will start a minimal installer 
   to help you copy the Rel application to your Applications folder.

3. Download and unzip the Rel / Tutorial D source code examples to a
   convenient location:

   RelExamplesAndUtilities_3.xxx.zip

== If you are upgrading from a previous version of Rel, please ==
== see IMPORTANT INSTRUCTIONS FOR UPGRADING, below. ==

4. To run Rel, open the Rel folder or directory and run the Rel
   executable. It's normally shown with a Rel icon.

*** USING THE STAND-ALONE REL DBMS ***

Whilst Rel is a self-contained, complete, desktop database management
system with a user-friendly graphical user interface that is ideal for
creating and maintaining personal databases, you can optionally also
run a standalone, "headless" Rel DBMS server that can be accessed from
multiple Rel desktop database management systems and/or from software
you write. This is ideal for providing access to shared databases for
workgroups and classrooms.
   
If you wish to use the standalone Rel DBMS -- which is not needed to
use Rel -- download the following and extract it to a suitable
directory on your host machine:

   Rel3.xxx.windowsDBMS.zip      Windows 64 bit
   Rel3.xxx.macosDBMS.tar.gz     MacOS 64 bit
   Rel3.xxx.linuxDBMS.tar.gz     Linux 64 bit

** To run just the stand-alone Rel DBMS server from the command line:

   RelDBMSServer

   Note: The script file will have a .sh extension on Linux and 
   MacOS, .cmd on Windows. 

** To run the stand-alone command-line Rel language interpreter or
   server from your operating system command-line, go to the Rel 
   folder or directory and run:

   RelDBMS

   Note: The script file will have a .sh extension on Linux and 
   MacOS, .cmd on Windows. 

** The stand-alone command-line Rel language interpreter provides
   various options, including the option to run the server.  
   To see these options, type:
   
   RelDBMS -?

*** IMPORTANT INSTRUCTIONS FOR UPGRADING: ***

== If you are upgrading from a previous version of Rel, please ==
== pay attention to the following! ==

1.  You *MUST* back up your database *BEFORE* you install an upgrade!

If you are using Rel version 0.3.8 or higher, you can make a backup
via the graphical user interface's (aka DBrowser) "Backup" button.

If you are using Rel version 0.3.0 to 0.3.7, run the
DatabaseToScript.d script in the Scripts directory. This script will
emit your database as a new Tutorial D script. To back up your
database, save the generated script. To restore your database, run
the saved script.

If you are upgrading from a version of Rel prior to 0.3.0 (aka Rel2),
under the old version of Rel run the DatabaseToScript.d found in the
old version's Samples directory.  The script will emit your database
in a format that can be read by later versions of Rel, though it may
require some modifications.

Rel user interface (aka DBrowser) version 3.001 or above (which
includes the Rel DBMS version 1.0.13 or above) will automatically
attempt to upgrade any database created using Rel user interface
version 3.000 or above, or with the standalone Rel DBMS version 1.0.13
or above. Normally, the database upgrade is completely
automatic. However, in some cases the upgrade may not be able to
complete automatically. If this happens, it will tell you, and you may
need to edit the database backup script before you can successfully
restore the database.

However, Rel user interface version 3.000 and above cannot
automatically upgrade databases made with older Rel versions. You must
go to the command-line, load the backup script created in Step 1
above, and execute it.

For more information, please see https://reldb.org

Copyright © 2004-2022 Dave Voorhis
All Rights Reserved