Skip to main content.
home | support | download

Back to List Archive

SMAN version 0.95 released (Searcher for Man Pages)

From: Josh Rabinowitz <joshr-swishe(at)>
Date: Mon Jun 27 2005 - 12:17:15 GMT
Hello Everyone,

Sman version 0.95 has been released. Sman is a 'man -k' and
'apropos' replacement based on perl and Swish-e that indexes
your system's man pages and runs on all tested UNIX-like OS's.

New in this version of Sman are many little changes for the
coming version of Swish-e and differences between machines.

Sman can be found at or at 
your favorite CPAN mirror. If you already have Swish-e installed, you 
can install Sman with a simple "sudo cpan Sman"! If Sman does work on 
your system, feel free to submit your test results to cpan-testers!

Changes since version 0.9.1:

0.95   Sat Jun 25 2005
     Changes for Swish-e deprecation of 'FuzzyIndexingMode Stem'
     Changed default to use 'zcat -f --stdout', not 'zcat -f'
     Changed -V output slightly
     More changes to tests
     Doc and typo fixes
     Avoid various warnings from different perls/OSs/helper programs
0.94   Wed Jan 05 2005
         Renumbered versions from 0.9.x to 0.9x
         Fixed perldoc for
         Prefix warnings from sman and sman-update with 'sman[-update]: '
         Have sman mention sman-update if the index file appears empty
0.9.3  Tue Jan 04 2005
         Moved perldocs from script/sman to
0.9.2  Tue Jan 04 2005
         Updated README to mention sman's --extract option
         Updated Usage in README and sman
         Change example in sman docs to use --rank instead of -r
         Show total hits and less about config files in sman -v
         Added Swish-e WordCharacters, BeginCharacters, and EndCharacters
          settings to sman-default.conf so that underscores and colons are
          accepted as word characters, so (for example) mod_perl and
          Apache::Test are each indexed as single words
         use length(content) & 'use bytes' instead of pack()
         Changed tests to succeed even if there is no 
/usr/local/lib/swish-e/ directory

  From the Sman README:

What is sman?  
     Sman is the Searcher for Man pages. Based on the example of the
     same name in Josh Rabinowitz's article "How To Index Anything"
     in the July, 2003 issue of Linux Journal
     (, sman is
     an enhanced version of 'apropos' and 'man -k'.  Sman adds
     several key abilities over its predecessors:
     * Supports complex natural language text searches such as
         "(linux and kernel) or (mach and microkernel)"
     * Shows results in a ranked order, and optionally an extract
        (using -e) of the manpage showing the searched text highlighted
     * Allows for searches by manpage section, title,
         body, or filename (use 'metaname=searchword')
     * Indexes the complete contents of the man page, not just
         the title and description
     * Uses a prebuilt index to perform fast searches

     * Performs 'stemming' so that a search for "searches"
       will match a document with the word "searching"
Where do I get sman?
     Sman is currently distributed from
     It's always best to make sure you use a current version of sman.

How do I install sman?

To install this module type the following:

    perl Makefile.PL
    make test
    make install

As always, bug reports, patches, and feedback welcome!
       Josh Rabinowitz
Received on Mon Jun 27 05:17:24 2005