# HG changeset patch
# User paulb
# Date 1121177540 0
# Node ID b792fff1ebc92dfe0fe0d6c9ec0415d56fbdc844
# Parent  4c511fdbbf1f5bd8fa3d67c8485a176a8f280faf
[project @ 2005-07-12 14:12:20 by paulb]
Added AOLserver details.
Improved and tidied some things.

diff -r 4c511fdbbf1f -r b792fff1ebc9 docs/Webware/NOTES.txt
--- a/docs/Webware/NOTES.txt	Tue Jul 12 14:12:14 2005 +0000
+++ b/docs/Webware/NOTES.txt	Tue Jul 12 14:12:20 2005 +0000
@@ -1,13 +1,36 @@
-Webware's CGI adapter:
+Webware's CGI Adapter
+=====================
 
 Copy the Webware/WebKit/Adapters/WebKit.cgi file to your CGI directory (eg.
-/home/httpd/cgi-bin), then add a line like this to httpd.conf:
+/home/httpd/cgi-bin) and ensure that the permissions are appropriate for a CGI
+program.
+
+Configuring in Apache
+---------------------
+
+Add a line like this to your Apache configuration file (eg. httpd.conf):
 
 ScriptAlias /webkit "/home/httpd/cgi-bin/WebKit.cgi"
 
---------
+Configuring in AOLserver
+------------------------
+
+Ensure the presence of the following lines in your configuration file (eg.
+config.tcl):
 
-Authentication/authorisation in Webware:
+ns_section "ns/server/${servername}/module/nscgi"
+ns_param   map "GET  /webkit /home/httpd/cgi-bin/WebKit.cgi" ;# CGI script file dir (GET).
+ns_param   map "POST /webkit /home/httpd/cgi-bin/WebKit.cgi" ;# CGI script file dir (POST).
+ns_param   interps CGIinterps
+
+ns_section "ns/interps/CGIinterps"
+ns_param   .cgi "/usr/bin/python"
+
+See docs/CGI/NOTES.txt for more information on AOLserver and CGI
+configuration.
+
+Authentication/Authorisation in Webware
+=======================================
 
 Since Webware provides some kind of CGI emulation environment, the actual HTTP
 headers involved with authentication/authorisation are not available to the
@@ -38,9 +61,8 @@
 specific context (for Webware releases beyond 0.8.1) and only to a specific
 "region" of possible URLs (for Webware 0.8.1 and earlier).
 
---------
-
-For Webware releases beyond 0.8.1:
+For Webware Releases Beyond 0.8.1
+=================================
 
 WebStack applications are supported as contexts within WebKit, meaning that a
 certain prefix in the URL determines whether an application is sent a
@@ -73,9 +95,8 @@
 The WebStack package must reside on the PYTHONPATH, along with the package
 containing the application itself.
 
---------
-
-For Webware 0.8.1 or earlier:
+For Webware 0.8.1 or Earlier
+============================
 
 Support for WebStack applications is provided by a Webware plug-in which
 associates Webware resources having certain suffixes with certain WebStack