[ADD] documentation for un-deprecated --log-level

1 files changed, 29 insertions, 0 deletions

diff --git a/doc/reference/cmdline.rst b/doc/reference/cmdline.rst
index 269f62ed2eb..280cd079622 100644
--- a/doc/reference/cmdline.rst
+++ b/doc/reference/cmdline.rst
@@ -249,6 +249,35 @@ customize the amout of logging output
     enables DEBUG logging of SQL querying, equivalent to
     ``--log-handler=openerp.sql_db:DEBUG``
 
+.. option:: --log-level <level>
+
+    Shortcut to more easily set predefined levels on specific loggers. "real"
+    levels (``critical``, ``error``, ``warn``, ``debug``) are set on the
+    ``openerp`` and ``werkzeug`` loggers (except for ``debug`` which is only
+    set on ``openerp``).
+
+    Odoo also provides debugging pseudo-levels which apply to different sets
+    of loggers:
+
+    ``debug_sql``
+        sets the SQL logger to ``debug``
+
+        equivalent to ``--log-sql``
+    ``debug_rpc``
+        sets the ``openerp`` and HTTP request loggers to ``debug``
+
+        equivalent to ``--log-level debug --log-request``
+    ``debug_rpc_answer``
+        sets the ``openerp`` and HTTP request and response loggers to
+        ``debug``
+
+        equivalent to ``--log-level debug --log-request --log-response``
+
+    .. note::
+
+        In case of conflict between :option:`--log-level` and
+        :option:`--log-handler`, the latter is used
+
 .. _reference/cmdline/scaffold:
 
 Scaffolding