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 http://search.cpan.org/~joshr/Sman-0.95/ 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 Sman.pm
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 Sman.pm
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
(http://www.linuxjournal.com/article.php?sid=6652), 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 http://joshr.com/src/sman.
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
make test
make install
As always, bug reports, patches, and feedback welcome!
Best
Josh Rabinowitz
http://joshr.com
Received on Mon Jun 27 05:17:24 2005