Document the DEBUG log level.

diff --git a/doc/htsnrc.example b/doc/htsnrc.example
index 3a2347c9e82a7d22b8d230c293d1cc9028213b25..bb2de46199e2b1b98582612bdbf6f57d670e0f5f 100644 (file)
--- a/doc/htsnrc.example
+++ b/doc/htsnrc.example
@@ -40,9 +40,10 @@
 
 # How verbose should the logs be? Valid levels are,
 #
-#   "INFO", "WARNING", "ERROR"
+#   "DEBUG", "INFO", "WARNING", "ERROR"
 #
-# (there are others, but we don't emit them.)
+# (there are others, but we don't emit them.) The debug output is
+# extremely verbose and will not be written to syslog even if you try.
 #
 # Default: "INFO"
 #

diff --git a/doc/man1/htsn.1 b/doc/man1/htsn.1
index 43858c6b53a8edd5f0eac629e22e07ccb6da7da2..2ccb43cc273d51f9c1ef6c31c2c199263170a351 100644 (file)
--- a/doc/man1/htsn.1
+++ b/doc/man1/htsn.1
@@ -77,10 +77,11 @@ will not be auto-rotated; use something like logrotate for that.
 Default: none
 
 .IP \fB\-\-log-level\fR
-How verbose should the logs be? We log notifications at three levels:
-INFO, WARN, and ERROR. Specify the \(dqmost boring\(dq level of
+How verbose should the logs be? We log notifications at four levels:
+DEBUG, INFO, WARN, and ERROR. Specify the \(dqmost boring\(dq level of
 notifications you would like to receive (in all-caps); more
-interesting notifications will be logged as well.
+interesting notifications will be logged as well. The debug output is
+extremely verbose and will not be written to syslog even if you try.
 
 Default: INFO
 

diff --git a/htsn.cabal b/htsn.cabal
index 0ef3b5d3b79eb19dc60e61d0504fe4a70eed9acb..2e3358918b8b14fefeb5830f17d93aa1008e188b 100644 (file)
--- a/htsn.cabal
+++ b/htsn.cabal
@@ -97,10 +97,11 @@ description:
   \--log-level
   @
   .
-  How verbose should the logs be? We log notifications at three levels:
-  INFO, WARN, and ERROR. Specify the \"most boring\" level of
+  How verbose should the logs be? We log notifications at four levels:
+  DEBUG, INFO, WARN, and ERROR. Specify the \"most boring\" level of
   notifications you would like to receive (in all-caps); more
-  interesting notifications will be logged as well.
+  interesting notifications will be logged as well. The debug output is
+  extremely verbose and will not be written to syslog even if you try.
   .
   Default: INFO
   .