This is modeled on the Emacs byte-compiler. It logs all files
formatted by WoMan and the time taken. If WoMan finds anything that it
cannot handle then it writes a warning to this buffer. If the variable
woman-show-log
is non-nil
(by default it is nil
) then
WoMan automatically displays this buffer. See Interface Options. Many WoMan warnings can be completely ignored,
because they are reporting the fact that WoMan has ignored requests that
it is correct for WoMan to ignore. In some future version this level of
paranoia may be reduced, but not until WoMan is deemed more reliable.
At present, all warnings should be treated with some suspicion.
Uninterpreted escape sequences are also logged (in some cases).
By resetting the variable woman-ignore
to nil
(by default
it is t
), uninterpreted roff
requests can optionally be
left in the formatted buffer to indicate precisely where they occurred.
See Interface Options.