Package: doodle Version: 0.6.3-1 Severity: wishlist please add more explicit documentation on how to have doodle do a full-text indexing of documents. While the package description promises full-text indexing, this is not turned on by default, and the documentation shipped with the package makes no explicit mention about how to turn it on. It was only today when I read their website that I came across the following paragraph: (from http://gnunet.org/doodle/)
>Full-text search
>You can achieve a (limited) form of full-text search with doodle. For
>that, the dictionary-based plaintext extractors from libextractor are
>used. In order to use them, you need to pass the option -b LANG to
>doodle. LANG is a two letter language code that selects the dictionary.
>Available languages at the moment are en, es, fr, it and no. Words and
>sentences that are available in the respective dictionaries for these
>languages will then be added to the index. While libextractor attempts
>to avoid full-text extraction for certain kown binary formats, it may
>still find words in non-text files. Running with this option will
>dramatically increase the size of the index and the time it takes to
>build the index. Note that if you change the options used to build a
>database will not (!) result in doodle re-indexing files that were
>processed with other options previously. The only way to force doodle to
>re-index files with different options is to either touch the files
>(change modification timestamp) or to delete the old database and start
>from scratch.
perhaps that (together with the two paragraphs below: "Hints for system
administrators" and "Using different options") could be added to
/usr/share/doc/doodle/
NOTE that I think the option should be -B LANG, and that the choices of
languages given in this paragraph is not the same, nor a superset of the
languages mentioned in the manpage
I also suggest a sentence be added to both the doodle and the doodled
manpage's description of the -B option that this is what actually turns
on fulltext indexing. And while you're at it, you may want to delete the
last sentence of that description ("This option only makes sense
together with the -b option.") from the doodled manpage, as doodled of
course has no -b option.
best,
Florian
-- System Information:
Debian Release: testing/unstable
APT prefers testing
APT policy: (650, 'testing'), (600, 'unstable')
Architecture: i386 (i686)
Shell: /bin/sh linked to /bin/dash
Kernel: Linux 2.6.14-2-686
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Versions of packages doodle depends on:
ii adduser 3.80 Add and remove users and groups
ii libdoodle1 0.6.3-1 Desktop Search Engine (Library)
doodle recommends no packages.
-- no debconf information
signature.asc
Description: Digital signature
