Very early mod_aolserver support for Apache; passes smoke tests running
ACS.

Requires Apache built with shared module support.  Ideally, also built
with -g to ease debugging and interpretation of core dumps (though
*not* with -DALLOC_USE_MALLOC).

To build: First, read TODO, CAVEATS, and tcl_modules/README to have
some idea what you're in for, and then edit top of Makefile to suit
local configuration, make and make install.

Apache config file setup: the module adds two handlers, for adp and
aolserver tcl.

    AddHandler aolserver tcl
    AddHandler adp adp

These require Options ExecCGI to be on in the directory containing the
files, or they won't function.  (Note that the aolserver handler isn't
needed with ACS, which registers a proc to handle this case.  Note also
that the first of these handlers isn't really required for ACS, which
registers a proc to handle the case).

To get an ACS running, you'll want to add the following directives to
your httpd.conf --- 

  AddHandler adp adp
  AolServerConf config_file /path/to/your/nsd.ini
  DocumentRoot "/change/this/to/match/pageroot"
  # ... and do the same for the <Directory> section for the DocumentRoot
  #     in which you should also be sure that the ExecCGI option is
  #     enabled, and you have the following:
  <Directory "/change/this/to/match/pageroot">
      Options Indexes FollowSymLinks MultiViews ExecCGI
      DirectoryIndex index.adp index.tcl index.shtml index.html index.htm
      AddHandler adp adp
      ... other stuff ...
  </Directory>

This should cause aolserver stuff to run only in the virtual server
containing the AolServerConf directive, or the main server only if none,
but you're probably better off running this in the main server of a test
Apache installation right now, rather than running it in a virtual server
of your production installation.  There are two other optional AolServerConf
directives:

  # Result for [ns_info log]; without this, it's guessing.
  AolServerConf log_file_location /path/to/your/error/log

  # Location of gdbm file for nsv vars.  Should be on a local disk, 
  # just like the scoreboard.  Defaults to a file in the logs directory
  AolServerConf nsv_dbm_file /path/to/nsv_dbm_file

The build process itself, via apxs, should automatically have added:

  LoadModule aolserver_module   libexec/mod_aolserver.so

to httpd.conf, but I note it for completeness.
