[ TOC ]
This document contains list of bug fixes and feature additions to SWISH-E.
[ TOC ]
Release Date: ???????
Many large changes were made internally in the code, some for performance reasons, some for feature changes and additions, and some to prepare for new features in later versions of SWISH-E.
Documentation is now included in the source distribution as .pod (perldoc) files, and as HTML files. In addition, the distribution can now generate PDF, postscript, and unix man pages from the source .pod files. See README for more information.
The indexing process has been imporoved. Depending on a number of factors, you may see a significant improvement in indexing speed, especially if upgrading from version 1.x.
Searching speed has also been improved. Properties are not loaded until results are displayed, and properties are pre-sorted during indexing to speed up sorting results by properties while searching.
Swish now stores document properties in a separate file. This means there
are now two files that make up a swish index. The default files are index.swish-e
and index.swish-e.prop
.
This change frees memory while indexing, allowing larger collections to be indexed in memory.
Pre 2.2 some internal data was stored in fixed locations within the index, namely the file name, file size, and title. 2.2 introduced new internal data such as the last modified date, and document summaries. This data is considered meta data since it is data about a document.
Instead of adding new data to the internal structure of the index file, it
was decided to use the MetaNames and PropertyNames feature of swish to
store this meta information. This allows for new meta data to be added at a
later time (e.g. Content-type), and provides an easy and customizable way
to print results with the -p
switch and the new -x
switch. In addition, search results can now be sorted and limited by
properties.
For example, to sort by the rank and title:
swish-e -w foo -s swishrank desc swishtitle asc |
If you are parsing output headers in a program then you may need to adjust your code. There's a new switch <-H> to control the level of header output when searching.
Swish now merges (and sorts) the results from multiple indexes when using -f
to specify more than one index. This change effects the way maxhits (-m
) works. Here's a summary of the way swish works for the different
versions.
1.3.2 - MaxHits returns first N results starting from the first index. e.g. maxhits=20; 15 hits Index1, 40 hits Index2 All 15 from Index1 plus first five from Index2 = 20 hits. |
2.0.0 - MaxHits returns first N results from each index. e.g. Maxhits=20; 15 hits Index1, 40 hits Index2 All 15 from Index1 plus 15 from Index2. |
2.2.0 - Results are merged and first N results are returned. e.g. Maxhits=20; 15 hits Index1, 40 hits Index2 Results are merged from each index and sorted (rank is the default sort) and only the first 20 are returned. |
You can now use -S prog to use an external program to supply documents to
swish. This external program can be used to spider web servers, index
databases, or to convert any type of document into html, xml, or text, so
it can be indexed by swish. Examples are given in the prog-bin
directory.
TranslateCharacters now is done before WordCharacters is checked. For example,
WordCharacters abcdefghijklmnopqrstuvwxyz TranslateCharacters ñ n |
Now El Niño
will be indexed as El Nino (el and nino), even though ñ
is not listed in WordCharacters.
Previously, stopwords were checked after stemming and soundex conversions, as well as most of the other word checks (WordCharacters, min/max length and so on). This meant that the stopword list probably didn't work as expected when using stemming.
The search parser was rewritten to correct a number of logic errors. Swish did not differentiate between meta names, swish operators and search words when parsing the query. This meant, for example, that metanames might be broken up by the WordCharacters setting, and that they could be stemmed.
Swish operator characters "*()=
can now be searched by escaping with a backslash. For example:
./swish-e -w 'this\=odd\)word' |
will end up searching for the word this=odd)word
. To search for a backslash character preceed it with a backslash.
Currently, searching for:
./swish-e -w 'this\*' |
is the same as a wildcard search. This may be fixed in the future.
Searching for buzzwords with those characters will still require backslashing. This also may change to allow some un-escaped operator characters, but some will always need to be escaped (e.g. the double-quote phrase character).
A bug was fixed in the parse_line()
function (in string.c) where backslashes were not escaping the next character. parse_line()
is used to parse a string of text into tokens (words). Normally splitting
is done at whitespace. You may use quotes (single or double) to define a
string (that might include whitespace) as a single parameter. The backslash
can also be used to escape the following character.
ReplaceRules append "foo bar" <- define "foo bar" as a single word ReplaceRules append foo\ bar <- same thing |
Previous versions of swish included a configuration file called user.config
which contained examples of all directives. This has been replace by a
series of example configuration files located in the conf
directory. The configuration directives are now described in SWISH-CONFIG.
David Norris has included the files required to build swish under Windows.
In addition, a binary version of swish for Win32 is now included in the
distribution. See src/win32
.
Jean-François Piéronne has provided the files required to build swish under
OpenVMS. See src/vms
for more information.
Multiple string properties of the same name in a document are now concatenated into one property. A space character is added between the strings if needed. A warning will be generated if multiple numeric or date properties are found in the same document, and the additional properties will be ignored.
Previously, properties of the same name were added to the index, but could not be retrieved.
To do: removed the next
pointer, and allow user-defined character to place between properties.
A more general purpose pattern replacement syntax.
Swish can now use Daniel Veillard's libxml2 library for parsing HTML and XML. This requires installation of the library before building swish-e. See the INSTALL document for information.
Swish now uses James Clark's expat XML parser library.
Swish can be compiled with zlib. This is useful for compressing large properties.
LST allowed indexing of files that contained multiple documents.
To improve security swish-e now uses the mkstemp(3)
function to create temporary files. Temporary files are used while indexing
only. This may result in some portability issues, but the security issues
were overriding.
mkstemp
opens the temporary with O_EXCL|O_CREAT flags. This prevents overwriting
existing files. In addition, the name of the file created is a lot harder
to guess by attackers. In addition, the temporary file is created with only
owner permissions.
Please report any portability issues on the swish-e discussion list.
Swish now uses the environment variables TMPDIR
, TMP
, and TEMP
(in that order) to decide where to write temporary files. The configuration
setting of TmpDir will be used if none of the environment variables are set. Swish uses the
current directory otherwise; there is no default temporary directory.
Since the environment variables override the configuration settings, a warning will be issued if you set TmpDir in the configuration file and there's also an environment variable set.
Temporary files begin with the letters ``swtmp'' (which can be changed in config.h), followed by two or more letters that indicate the type of temporary file, and some random characters to complete the file name. If indexing is aborted for some reason you may find these temporary files left behind.
Changes to Configuration File Directives. Please see SWISH-CONFIG for more info.
The IndexContents directive assigns internal Swish document parsers to files based on their file type. The DefaultContents directive assigns a parser to be used on file that are not assigned a parser with IndexContents.
This describes what to do when a meta tag is found in a document that is not listed in the MetaNames directive.
Will ignore listed tags in XML files
Passes words listed to the external swish-e program when running with
-S prog
document source method.
Controls parsing and conversion of HTML entities.
The word position is now bumped when a new metatag is found -- this is to prevent phrases from matching across meta tags. This directive will disable this behavior for the listed tags.
This directive works for HTML and XML documents.
This has been changed such that comments are not indexed by default.
The builtin list of stopwords has been removed. Use of the SwishDefault word will generate a warning, and no stop words will be used. You must now specify a list of stopwords, or specify a file of stopwords.
A sample file stopwords.txt
has been included in the conf/stopwords directory of the distribution, and can be used by the directive:
IgnoreWords File: /path/to/stopwords.txt |
The default is now ``yes''.
Buzzwords are words that should be indexed as-is, without checking for
stopwords, word length, WordCharacters, or any other of the word limiting
features. This allows indexing of things like C++
when ``+'' is not listed in WordCharacters.
Currenly, IgnoreFirstChar and IgnoreLastChar will be stripped before processing Buzzwords.
In the future we may use separate IgnoreFirst/Last settings for buzzwords
since, for example, you may wish to index all +
within swish words, but strip +
from the start/end of swish words, but not from the buzzword C++
.
Before Swish 2.2 all user-defined document properties were stored in the index as strings. PropertyNamesNumeric and PropertyNamesDate tells swish that a property should be stored in binary format. This allows for correct sorting of numeric properties.
Currenly, only integers can be stored, such as a unix timestamp. (Swish
uses strtoul
to convert the number to an unsigned long internally.)
PropertyNamesDate only indicates to swish that a number is a unix timestamp, and to display the property as a formatted time when printing results. Swish does not currently parse date strings; you must provide a unix timestamp.
You may now create alias names for MetaNames. This allow you to map or group multiple names to the same MetaName.
Creates aliases for a PropertyName.
Defines a metaname to use for indexing href links in HTML documents. Available only with libxml2 parser.
Defines a metaname to use for indexing src links in <img> tags. Allow you to search image pathnames within HTML pages. Available only with libxml2 parser.
Attempts to convert relative links indexed with HTMLLinksMetaName and ImageLinksMetaName to absolute links. Available only with libxml2 parser.
Allows you to use a regular expression to extract out part of the path of each file and index it with a meta name. For example, this allows searches to be limited to parts of your file tree.
FileMatch is similar to FileRules. Where FileRules is used to exclude files and directoires, FileMatch is used to include files.
Controls which properties are pre-sorted while indexing. All properties are sorted by default.
Sets the level of warning printed when using libxml2.
When using libxml2 to parse HTML, swish-e will skip files marked as NOINDEX.
<meta name="robots" content="noindex"> |
This describes how the content of XML attributes should be indexed, if at all. This is similar to UndefinedMetaTags, but is only for XML attributes and when parsed by libxml2. The default is to not index XML attributes.
XMLClassAttributes can specify a list of attribute names whose content is combined with the element name to form metanames.
If compiled with zlib, Swish uses this setting to control the level of compression applied to properties. Properties must be long enough (defined in config.h) to be compressed. Useful for StoreDescription.
Changes to command line arguments. See SWISH-RUN for documentation on these switches.
Controls the level (verbosity) of header information printed with search results.
Provides additional header output and allows for a format string to describe what data to print.
Prints words stored in the swish index.
Provides a way to do incremental indexing by comparing last modification
dates. You pass -N
a path to a file and only files newer than the last modified date of that
file will be indexed.
-D
no longer dumps the index file data. Use -T
instead.
-T
is used for debugging indexing and searching.
Now -d
can accept some back-slashed characters to be used as output separators.
Now -P sets the phrase delimiter character in searches.
Swish 2.2 contains an experimental feature to limit results by a range of property values. This behavior of this feature may change in the future.