All WoMan user options are customizable, and it is recommended to
change them only via the standard Emacs customization facilities.
WoMan defines a top-level customization group called WoMan
under the parent group Help
. It can be accessed either via the
standard Emacs facilities, e.g., via the ‘Help->Customize’
submenu, or via the WoMan major mode menu.
The top-level WoMan group contains only a few general options and three
subgroups. The hooks are provided only for special purposes that, for
example, require code to be executed, and should be changed only via
Customization
or the function add-hook
. Most
customization should be possible via existing user options.
woman-show-log
¶A boolean value that defaults to nil
. If non-nil
then show the
*WoMan-Log* buffer if appropriate, i.e., if any warning messages
are written to it. See The *WoMan-Log* Buffer.
woman-pre-format-hook
¶A hook run immediately before formatting a buffer. It might, for example, be used for face customization. See Faces, however.
woman-post-format-hook
¶A hook run immediately after formatting a buffer. It might, for
example, be used for installing a dynamic menu using imenu
.
(However. in this case it is better to use the built-in WoMan
imenu
support. See Imenu Support; Contents Menu.)
WoMan Interface
These options control the process of locating the appropriate file to browse, and the appearance of the browsing interface.
WoMan Formatting
These options control the layout that WoMan uses to format the man page.
WoMan Faces
These options control the display faces that WoMan uses to format the man page.