===============================================================

PRELIMINARY NOTES
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Before all else, READ THIS.
+++++++++++++++++++++++++++


1.  If your machine does not mount CD-ROMs as /cdrom, alter the line
which reads "set mountpt =" to reflect the correct mount point.

2.  You must own the installation directory and have all read and 
write privileges.

3.  You must have the recommended amount of disk space mentioned 
in II below, which is 30 megabytes.  This will not be the total 
AFTER installation, but the full amount is required during 
execution of the install.lb script.


======================================
IMPORTANT NOTE FOR SGI Platform USERS:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
SGI IRIX 5.2 is the only SGI OS currently support by DynaText.  We are 
interested in full support for our subscribers, so we would appreciate 
hearing from you about the current operating system
you have installed, and any plans you may have for upgrading to 5.2.

Other supported UNIX platforms (installable from this CD-ROM) are 
SunOS 4.x.x and SunOS 5.x.x.


============================================================
   ---- DynaText Browser Installation Instructions ---
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This CD-ROM from Lightbinders contains both the electronic form of the
journal, as well as the hypermedia browsers needed to access the
journal.  The installation of the DynaText browser for Unix users is
intended to be quite simple.  Please let the publishers know of any
difficulties you may have.


I. Mount the CD-ROM (SEE PRELIMINARY NOTES ABOVE
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Typically, this will need to be done by your system administrator  
The command to use will likely be much like this:

	# mount -t hsfs -o ro /dev/sr0 /cdrom

II. Choose an install directory
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

You need to select where on your system you wish to install the DynaText 
browser.  It must be in a filesystem with at least 30 megabytes of free 
space, and it must be a directory in which the person doing the installation 
has write permission.


III. Copy the installation script (SEE PRELIMINARY NOTES ABOVE)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The script expects to be run from within the directory you selected for 
installation of the browser.  Copy the script as follows:

	% cd install_directory (See *Note below)
	% cp /cdrom/unix/install.lb .  

Note -- throughout the rest of this document, "install_directory" will 
be used to refer to the directory you chose.  DO NOT USE
 "install_directory" LITERALLY.


IV. Run the installation script
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This is simply:

	% install.lb  

Copy the configuration file
~~~~~~~~~~~~~~~~~~~~~~~~~~~

When the script completes, it will clean up after itself, and leave 
behind a sample configuration file, ".ebtrc".  Each user of the 
DynaText browser (1) must have read and execute permissions in 
the install directory tree and (2) must copy the sample .ebtrc 
file into his or her home directory:

	% cp install_directory/examples/.ebtrc ~


VI. Use the browser
~~~~~~~~~~~~~~~~~~~~~

Now it should be possible to use the browser.  You will very likely 
want to modify your PATH environment variable to include the browser 
software directory:

	% set path=($path install_directory/bin)

Then, to start the browser, simply type:

	% dtext



==============================================================
ADDING NEW CD-ROM TITLES TO AN EXISTING DYNATEXT INSTALLATION:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The present version of our installation to Unix platforms is able to
quickly and easily perform an initial DynaText install from the
CD-ROM.  Unfortunately, we have not yet enabled the ability to
automatically add new Lightbinders CD-ROM titles which can use the
DynaText Unix interface already installed.  The manual process
required to add new titles, however, is very simple for you to
perform.

To add new titles, each current user must modify the file ".ebtrc" in
his or her home directory.  If the DynaText administrator anticipates
new users, it might be well for him or her to apply the following
instructions to the file examples/ebtrc/.ebtrc (in the directory in
which DynaText was installed) as well.  If there are a large number of
users, the DynaText administrator might wish to modify the example
.ebtrc and have each user copy it rather than having each user modify
his or her existing .ebtrc file.

If one examines the file .ebtrc, one will see lines within it which
appear similar to this:

BOOK_DBASE      /cdrom/rwj=Radiobiological Weekly Journal Collection

To add a new book, use a text editor (such as vi) to create another
line below the last BOOK_DBASE line in this file.  This line should
begin with "BOOK_DBASE", followed by the path to the book (e.g.,
"/cdrom/rwj"), an = character, and the name of the book (e.g.,
"Radiobiological Weekly Journal").  The path to a new title list 
(/rwj in this example) is found by examining the root directory of the
CD-ROM The new line would then appear:

BOOK_DBASE      /cdrom/ap=ACADEMIC PRESS: I. S. Gradshteyn and I. M. Ryzhik

Save the file, re-start DynaText and your new book should appear in
the browser.

==============================================================================
If you experience any problems with this installation on your platform, please 
contact Lightbinders Technical Support for this product at grad@lbin.com.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

