=============================================================================
REFERENCES Bibliographic Software for MS DOS                      Version 3.5
Installation                                         (c) V. Kiefel, 1995-2000
=============================================================================



Table of contents

1     General remarks
2     Standard installation
3     Modified installation
4     Disclaimer, Bugfixes
5     Problems


1.....General remarks

   It is recommended that you print out this instruction for use with a text
editor or a word processing program.


2.....Standard installation

   It is recommended to install this version on drive c: in the directory
c:\refs35 of your computer. Installation on another drive and in another
directory is also possible but requires some changes in batch and
configuration files as described in the chapter "Modified installation". If
you use MS-Windows, please open a DOS-prompt.

   (If you received the REFERENCES distribution on a single archive file
REFS35.ZIP you should copy the files after decompression into a temporary
installation directory, e. g. `c:\refsinst'. After the installation
procedure, this directory may be deleted. You may also copy these files onto
a diskette and proceed with the installation as described below. Please use
for the following steps the UNZIP tool included in the REFERENCES
distribution.)

   1. Please create the REFERENCES working directory c:\refs35 and make this
directory the current directory:

        cd \
        md c:\refs35
        cd c:\refs35

   2. Unpack the archives from the disk (supposed that the floppy disk is
drive a:, you may, however, install the files of the distribution from any
directory, please substitite then in the following instructions `a:\' by
e. g. `c:\refsinst'):

        a:\unzip a:\r35exe
        a:\unzip a:\r35db
        a:\unzip a:\r35doc

   (In case of an installation from the `c:\refsinst'-directory you would
decompress the archive with

        c:\refsinst\unzip c:\refsinst\r35exe

   )

   R35EXE contains the program files, R35DB.ZIP contains the sample database
files, the complete program documentation files in R35DOC.ZIP are
uncompressed into the REFS35\DOC subdirectory.

   3. You will only be able to call the programs of REFERENCES from all
directories of your computer if you add the REFERENCES working directory to
the `path' environment variable.  Therefore you have to modify the line
beginning with `PATH=' or `SET PATH=' in the AUTOEXEC.BAT file in the root
directory of your computer's hard disk. The path-variable string should
contain:

        cd \
        edit autoexec.bat

(Instead of MS-DOS's EDIT you can use another text editor).  Insert

        ;c:\refs35;

   into the line beginning with `set path=' oder `path='. The path-entries
should always be separated by a `;'.

   If you have a computer with a color screen, you may wish to use the
program with a colored screen. White characters on a blue background is the
default of the installed version. Please read the chapter on the REFS.CFG
configuration file in SHORT35.ENG for changing screen colors.

   After completed installation, you can call the program with the sample
databases by typing

        DBASE1

or (using another database)

        TUTORIAL

   More details on configuration of the program will be found in the
SHORT35.ENG file. If this is your first installation of REFERENCES you may
build your database using DBASE1.

4. Print the program documentation from the text files

        TUTORIAL.GER
        REFSDOK.GER
        SHORT35.ENG
        PUBLISH.GER
        LECTURES.GER
        EXCHANGE.GER
        GLOSSAR.GER
        D_CHECK.GER


   (the extension `GER' indicates text files in German, the extension `ENG'
text files in English). It is recommended to print the documents with the
COURIER font or another font with fixed character width.  Transfer of data
from a previous installation in described in TRANSFER.DOC.



3.....Modified installation

   If you install the program on another drive ir in another directory, you
have to adjust some entries in the script files and in the configuration file
REFS.CFG. The following explanations assume that REFERENCES is installed on
drive c: in the directory `\re':

   1. Create the directory \re and make this the current directory:

        cd \
        md e:\re
        cd e:\re

   2. Uncompress the archives with the program files and the additional
material from disk (it is assumed that your disk drive is a:)

        a:\unzip a:\r35exe
        a:\unzip a:\r35db
        a:\unzip a:\r35doc

   3. You will only be able to call the programs of REFERENCES from all
directories of your computer if you add the REFERENCES working directory to
the `path' environment variable.  Therefore you have to modify the line
beginning with `PATH=' or `SET PATH=' in the AUTOEXEC.BAT file in the root
directory of your computer's hard disk. The path-variable string should
contain:

        cd \
        edit autoexec.bat

(Instead of MS-DOS's EDIT you can use another text editor).  Insert

        ;e:\re;

   into the line beginning with `set path=' oder `path='. The path-entries
should always be separated by a `;'. Please note that this line in the
AUTOEXEC.BAT file must not be longer than 127 characters.

   4. Using an editor, please change the path entries in the DBASE1.BAT batch
file:

        @echo off
        set SAVE_LFN=%LFN%
        set LFN=N
        cd e:\re\dbase1
        e:\re\bin\refs35.exe %1
        set LFN=%SAVE_LFN%
        cd e:\re

and TUTORIAL.BAT:

        @echo off
        set SAVE_LFN=%LFN%
        set LFN=N
        cd e:\re\tutorial
        e:\re\bin\refs35.exe %1
        set LFN=%SAVE_LFN%
        cd e:\re

   5. Then please change in the configuration file REFS.CFG the lines with
`help_files' and with `call_editor_command_file':

        delay_list_write=0
        delay_struct_write=0
        colors=4
        help_files=e:\re\doc
        call_editor_command_file=e:\re\e.bat
        editor=edit

   Further details are dicussed in the previous section. Transfer of your
data from previous installations is described in the TRANSFER.DOC file.

   Then you will have to edit the pertinent lines in the batch files calling
GAWK on the scripts, in EXCITE.BAT please change the line:

   c:\refs\bin\gawk -f c:\refs\script\excite.awk %1 %2 % %4 %5 %6 %7 %8 %9

into

   e:\re\bin\gawk -f e:\re\script\excite.awk %1 %2 % %4 %5 %6 %7 %8 %9

   In the same manner you should edit the third line in the batch file
`EXHARV.BAT' and in `MERGEHAR.BAT'

   c:\refs\bin\gawk -f c:\refs\script\mergehar.awk %1 %2

should be converted into

   e:\re\bin\gawk -f e:\re\script\mergehar.awk %1 %2



4.....Disclaimer, Bugfixes

   This software has been developed and evaluated carefully. However, `bugs'
and inconsistencies cannot be excluded in complex software. The program
author is therfore grateful for any information about bugs or inconsistencies
within the program.

   The author is grateful for any recommendations for future development of
the software and for reports on bugs and problems.


5.....Problems

   If you have installed the DJGPP-Version of REFERENCES V. 3.5 on a computer
without hardware coprocessor, the system may crash after calling the program.
If this happens, tell the program to look for the emulator via two
environment variables:

   set 387=N
   set emu387=c:/refs35/bin/emu387.dxe

   These two lines are best entered into the AUTOEXEC.BAT file or into all
batch files calling REFERENCES for all databases.

-----------------------------------------------------------------------------
This software package includes GAWK (version 3.0.4), an implementation of the
AWK programming language: Copyright (C) 1989, 1991-1999 by the Free Software
Foundation. It is distributed under the terms of the GNU General Public
License as published by the Free Software Foundation. Source code for GAWK
may be found on any server that "mirrors" the files from the main GNU
distribution site in the file ../gnu/gawk-3.0.4.tar.gz (1999, by the time of
writing of this documentation).  The distribution also contains the excellent
documentation in an electrinic document ('Effective AWK programming' by
Arnold D Robbins).
-----------------------------------------------------------------------------
THIS SOFTWARE IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL FOR YOUR
WORK, BUT WITHOUT ANY WARRANTY; WITHOUT EVEN THE IMPLIED WARRANTY OF
MERCHANTIBILITY OR FITNESS FOR A PARTICULAR PURPOSE.  THE PROGRAM AUTHOR
THEREFORE DOES NOT ASSUME ANY LIABILITY FOR ANY ALLEGED ACTUAL DAMAGES
ARISING FROM THE USE OF THIS SOFTWARE.
-----------------------------------------------------------------------------
NOTE:  REFERENCES is packaged for distribution using Info-ZIP's compression
utility. The installation procedure uses UnZip to read zip files. Info-ZIP's
software (Zip, UnZip and related utilities) is free and can be obtained as
source code or executables from Internet/WWW sites, including
http://www.cdrom.com/pub/infozip/.
-----------------------------------------------------------------------------

<END OF FILE INSTALL.ENG>
