# $Id: README.INSTALL,v 1.49 2013/09/18 11:05:53 svein Exp $

This is the file README.INSTALL, originating from
http://www.mn.uio.no/ifi/english/research/groups/dsb/resources/software/xite

NOTE: THE SYSTEM ADMINISTRATOR'S MANUAL GIVES A BETTER DESCRIPTION OF
HOW TO INSTALL XITE. YOU WILL FIND IT IN THE SAME LOCATION YOU FOUND
THIS FILE.

Below is a condensed description of the installation procedure.
root/Administrator) privileges may be needed, depending on how you choose to
install the software.

  1) Create an account or a directory for XITE, e.g. /usr/local/xite on
     a UNIX system, or c:\XITE on a Windows system.

  2) Set the environment variable XITE_HOME to the XITE directory.

  3a) On a UNIX system from the tarball

      Use the script "install_xite" to

      i) Unpack the gzip'ed/compressed tar-file and update utility scripts.

     ii) Build library, executables, manual pages and
         hypertext reference manual.

  3b) On a Red Hat Linux system from rpm

      Use rpm to install the rpm file.

  3c) On a Windows system:

      i) With the XITE prebuilt distribution for Windows, unzip xite.zip.
         You may also need to get the file msvcrt.dll and put it into the bin
         directory below the XITE directory.

	 Set the XITE_MAN environment variable.

     ii) or with the XITE source distribution

         - Create folders for the
           + XITE libraries (e.g. %XITE_HOME%\lib\Win32)
           + XITE executables (e.g. %XITE_HOME%\bin\Win32)
           + manual page documentation (e.g. %XITE_HOME%\man)
           + html Reference Manual documentation
             (e.g. %XITE_HOME%\doc\ReferenceManual)

         - Copy the file %XITE_HOME%\etc\Makefile.Win32.tmpl to
           %XITE_HOME%\etc\Makefile.Win32 and reflect your above choices in
           it.

         - In the folder %XITE_HOME%\src, update the file Makefile.Win32 and
           run the command
             nmake /r /f Makefile.Win32 XITE_HOME=%XITE_HOME%

         - Set the XITE_MAN environment variable.

Check the System Administrator's Manual for further instructions and
help in case of problems. Also you'll find descriptions on

  - how to build XITE on multiple computer architectures
  - how to setup user accounts
  - the XITE mailing list
  - how to report bugs
  - how to register your XITE copy
  - how to read about XITE on the World Wide Web