Next: Log, Previous: Browsing, Up: Top [Contents][Index]

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

Next: Log, Previous: Browsing, Up: Top [Contents][Index]