5 Customization

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.)

Customization Subgroups

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.