Merge lp:~jaypipes/glance/docs into lp:~hudson-openstack/glance/trunk

[Jay Pipes]

Improve logging configuration docs...

[Brian Waldon (bcwaldon)]

Looks good, as long as it addresses Steve's original concern.

review: Approve

[Cory Wright (corywright)]

lgtm.

Steve?

review: Approve

=== modified file 'doc/source/configuring.rst'
--- doc/source/configuring.rst	2011-04-04 17:00:26 +0000
+++ doc/source/configuring.rst	2011-04-26 23:45:44 +0000
@@ -66,8 +66,7 @@
 -----------------------------
 
 There are a number of configuration options in Glance that control how Glance
-servers log messages. The configuration options can be specified both on the
-command line and in the ``glance.conf`` config file.
+servers log messages.
 
 * ``--log-config=PATH``
 
@@ -77,30 +76,33 @@
 
 Takes a path to a configuration file to use for configuring logging.
 
-* ``--log-format``
-
-`Because of a bug in the PasteDeploy package, this option is only available
-on the command line.`
-
-Optional. Default: ``%(asctime)s %(levelname)8s [%(name)s] %(message)s``
-
-The format of the log records. See the
-`logging module <http://docs.python.org/library/logging.html>`_ documentation for
-more information on setting this format string.
-
-* ``log_file`` (``--log-file`` when specified on the command line)
+Logging Options Available in ``glance.conf``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You will want to place the different logging options **in each of the API and registry
+application sections in your glance.conf**. As an example, you might do the following::
+
+  [app:glance-api]
+  ... other options ...
+  log_file = /var/log/glance/api.log
+
+  [app:glance-registry]
+  ... other options ...
+  log_file = /var/log/glance/registry.log
+
+* ``log_file``
 
 The filepath of the file to use for logging messages from Glance's servers. If
 missing, the default is to output messages to ``stdout``, so if you are running
 Glance servers in a daemon mode (using ``glance-control``) you should make
 sure that the ``log_file`` option is set appropriately.
 
-* ``log_dir`` (``--log-dir`` when specified on the command line)
+* ``log_dir``
 
 The filepath of the directory to use for log files. If not specified (the default)
 the ``log_file`` is used as an absolute filepath.
 
-* ``log_date_format`` (``--log-date-format`` when specified from the command line)
+* ``log_date_format``
 
 The format string for timestamps in the log output.