update comments

diff --git a/src/cf.data.pre b/src/cf.data.pre
index dc2c1c316981429066efb5e51517ce6ff21c671c..ce7197a100166a1302f136b83436eedc3cd344ac 100644 (file)
--- a/src/cf.data.pre
+++ b/src/cf.data.pre
@@ -1,6 +1,6 @@
 
 #
-# $Id: cf.data.pre,v 1.107 1998/09/09 20:05:47 wessels Exp $
+# $Id: cf.data.pre,v 1.108 1998/09/14 02:33:54 wessels Exp $
 #
 #
 # SQUID Internet Object Cache  http://squid.nlanr.net/Squid/
@@ -158,8 +158,9 @@ DOC_START
 
        The default behaviour is to not bind to any specific address.
 
-       NOTE, udp_incoming_address and udp_outgoing_address can not have
-       the same value since they both use port 3130.
+       NOTE, udp_incoming_address and udp_outgoing_address can not
+       have the same value (unless it is 0.0.0.0) since they both use
+       port 3130.
 
 tcp_incoming_address 0.0.0.0
 tcp_outgoing_address 0.0.0.0
@@ -1511,9 +1512,14 @@ TYPE: string
 DEFAULT: nogroup
 LOC: Config.effectiveGroup
 DOC_START
+
        If the cache is run as root, it will change its effective/real
-       UID/GID to the UID/GID specified below.  The default is not to
-       change UID/GID.
+       UID/GID to the UID/GID specified below.  The default is to
+       change to UID to nobody and GID to nogroup.
+
+       If Squid is not started as root, the default is to keep the
+       current UID/GID.  Note that if Squid is not started as root then
+       you cannot set http_port to a value lower than 1024.
 
 cache_effective_user nobody
 cache_effective_group nogroup
@@ -1703,13 +1709,19 @@ TYPE: int
 DEFAULT: 10
 LOC: Config.Log.rotateNumber
 DOC_START
-       Specifies the number of logfile rotations to make upon
-       receiving a USR1 signal.  The default is 10, which will rotate
+       Specifies the number of logfile rotations to make when you
+       type 'squid -k rotate'.  The default is 10, which will rotate
        with extensions 0 through 9.  Setting logfile_rotate to 0 will
        disable the rotation, but the logfiles are still closed and
        re-opened.  This will enable you to rename the logfiles
-       yourself just before sending a USR1 signal to the Squid
-       process.
+       yourself just before sending the rotate signal.
+
+       Note, the 'squid -k rotate' command normally sends a USR1
+       signal to the running squid process.  In certain situations
+       (e.g. on Linux with Async I/O), USR1 is used for other
+       purposes, so -k rotate uses another signal.  It is best to get
+       in the habit of using 'squid -k rotate' instead of 'kill -USR1
+       <pid>'.
 
 logfile_rotate 10
 DOC_END