From c9a0172d5816e5933d28f40a49220edb3fe8db4e Mon Sep 17 00:00:00 2001 From: Jean-Francois Dockes Date: Mon, 27 Sep 2010 14:17:35 +0200 Subject: [PATCH] doc --- src/doc/user/usermanual.sgml | 8 +++++++- website/BUGS.html | 4 ++++ website/features.html | 20 +++++++++++++++----- website/filters/filters.html | 20 ++++++++++---------- website/filters/mimeconf | 9 ++++++--- website/filters/mimemap | 5 ++++- website/filters/mimeview | 7 ++++++- website/index.html.en | 25 ++++++++++++++++--------- website/index.html.fr | 12 +++++++----- 9 files changed, 75 insertions(+), 35 deletions(-) diff --git a/src/doc/user/usermanual.sgml b/src/doc/user/usermanual.sgml index 18f70b4e..b8f278d6 100644 --- a/src/doc/user/usermanual.sgml +++ b/src/doc/user/usermanual.sgml @@ -2650,7 +2650,13 @@ while query.next >= 0 and query.next < nres: Postscript: - pstotext. + pstotext. The original version has an issue with shell + character in file names. Most recent package repositories / + ports system use a patched version (ie FreeBSD, Debian). If + compiling from source, it would be better to apply the patch + found + + here. MS Word: diff --git a/website/BUGS.html b/website/BUGS.html index 6a48d83b..09f41004 100644 --- a/website/BUGS.html +++ b/website/BUGS.html @@ -37,6 +37,10 @@

recoll 1.14.2 + xapian 1.2+ + qt 4.4.1+

    +
  • The new mutagen-based audio tags filter (rclaudio) only + works with very recent mutagen + versions. See here for a + corrected version.
  • Performing a full index with release 1.11 or later, over a version created with a much older recoll release may sometimes end with an error saying "backend doesn't diff --git a/website/features.html b/website/features.html index 04ef522c..6c672749 100644 --- a/website/features.html +++ b/website/features.html @@ -133,11 +133,21 @@
  • Wordperfect with libwpd.
    • -
  • postscript with - ghostscript and pstotext.
    • +
  • postscript with + + ghostscript and + + pstotext. + Actually the pstotext 1.9 found at the latter link + has a problem with file names using special shell + characters, and you should either use the version + packaged for your system which is probably patched, + or apply the Debian patch which is + stored here + for convenience. See + http://packages.debian.org/squeeze/pstotext and + http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=356988 + for references/explanations.
  • rtf with unrtf.
    • diff --git a/website/filters/filters.html b/website/filters/filters.html index 6328d733..3dd06c34 100644 --- a/website/filters/filters.html +++ b/website/filters/filters.html @@ -64,21 +64,21 @@ mimeconf mimeview

    + - -

    Updated icalendar filter

    -

    The filter script for all releases up and including 1.13.04 used - the icalendar Python module which is not robust enough against some - syntax errors (found for example in Mozilla exports). The new version - uses an internal trivial parser, which will hopefully be both - sufficient for what we are doing and more robust. - You can download the new script. This will not - work for versions prior to 1.13.

    +

    Updated audio tag filter

    +

    The mutagen-based rclaudio filter delivered with recoll 1.14.2 + used a very recent mutagen interface which will only work with + mutagen versions after 1.17 (probably. at least works with 1.19, + doesn't with 1.15). + You can download the corrected script here. +

    diff --git a/website/filters/mimeconf b/website/filters/mimeconf index 9e7af312..8b06ae12 100644 --- a/website/filters/mimeconf +++ b/website/filters/mimeconf @@ -36,7 +36,7 @@ application/msword = exec antiword -t -i 1 -m UTF-8;mimetype=text/plain;charset= # antiword, but will handle documents which provoke the 'I'm afraid the # text stream of this file is too small to handle' antiword error # application/msword = exec wvWare --charset=utf-8 --nographics -application/ogg = exec rclogg +application/ogg = execm rclaudio application/pdf = exec rclpdf application/postscript = exec pstotext;charset=iso-8859-1;mimetype=text/plain application/vnd.ms-excel = exec xls2csv -c " " -d utf-8;charset=utf-8;mimetype=text/plain @@ -67,7 +67,7 @@ application/vnd.wordperfect = exec wpd2html;mimetype=text/html application/x-abiword = exec rclabw application/x-awk = internal application/x-dvi = exec rcldvi -application/x-flac = exec rclflac +application/x-flac = execm rclaudio application/x-kword = exec rclkwd application/x-lyx = exec rcllyx application/x-perl = internal @@ -76,7 +76,7 @@ application/x-shellscript = internal application/x-tex = exec rcltex application/x-chm = execm rclchm application/zip = execm rclzip -audio/mpeg = exec rclid3 +audio/mpeg = execm rclaudio image/gif = execm rclimg image/jpeg = execm rclimg image/png = execm rclimg @@ -92,6 +92,7 @@ text/x-c = internal text/x-fictionbook = exec rclfb2 text/x-gaim-log = exec rclgaim text/x-html-sidux-man = exec rclsiduxman +text/x-html-aptosid-man = exec rclaptosidman text/x-mail = internal text/x-man = exec rclman text/x-purple-log = exec rclpurple @@ -154,6 +155,7 @@ text/x-c = source text/x-c++ = source text/x-fictionbook = document text/x-html-sidux-man = sidux-book +text/x-html-aptosid-man = aptosid-manual text/x-mail = message text/x-man = document application/x-chm = document @@ -191,6 +193,7 @@ text = \ text/x-c++ \ text/x-fictionbook \ text/x-html-sidux-man \ + text/x-html-aptosid-man \ text/x-man \ text/x-python \ text/x-shellscript diff --git a/website/filters/mimemap b/website/filters/mimemap index 0a1b1234..ed3cb633 100644 --- a/website/filters/mimemap +++ b/website/filters/mimemap @@ -128,10 +128,13 @@ recoll_noindex = .tar.gz .tgz .tar.bz2 .tbz .log.gz .md5 .map \ [~/.purple] .txt = text/x-purple-log -# Special handling of sidux manual menu system +# Special handling of sidux/aptosid manual menu system [/usr/share/sidux-manual] .htm = text/x-html-sidux-man .html = text/x-html-sidux-man +[/usr/share/aptosid-manual] +.htm = text/x-html-aptosid-man +.html = text/x-html-aptosid-man # Manual files. You may want to adjust the location for your system # We can't use the default text/troff type because this doesn't say diff --git a/website/filters/mimeview b/website/filters/mimeview index 2a3ee048..873ce204 100644 --- a/website/filters/mimeview +++ b/website/filters/mimeview @@ -4,6 +4,11 @@ # External viewers, launched by the recoll GUI when you click on a result # 'edit' link +# Mime types which we should not uncompress if they are found gzipped or +# bzipped because the native viewer knows how to handle. These would be +# exceptions and the list is normally empty +#nouncompforviewmts = + [view] # Pseudo entry used if the 'use desktop' preference is set in the GUI application/x-all = xdg-open %f @@ -59,5 +64,5 @@ text/html = firefox %u text/plain = gnuclient -q %f text/x-c = gnuclient -q %f text/x-html-sidux-man = konqueror %f -#text/x-html-sidux-man = iceweasel %f +text/x-html-aptosid-man = konqueror %f text/x-python = idle %f diff --git a/website/index.html.en b/website/index.html.en index 127b7d44..116fbb4a 100644 --- a/website/index.html.en +++ b/website/index.html.en @@ -83,16 +83,23 @@
    • 2010-09-23 : Recoll 1.14.2 is out. The main new feature is the use of document dates in - searches, buf there are a few - others too. As usual with a .0 release, there may be - rough edges, the binary packages will follow when a few - brave souls will have tried it and I hear of no major - issues. If you are currently indexing audio file tags, you - need to look at the changes file, the supporting - application changed.
      • + searches, buf there are a few others + too. If you are currently indexing audio file tags, there are + two issues in the release: +
        +
      • The supporting application changed, you'll need to install the + mutagen python module
        • +
      • The distributed filter only works with very recent + mutagen releases. + See here + for a version which works with the older mutagen release + found in some package repositories.
        • +
      + -
    • 2010-04-14 : Recoll 1.13.04 is - out. It fixes a nasty bug (broken stemming) in 1.13.02.
      • +
    • 2010-04-14 : + Recoll 1.13.04 is out. It + fixes a nasty bug (broken stemming) in 1.13.02.
    • 2010-01-29 : the full Recoll source repository is now hosted on diff --git a/website/index.html.fr b/website/index.html.fr index a8665418..ae122738 100644 --- a/website/index.html.fr +++ b/website/index.html.fr @@ -98,11 +98,13 @@
    • 2010-09-18 : Recoll 1.14.2 vient de sortir. L'innovation principale est la possibilité d'utiliser des critères de dates dans les recherches, mais - il y en a quelques autres. Comme - d'habitude, avec une version .0, il se pourrait qu'il y ait - quelques problèmes, les paquets binaires suivront quand - quelques braves auront essayé cette version, et si je - n'entends pas parler de problèmes majeurs.
      • + il y en a quelques autres. Si vous + indexez des tags audio, l'application support a changé, le filtre + utilise maintenant le module Python mutagen, que vous devrez + installer. Par ailleurs, vous pouvez trouver + ici une version du filtre + qui fonctionne avec des versions de mutagen un peu plus anciennes. +
    • 2010-04-14 : la version 1.13.04 vient de sortir. Elle