woman: Filename
3.2 Filename Interface
======================
The commands in this family are completely independent of the topic
interface, caching mechanism, etc.
The filename interface is accessed principally via the extended command
‘woman-find-file’, which is available without any configuration at all
(provided WoMan is installed and loaded or set up to autoload). This
command can be used to browse any accessible man file, regardless of its
filename or location. If the file is compressed then automatic file
decompression must already be turned on (e.g., see the ‘Help->Options’
submenu)—it is turned on automatically only by the ‘woman’ topic
interface.
Once WoMan is loaded (or if specially set up), various additional
commands in this family are available. In a dired buffer, the command
‘woman-dired-find-file’ allows the file on the same line as point to be
formatted and browsed by WoMan. It is bound to the key ‘W’ in the dired
mode map and added to the dired major mode menu. It may also be bound
to ‘w’, unless this key is bound by another library, which it is by
‘dired-x’, for example. Because it is quite likely that other libraries
will extend the capabilities of such a commonly used mode as dired, the
precise key bindings added by WoMan to the dired mode map are controlled
by the user option ‘woman-dired-keys’.
When a tar (Tape ARchive) file is visited in Emacs, it is opened in tar
mode, which parses the tar file and shows a dired-like view of its
contents. The WoMan command ‘woman-tar-extract-file’ allows the file on
the same line as point to be formatted and browsed by WoMan. It is
bound to the key ‘w’ in the tar mode map and added to the tar major mode
menu.
The command ‘woman-reformat-last-file’, which is bound to the key ‘R’ in
WoMan mode and available on the major mode menu, reformats the last file
formatted by WoMan. This may occasionally be useful if formatting
parameters, such as the fill column, are changed, or perhaps if the
buffer is somehow corrupted.
The command ‘woman-decode-buffer’ can be used to decode and browse the
current buffer if it is visiting a man file, although it is primarily
used internally by WoMan.