Here is the procedure for compiling and installing SCRIBE on a Unix system.

 
Requirements
************

   - BIGLOO2.4b or later is _required_.
   - GNU-MAKE is required.
   - In order to compile the scribe_mod Apache module, you need to be
     provided with the Apache development kit (the Apache compiler APXS
     is required).


Summary of a SCRIBE compilation, test and installation
******************************************************

   $ ./configure
   $ make
   $ make install

   This procedure will self test SCRIBE because it will compile the various
   Scribe documents that implement the Scribe documentation.

   To compile the Scribe Apache module, the following supplemental
   step is needed:

   $ make mod_scribe

   It is out of the scope of this documentation file to explain how to
   install the mod_scribe Apache module. However, you may find some hints
   in the file apache/README.


Configuring SCRIBE
******************

   1. Edit the `./configure' file and set the variables defined in the Use
      section (e.g. `bindir', `libdir', `mandir' and `docdir'). Note that
      if you leave these variable definitions blank the installation procedure
      will install Scribe at the same location as Bigloo.

   2. Configure Scribe for your machine by invoking:
        `./configure'
      or
        `./configure --prefix <your-prefix>'
      or
        `./configure --bigloo=<your-bigloo-compiler>'
     When the system is ready to be compiled, `configure' prints 
       the message `configuration done.'.


Compiling SCRIBE
****************

   3.  Type:
          `make'

       This will compile:
         - the Scribe compiler: scribe
         - the Texinfo to Scribe translator: scribeinfo
         - some Scribe backends such as an html, tex, man and a info backend.
         - a Bigloo library enabling CGI programming.
         - the Scribe documentation (in manuals/man, manuals/user and
           manuals/expert).


Installing SCRIBE
*****************

   4.  Type:
          `make install'

       This install, the Scribe compiler, the Scribeinfo compiler, the
       various Scribe back-ends, the variable Scribe style files and
       the Scribe documentation. 

       This does not install the scribe.el emacs package.

       ==> Note: on some architecture you will be needing to tell the 
       loader where to find the Bigloo shared library. This can be done 
       two ways:
          - setting the shell LD_LIBRARY_PATH variable.
          - updating the /etc/ld.so.conf file (read by ldconfig man page).

       This is _not_required_ on Linux nor Digital Unix but it is _required_
       on SunOs and Solaris.


Compiling SCRIBE Apache module mod_scribe
*****************************************

   5.  Type:
          `make mod_scribe'


Installing SCRIBE Apache module mod_scribe
******************************************

   6.  Type:
          `make install-mod_scribe'


Cleaning SCRIBE
***************

   7.  Once, installed, you can type:
          `make clean' 
       to remove all the useless files.


Uninstalling SCRIBE
*******************

   8.  To uninstall Scribe:
          `make uninstall'


Unconfiguring SCRIBE
********************

   9.  If you plan to re-install Bigloo on a new platform. Before performing
       the all installation process (step 1 to 8) you must first remove the
       current configuration. For this type:
          `make cleanall'

      
