cvs commit: apache-1.3 INSTALL

[rs...@hyperreal.org]

rse         98/04/04 10:02:46

  Modified:    .        INSTALL
  Log:
  Make sure the user informed about DSO support even if he uses APACI and not
  reading src/Configuration.tmpl He has to notice that the nice --enable-shared
  option is only available if his platform really supports DSO.
  
  Revision  Changes    Path
  1.4       +40 -12    apache-1.3/INSTALL
  
  Index: INSTALL
  ===================================================================
  RCS file: /export/home/cvs/apache-1.3/INSTALL,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- INSTALL	1998/04/01 12:59:56	1.3
  +++ INSTALL	1998/04/04 18:02:46	1.4
  @@ -41,12 +41,14 @@
        The following requirements exist for building Apache:
   
        o  Disk Space: 
  +
           Make sure you have approximately 12 MB of temporary free disk space
           available.  After installation Apache occupies approximately 3 MB of
           disk space (the actual required disk space depends on the amount of
           compiled in third party modules, etc).
   
        o  ANSI-C Compiler: 
  +
           Make sure you have an ANSI-C compiler installed. The GNU C compiler
           (GCC) from the Free Software Foundation (FSF) is recommended.  If you
           don't have GCC then at least make sure your vendors compiler is ANSI
  @@ -54,15 +56,43 @@
           http://www.gnu.ai.mit.edu/ and the GCC distribution under
           http://www.gnu.ai.mit.edu/order/ftp.html .
   
  -     o  Perl 5 Interpreter (OPTIONAL):
  -        For some of the support scripts like `apachectl' (which are written in
  -        Perl) the Perl 5 interpreter is required. If no such interpreter is
  -        found by APACI's `configure' script this is no harm. You still can
  -        build and install Apache 1.3. Only those support scripts cannot be
  -        used. If you have multiple Perl interpreters installed (perhaps a Perl
  -        4 from the vendor and a Perl 5 from your own), then it is recommended
  -        to use the --with-perl option (see below) to make sure the correct one
  -        is selected by APACI.
  +     o  Perl 5 Interpreter [OPTIONAL]:
  +
  +        For some of the support scripts like `apxs' or `dbmmanage' (which are
  +        written in Perl) the Perl 5 interpreter is required. If no such
  +        interpreter is found by APACI's `configure' script this is no harm.
  +        Of course, you still can build and install Apache 1.3. Only those
  +        support scripts cannot be used. If you have multiple Perl interpreters
  +        installed (perhaps a Perl 4 from the vendor and a Perl 5 from your
  +        own), then it is recommended to use the --with-perl option (see below)
  +        to make sure the correct one is selected by APACI.
  +
  +     o  Dynamic Shared Object (DSO) support [OPTIONAL]:
  +
  +        To provide maximum flexibility Apache now is able to load modules
  +        under runtime via the DSO mechanism by using the pragmatic
  +        dlopen()/dlsym() system calls. These system calls are not available
  +        under all operating systems therefore you cannot use the DSO mechanism
  +        on all platforms. And Apache currently has only limited built-in
  +        knowledge on how to compile shared objects because this is heavily
  +        platform-dependend. The current state is this:
  +
  +        o Out-of-the-box supported platforms are:
  +           - Linux     - IRIX    
  +           - FreeBSD   - OSF1    
  +           - Solaris   - UnixWare
  +           - SunOS
  +
  +        o Entirely unsupported platforms are:
  +           - HP-UX  (because no dlopen-style interface)
  +           - Ultrix (because no dlopen-style interface)
  +           - AIX    (although it has dlopen it is a braindead one)
  +
  +        If your system is not on these lists but has the dlopen-style
  +        interface, you either have to provide the appropriate compiler and
  +        linker flags (see CFLAGS_SHLIB, LDFLAGS_SHLIB and LDFLAGS_SHLIB_EXPORT
  +        below) manually or at least make sure a Perl 5 interpreter is
  +        installed from which Apache can guess the options.
   
     3. Configuring the source tree
        ---------------------------
  @@ -152,9 +182,7 @@
       no=disabled) can be seen when running `./configure --help'. There are two
       special NAME variants: "max" for enabling or disabling all modules except
       the bootstrapping "so" module and "remain" for enabling or disabling only
  -    these modules which are still not enabled. ATTENTION: Shared object
  -    support is not available on all platforms. See the src/Configuration.tmpl
  -    file for the definitive list of supported platforms.
  +    these modules which are still not enabled.
   
       Use the --with-perl=FILE option to select a particular Perl interpreter
       executable to be used with Apache. Per default APACI tries to find it