doc: specify seconds in proxy-server.conf-sample

Most of swift's timing configuration values should accept units in
seconds; make this explicit in the sample config for values that did not
already do so.

Related-Change-Id: I38c11b7aae8c4112bb3d671fa96012ab0c44d5a2
Change-Id: I5b25b7e830a31f03d11f371adf12289222222eb2
Signed-off-by: Clay Gerrard <clay.gerrard@gmail.com>

etc/proxy-server.conf-sample

@@ -1,7 +1,9 @@
 [DEFAULT]
 # bind_ip = 0.0.0.0
 bind_port = 8080
+# Connection idle timeout (in seconds)
 # keep_idle = 600
+# Socket bind timeout (in seconds)
 # bind_timeout = 30
 # backlog = 4096
 # swift_dir = /etc/swift
@@ -180,7 +182,9 @@ use = egg:swift#proxy
 # require_proxy_protocol = false
 #
 # log_handoffs = true
+# How long (in seconds) to cache account existence information
 # recheck_account_existence = 60
+# How long (in seconds) to cache container existence information
 # recheck_container_existence = 60
 #
 # How long the proxy should cache a set of shard ranges for a container when
@@ -213,23 +217,24 @@ use = egg:swift#proxy
 # usage of cooperative token and directly talk to the backend and memcache.
 # namespace_cache_tokens_per_session = 3
 #
-# The average time spent on getting updating namespaces from the container
-# servers, this will be used as basic unit for cooperative token to figure out
-# intervals for the retries when requests didn't acquire a token and are
-# waiting for other requests to fill in the cache; and a cooperative token
+# The average time spent (in seconds) on getting updating namespaces from the
+# container servers, this will be used as basic unit for cooperative token to
+# figure out intervals for the retries when requests didn't acquire a token and
+# are waiting for other requests to fill in the cache; and a cooperative token
 # session (`token_ttl`) will be 10 times of this value.
 # namespace_avg_backend_fetch_time = 0.3
 #
 # object_chunk_size = 65536
 # client_chunk_size = 65536
 #
-# How long the proxy server will wait on responses from the a/c/o servers.
+# How long (in seconds) the proxy server will wait on responses from the a/c/o
+# servers.
 # node_timeout = 10
 #
-# How long the proxy server will wait for an initial response and to read a
-# chunk of data from the object servers while serving GET / HEAD requests.
-# Timeouts from these requests can be recovered from so setting this to
-# something lower than node_timeout would provide quicker error recovery
+# How long (in seconds) the proxy server will wait for an initial response and
+# to read a chunk of data from the object servers while serving GET / HEAD
+# requests.  Timeouts from these requests can be recovered from so setting this
+# to something lower than node_timeout would provide quicker error recovery
 # while allowing for a longer timeout for non-recoverable requests (PUTs).
 # Does not apply to requests with a truthy X-Newest header value.
 # Defaults to node_timeout, should be overridden if node_timeout is set to a
@@ -237,13 +242,16 @@ use = egg:swift#proxy
 # has a chance to retry.
 # recoverable_node_timeout = node_timeout
 #
+# Connection timeout (in seconds)
 # conn_timeout = 0.5
 #
-# How long to wait for requests to finish after a quorum has been established.
+# How long (in seconds) to wait for requests to finish after a quorum has been
+# established.
 # post_quorum_timeout = 0.5
 #
-# How long without an error before a node's error count is reset. This will
-# also be how long before a node is reenabled after suppression is triggered.
+# How long (in seconds) without an error before a node's error count is reset.
+# This will also be how long before a node is reenabled after suppression is
+# triggered.
 # Set to 0 to disable error-limiting.
 # error_suppression_interval = 60.0
 #
@@ -301,11 +309,11 @@ use = egg:swift#proxy
 # contexts this will be the first backend replica to respond.
 # concurrent_gets = off
 #
-# This parameter controls how long to wait before firing off the next
-# concurrent_get thread. A value of 0 would be fully concurrent, any other
-# number will stagger the firing of the threads. This number should be
-# between 0 and node_timeout. The default is what ever you set for the
-# conn_timeout parameter.
+# This parameter controls how long (in seconds) to wait before firing off the
+# next concurrent_get thread. A value of 0 would be fully concurrent, any other
+# number will stagger the firing of the threads. This number should be between
+# 0 and node_timeout. The default is what ever you set for the conn_timeout
+# parameter.
 # concurrency_timeout = 0.5
 #
 # By default on a EC GET request swift will connect to a minimum number of
@@ -459,6 +467,7 @@ use = egg:swift#tempauth
 # The auth prefix will cause requests beginning with this prefix to be routed
 # to the auth subsystem, for granting tokens, etc.
 # auth_prefix = /auth/
+# Token lifetime (in seconds)
 # token_life = 86400
 #
 # This allows middleware higher in the WSGI pipeline to override auth
@@ -771,7 +780,7 @@ delay_auth_decision = False
 # configured: in particular, the Keystone API version must be included.
 auth_uri = http://keystonehost:5000/v3
 
-# Connect/read timeout to use when communicating with Keystone
+# Connect/read timeout (in seconds) to use when communicating with Keystone
 http_timeout = 10.0
 
 # Number of seconds to cache the S3 secret. By setting this to a positive
@@ -835,9 +844,9 @@ use = egg:swift#memcache
 # Sets the maximum number of connections to each memcached server per worker
 # memcache_max_connections = 2
 #
-# How long without an error before a server's error count is reset. This will
-# also be how long before a server is reenabled after suppression is triggered.
-# Set to 0 to disable error-limiting.
+# How long (in seconds) without an error before a server's error count is
+# reset. This will also be how long before a server is reenabled after
+# suppression is triggered.  Set to 0 to disable error-limiting.
 # error_suppression_interval = 60.0
 #
 # How many errors can accumulate before a server is temporarily ignored.
@@ -1260,7 +1269,7 @@ use = egg:swift#xprofile
 # log_filename_prefix = /tmp/log/swift/profile/default.profile
 #
 # the profile data will be dumped to local disk based on above naming rule
-# in this interval.
+# in this interval (in seconds).
 # dump_interval = 5.0
 #
 # Be careful, this option will enable profiler to dump data into the file with