NAME

sman - Perl tool for searching man pages

SYNOPSIS

% sman boot disk
  # searches for man pages about 'boot disk'

% sman -m 10 -f -r linux kernel
  # show first 10 hits about the linux kernel
  # with the manpage's Rank and Filename

% sman '(linux and kernel and module) or (eepro100 and ipchains)'
  # a more complex query

% sman swishtitle=linux and desc=kernel
  # where title contains 'linux' and description contains 'kernel'

DESCRIPTION

Sman is the Searcher for Man pages. It depends on an index which is built by sman-update and by default resides in /var/lib/sman/sman.index.

Both sman and sman-update search for the first configuration file named sman.conf in /etc, /usr/local/etc/, $HOME, or the directory with sman. If no sman.conf file is found (or specified through the --config option), then the default configuration in /usr/local/etc/sman-defaults.conf will be used.

NOTE: In all cases command line options take precendence over directives read from configuration files.

AUTHOR

Josh Rabinowitz

SEE ALSO

the output of 'sman --help', sman, sman-update, sman.conf, SWISH-RUN, and the unrelated but similar "man -k", apropos and whatis