[z3-checkins] r10724 - z3/modzope/trunk/demosite

[philikon at codespeak.net]

Author: philikon
Date: Sat Apr 16 12:24:08 2005
New Revision: 10724

Modified:
   z3/modzope/trunk/demosite/apache2.conf
Log:
load zope 3 configuration upon apache startup
some explanations for some directives and reordering


Modified: z3/modzope/trunk/demosite/apache2.conf
==============================================================================
--- z3/modzope/trunk/demosite/apache2.conf	(original)
+++ z3/modzope/trunk/demosite/apache2.conf	Sat Apr 16 12:24:08 2005
@@ -5,11 +5,14 @@
 # Include this configuration file in your Apache2 configuration file
 # in an appropriate place, e.g.
 #
-# <Directory /var/www/>
+# <VirtualHost *:80>
 #   ...
 #   Include "/home/zope/modzope/demosite/apache2.conf"
-# </Directory>
+# </VirtualHost>
 #
+# **Note:** You can only load this configuration file globally or in a
+# VirtualHost.  It is not possible to enable modzope for a certain
+# directory (nor does it make any sense...).
 
 ### mod_python configuration ###
 
@@ -22,6 +25,7 @@
 # Default: None
 #
 # Example:
+     # enable mod_python for this VirtualHost
      SetHandler mod_python
 
 # Directive: PythonInterpreter
@@ -36,6 +40,8 @@
 # one subinterpreter.
 #
 # Example:
+    # give the Python interpreter a fixed name for the startup import
+    # (see below)
     PythonInterpreter modzope
 
 # Directive: PythonPath
@@ -49,7 +55,35 @@
 # Default: sys.path
 #
 # Example:
-    PythonPath "sys.path+['/Users/philipp/Zope3/src']"
+    # adjust this to your Zope 3 installation path and possibly other
+    # locations (e.g. your mod_python installation)
+    PythonPath "['/Users/philipp/lib/python', '/Users/philipp/Zope3/src']+sys.path"
+
+# Directive: PythonImport
+#
+# Description:
+#     Tells the server to import the Python module module at process
+#     startup under the specified interpreter name. This is useful for
+#     initialization tasks that could be time consuming and should not
+#     be done at the request processing time, e.g. initializing a
+#     database connection.
+#
+# Default: None
+#
+# Example:
+    # Load Zope 3 upon Apache startup
+    PythonImport modzope.app modzope
+
+# Directive: PythonHandler
+#
+# Description:
+#     Specifies the main request handler when using mod_python
+#
+# Default: None
+#
+# Example:
+     # Handle all requests through the Zope/WSGI glue handler
+     PythonHandler modzope.wsgizope
 
 # Directive: PythonAutoReload
 #
@@ -86,13 +120,3 @@
 #
 # Example:
 #    PythonEnablePdb On
-
-# Directive: PythonHandler
-#
-# Description:
-#     Specifies the main request handler when using mod_python
-#
-# Default: None
-#
-# Example:
-     PythonHandler modzope.wsgizope