From 00d125e11816ac2d2b1b5bf34a815d2cda0b1633 Mon Sep 17 00:00:00 2001
From: "Karl O. Pinc" <kop@karlpinc.com>
Date: Wed, 4 Dec 2019 16:32:19 -0600
Subject: [PATCH] Better docs in ini file logging section

---
 examples/development.ini | 23 ++++++++++++++---------
 examples/pgwui.ini       | 25 +++++++++++++++----------
 2 files changed, 29 insertions(+), 19 deletions(-)

diff --git a/examples/development.ini b/examples/development.ini
index 25eec67..4ea2ce8 100644
--- 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 15cfbd3..552dd36 100644
--- 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
-- 
2.34.1