Add ZEO_CACHE_TRACE. Remove EVENT_LOG_FORMAT and STUPID_LOG_FORMAT.

Normalize whitespace (horizontal and vertical).

doc/ENVIRONMENT.txt

@@ -13,7 +13,6 @@ Zope installation
 
         See also: SOFTWARE_HOME
 
-
     SOFTWARE_HOME
 
         The SOFTWARE_HOME usually keeps the directory name of the
@@ -30,13 +29,11 @@ Zope installation
 
         See also: INSTANCE_HOME
 
-
     ZOPE_HOME
 
         ZOPE_HOME is the root of the Zope software, where the ZServer
         package, z2.py, and the default import directory may be found.
 
-
     FORCE_PRODUCT_LOAD
 
         This environment variable can be used to force or suppress
@@ -60,6 +57,7 @@ Zope installation
         nonempty string          set            Products are loaded
         empty string             set            Products are not loaded
 
+
 Profiling
 
     PROFILE_PUBLISHER
@@ -75,14 +73,12 @@ SiteAccess
 
         If set, all SiteRoots are suppressed (used by SiteAccess products).
 
-
     SUPPRESS_SITEROOT
 
         If set, all site access rules are suppressed (used by SiteAccess
         products).
 
 
-
 ZEO
 
     CLIENT_HOME
@@ -90,7 +86,6 @@ ZEO
         CLIENT_HOME allows ZEO clients to easily keep distinct pid and log
         files. This is currently an *experimental* feature.
 
-
     ZEO_CLIENT
 
         If you want a persistent client cache which retains cache contents
@@ -100,14 +95,17 @@ ZEO
         the client cache is stored in temporary files which are removed
         when the ClientStorage shuts down.
 
-Debugging and Logging
+    ZEO_CACHE_TRACE
 
-    EVENT_LOG_FORMAT or STUPID_LOG_FORMAT
+        To enable cache tracing, set this environment variable to the
+        basename of a file to which the ZEO client process can write.
+        ZEO will append a hyphen and the storage name to the filename,
+        to distinguish different storages.  If the file doesn't exist,
+        the ZEO will try to create it.  See lib/python/ZEO/README.txt
+        for more information.
 
-        Set this variable if you like to customize the output format of
-        Zope event logger.  EVENT_LOG_FORMAT is the preferred envvar
-        but STUPID_LOG_FORMAT also works.
 
+Debugging and Logging
 
     EVENT_LOG_FILE="path" or STUPID_LOG_FILE="path"
 
@@ -119,14 +117,12 @@ Debugging and Logging
 
         See also: LOGGING.txt
 
-
     EVENT_LOG_SEVERITY <number> or STUPID_LOG_SEVERITY <number>
 
         If set, Zope logs only messages whose severity is level is
         higher than the specified one.  EVENT_LOG_SEVERITY is the
         preferred envvar but STUPID_LOG_SEVERITY also works.
 
-
     ZSYSLOG="/dev/log"
 
         Setting this environment variable will cause Zope to try and write
@@ -135,7 +131,6 @@ Debugging and Logging
 
         See also: LOGGING.txt
 
-
     ZSYSLOG_FACILITY="facilityname"
 
         Setting this environment variable will cause Zope to use the syslog
@@ -145,7 +140,6 @@ Debugging and Logging
 
         See also: LOGGING.txt
 
-
     ZSYSLOG_SERVER="machine.name:port"
 
         Setting this environment variable tells Zope to connect a UDP
@@ -170,7 +164,7 @@ Debugging and Logging
         Run Zope in debug mode if set. Same as -D options (z2.py)
 
 
-Misc.
+Miscellaneous
 
     Z_REALM       "your realm"
     BOBO_REALM    "your realm" (obsolete)
@@ -186,7 +180,6 @@ Security related
 
        Unknown. Used by TAL
 
-
     ZOPE_SECURITY_POLICY
 
         If this variable is set to "PYTHON", Zope will use the traditional
@@ -194,19 +187,16 @@ Security related
         performance reasons Zope will use the cAccessControl module (Zope
         2.5+)
 
-
     ZSP_OWNEROUS_SKIP
 
         If set, will cause the Zope Security Policy to skip checks relating
 	to ownership, for servers on which ownership is not important.
 
-
     ZSP_AUTHENTICATED_SKIP
 
         If set, will cause the Zope Security Policy to skip checks relating
 	to authentication, for servers which serve only anonymous content.
 
-
     DISALLOW_LOCAL_PRODUCTS
 
         unknown
@@ -220,7 +210,6 @@ ZODB related
         bytes.  Additions to the database are not allowed if the database
         size exceeds the quota.
 
-
     ZOPE_READ_ONLY
 
         If this variable is set, then the database is opened in read only
@@ -229,6 +218,7 @@ ZODB related
         time given.  Note that changes made by another process after the
         database has been opened are not visible.
 
+
 Session related
 
     ZSESSION_ADD_NOTIFY
@@ -268,6 +258,7 @@ WebDAV
             WEBDAV_SOURCE_PORT_CLIENTS="cadaver.*"   enables retrieval
             of the document source for the Cadaver WebDAV client
 
+
 Structured Text
 
     STX_DEFAULT_LEVEL
@@ -275,6 +266,7 @@ Structured Text
        Set this variable to change the default level for <Hx> elements.
        The default level is 3.
 
+
 DTML
 
     ZOPE_DTML_REQUEST_AUTOQUOTE
@@ -287,6 +279,7 @@ DTML
         HTML quoted when interpolated with a <dtml-var> or &dtml-;
         construct.
 
+
 Esoteric
 
     Z_MAX_STACK_SIZE
@@ -294,9 +287,6 @@ Esoteric
         This variable allows you to customize the size of the Zope stack
         used by the SecurityManager (default 100).
 
-
     FORCE_PRODUCT_RELOAD
 
         unknown (Shane's Refresh product ???)
-
-