Better documentation of the logging handlers

diff --git a/examples/etc/pgwui.yaml b/examples/etc/pgwui.yaml
index 4f54db74d134f9c5351276cf17bf6c6ae3504bfc..02845022e234db5c45243eb4c176d9e7602278fc 100644 (file)
--- a/examples/etc/pgwui.yaml
+++ b/examples/etc/pgwui.yaml
@@ -541,11 +541,15 @@ logging:
       format: '%(asctime)s [%(levelname)s]: %(name)s - %(message)s'
   handlers:
     console:
+      # "console" captures tracebacks, which the syslog handler does not
       class: logging.StreamHandler
       level: INFO
       stream: ext://sys.stdout
       formatter: console
     syslog:
+      # "syslog" logs to syslog (which then seems to log to journalctl).
+      # This seems to provide "hilighting" based on priority level in a way
+      # the console handler does not.
       class: logging.handlers.SysLogHandler
       level: INFO
       address: /dev/log