summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDavid Champion <dgc@extrahop.com>2020-11-19 19:04:52 -0800
committerKevin McCarthy <kevin@8t8.us>2020-11-22 09:30:37 -0800
commit03803e6789fb9a27570b75f3e6510e1881f63673 (patch)
tree8c9173a74199ee95ed2784bc8fd4b54727097093 /doc
parentbb0cd9442a1aad91a9597e64b75392debcee0a95 (diff)
Allow debugging without debug file rotation.
start_debug() takes a boolean indicating whether to rotate debug files. The -d option allows a negative number. If negative, debug files are not rotated. The debug level is the absolute value. This is useful for continuously watching (e.g. tail -f) the .muttdebug0 file.
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.xml.head6
-rw-r--r--doc/mutt.man6
2 files changed, 9 insertions, 3 deletions
diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 36543eb5..dc3f9550 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -10922,7 +10922,11 @@ mailboxes and to send messages from the command line as well.
<row><entry>-a</entry><entry>attach a file to a message</entry></row>
<row><entry>-b</entry><entry>specify a blind carbon-copy (BCC) address</entry></row>
<row><entry>-c</entry><entry>specify a carbon-copy (Cc) address</entry></row>
-<row><entry>-d</entry><entry>log debugging output to ~/.muttdebug0 if mutt was compiled with +DEBUG; it can range from 1-5 and affects verbosity (a value of 2 is recommended)</entry></row>
+<row><entry>-d</entry><entry>log debugging output to ~/.muttdebug0 if
+mutt was compiled with +DEBUG; it can range from -5 to 5 and affects
+verbosity. A value of 0 disables debugging. A value less than zero
+disables automatic log file rotation. A value of 2 is recommended for
+most diagnostics.</entry></row>
<row><entry>-D</entry><entry>print the value of all Mutt variables to stdout</entry></row>
<row><entry>-E</entry><entry>edit the draft (-H) or include (-i) file</entry></row>
<row><entry>-e</entry><entry>specify a config command to be run after initialization files are read</entry></row>
diff --git a/doc/mutt.man b/doc/mutt.man
index 232694b7..291c7d15 100644
--- a/doc/mutt.man
+++ b/doc/mutt.man
@@ -118,8 +118,10 @@ Specify a carbon copy (CC) address.
.BI \-d " level"
If Mutt was compiled with \fB+DEBUG\fP log debugging output to
\fI~/.muttdebug0\fP.
-\fILevel\fP can range from 1-5 and effects verbosity.
-A value of 2 is recommended.
+\fILevel\fP can range from -5 to 5 and affects verbosity. A value of
+zero disables debugging. A value less than zero disables automatic log
+file rotation; the log level is then its absolute value. A value of 2
+(-2) is recommended for most diagnosis.
.TP
.B \-D
Print the value of all configuration options to stdout.