Better docs in ini file logging section

diff --git a/examples/development.ini b/examples/development.ini
index 25eec67e0186328335ee6977d2535098f1767cc9..4ea2ce8b926f2515f7ccf0be3f5846643fdb2569 100644 (file)
--- a/examples/development.ini
+++ b/examples/development.ini
@@ -161,6 +161,20 @@ keys = generic
 level = INFO
 handlers = console
 
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(asctime)s %(levelname)-5.5s [%(name)s][%(threadName)s] %(message)s
+
+# These sections don't do anything as given.  They are provided so that
+# logging can be customized per pgwui package.  You may want to add
+# "propagate = False" lines to avoid duplicate logging if you customize
+# them to emit log messages.
+
 [logger_pgwui_server]
 level = DEBUG
 handlers =
@@ -170,12 +184,3 @@ qualname = pgwui_server
 level = DEBUG
 handlers =
 qualname = pgwui_upload
-
-[handler_console]
-class = StreamHandler
-args = (sys.stderr,)
-level = NOTSET
-formatter = generic
-
-[formatter_generic]
-format = %(asctime)s %(levelname)-5.5s [%(name)s][%(threadName)s] %(message)s

diff --git a/examples/pgwui.ini b/examples/pgwui.ini
index 15cfbd32477b65c86ae8c48586f1b1fd6713393d..552dd3649c6a8dd51c09d28542f40fa9ef80cbd0 100644 (file)
--- a/examples/pgwui.ini
+++ b/examples/pgwui.ini
@@ -161,16 +161,6 @@ keys = generic
 level = WARN
 handlers = console
 
-[logger_pgwui_server]
-level = INFO
-handlers =
-qualname = pgwui_server
-
-[logger_pgwui_upload]
-level = INFO
-handlers =
-qualname = pgwui_upload
-
 [handler_syslog]
 class = logging.handlers.SysLogHandler
 args = ('/dev/log',)
@@ -185,3 +175,18 @@ formatter = generic
 
 [formatter_generic]
 format = %(asctime)s %(levelname)-5.5s [%(name)s][%(threadName)s] %(message)s
+
+# These sections don't do anything as given.  They are provided so that
+# logging can be customized per pgwui package.  You may want to add
+# "propagate = False" lines to avoid duplicate logging if you customize
+# them to emit log messages.
+
+[logger_pgwui_server]
+level = INFO
+handlers =
+qualname = pgwui_server
+
+[logger_pgwui_upload]
+level = INFO
+handlers =
+qualname = pgwui_upload