# HG changeset patch
# User Denis Laxalde <denis.laxalde@logilab.fr>
# Date 1490189890 -3600
# Node ID 4521295112447685acb7d095b3e1deb99ce47628
# Parent  78a5c6a64fad9539b8413d7275cfccd4e44ac1da
[doc] Update "settings" pyramid documentation

Document that without "bwcompat" we can use a development.ini file directly
and add a dedicated section to list configuration options.

diff -r 78a5c6a64fad -r 452129511244 doc/book/pyramid/settings.rst
--- a/doc/book/pyramid/settings.rst	Wed Mar 22 14:37:04 2017 +0100
+++ b/doc/book/pyramid/settings.rst	Wed Mar 22 14:38:10 2017 +0100
@@ -13,12 +13,13 @@
 
 .. _pyramid_settings:
 
-Pyramid Settings
-----------------
+Pyramid Settings file
+---------------------
 
-If a ``pyramid.ini`` file is found in the instance home directory (where the
-``all-in-one.conf`` file is), its ``[main]`` section will be read and used as the
-``settings`` of the pyramid Configurator.
+In *backwards compatibility* mode, Pyramid settings will be looked for in a
+``pyramid.ini`` file in the instance home directory (where the
+``all-in-one.conf`` file is), its ``[main]`` section will be read and used as
+the ``settings`` of the pyramid Configurator.
 
 This configuration file is almost the same as the one read by ``pserve``, which
 allow to easily add any pyramid extension and configure it.
@@ -43,6 +44,14 @@
 
     redis.sessions.host = mywheezy
 
+
+Without *backwards compatibility* a standard ``development.ini`` file can be
+used with any useful CubicWeb-specific settings added.
+
+
+Pyramid CubicWeb configuration entries
+--------------------------------------
+
 The Pyramid CubicWeb specific configuration entries are:
 
 .. confval:: cubicweb.instance (string)