tris/recoll
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

*** empty log message ***

Browse Source
This commit is contained in:
dockes 2008-12-15 11:20:54 +00:00
parent 452433eb92
commit b0daeaaf9b
13 changed files with 607 additions and 310 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
website/BUGS.html
View File

@ -35,9 +35,17 @@
supposedly fixed in later versions. Bugs listed in the
topmost section may also exist in older versions.</i></p>
<h2>Latest (recoll 1.11.0 + xapian 1.0.x)</h2>
<h2>Latest (recoll 1.11.2 + xapian 1.0.x)</h2>
<ul>
<li>Performing a full index with release 1.11, over a version
created with a much older recoll release may sometimes end
with an error saying "backend doesn't implement metadata".
If this happens, you need to delete the index directory
(typically <em>~/.recoll/xapiandb/</em>) and restart
indexing. For big indexes, removing the directory preventively
may be a smart move to avoid losing time.</li>
<li> When Recoll is built with qt 4.4.0, the icons in the
result list are all displayed at the top of the page and
garbled. This appears to be a qt bug, fixed in 4.4.1. Use
@ -47,6 +55,13 @@
several paragraphs (in the qt textedit sense), right clicks
will only work inside the first one for each entry.
<li>The "Copy file name" and "Copy URL" entries of the
right-click menus only copy the data to the X11 primary
selection (use middle-button click to paste). This is
probably a mistake, the data should be copied to the
clipboard too (permitting the use of the "Paste" edit menu
entry or Ctrl+V in the target).
<li> When a mime type has an external viewer defined, but the
actual file is compressed (ie: xxx.txt.gz), recoll will try
to start the external viewer on the compressed file, which
@ -100,6 +115,18 @@
yet inexistant db).</li>
</ul>
<h2>1.11.1</h2>
<ul>
<li>Unicode space characters like
<em>0x3000,&nbsp;Ideographic&nbsp;space</em>
where not detected inside user entries like the main
interface search entry. Badly parsed searches would retrieve no
results, when the same search entered with ascii space characters
would have succeeded.</li>
<li>Spaces were inserted inside CJK strings when building
abstracts for the result list.</li>
</ul>
<h2>1.10.6</h2>
<ul>
<li> If the locale is not utf-8, non-ascii command line

515
website/BUGS.txt
View File

@ -1,234 +1,339 @@
Known bugs in current and older versions:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Recoll known bugs</title>
Bugs that are listed in an older version section are supposedly fixed in
later versions. Bugs listed in the topmost section may also exist in older
versions.
<meta name="generator" content="HTML Tidy, see www.w3.org">
<meta name="Author" content="Jean-Francois Dockes">
<meta name="Description" content=
"recoll is a simple full-text search system for unix and linux
based on the powerful and mature xapian engine">
<meta name="Keywords" content=
"full text search, desktop search, unix, linux">
<meta http-equiv="Content-language" content="en">
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<meta name="robots" content="All,Index,Follow">
Latest (recoll 1.10.6 + xapian 1.0.x):
<link type="text/css" rel="stylesheet" href="styles/style.css">
</head>
- When Recoll is built with qt 4.4.0, the icons in the result list are all
displayed at the top of the page and garbled. This appears to be a qt
bug, fixed in 4.4.1. Use either qt 4.3.x or 4.4.1
<body>
<div class="rightlinks">
<ul>
<li><a href="index.html">Home</a></li>
<li><a href="download.html">Downloads</a></li>
<li><a href="doc.html">Documentation</a></li>
</ul>
</div>
<div class="content">
- If the locale is not utf-8, non-ascii command line arguments to recoll
and recollq are not converted to utf-8, which may prevent, for example,
the kde applet from working. The workaround is to apply the following
one-line fix to qtgui/main.cpp, recompile and install recoll:
386c386
< sSearch->setSearchString(QString::fromUtf8(qstring.c_str()));
---
> sSearch->setSearchString(QString::fromLocal8Bit(qstring.c_str()));
<h1>Known bugs in current and older versions</h1>
<p><i>Bugs that are listed in an older version section are
supposedly fixed in later versions. Bugs listed in the
topmost section may also exist in older versions.</i></p>
<h2>Latest (recoll 1.11.2 + xapian 1.0.x)</h2>
<ul>
<li>Performing a full index with release 1.11, over a version
created with a much older recoll release may sometimes end
with an error saying "backend doesn't implement metadata".
If this happens, you need to delete the index directory
(typically <em>~/.recoll/xapiandb/</em>) and restart
indexing. For big indexes, removing the directory preventively
may be a smart move to avoid losing time.</li>
<li> When Recoll is built with qt 4.4.0, the icons in the
result list are all displayed at the top of the page and
garbled. This appears to be a qt bug, fixed in 4.4.1. Use
either qt 4.3.x or 4.4.1
<li> If the user-chosen result list entry format results in
several paragraphs (in the qt textedit sense), right clicks
will only work inside the first one for each entry.
<li>The "Copy file name" and "Copy URL" entries of the
right-click menus only copy the data to the X11 primary
selection (use middle-button click to paste). This is
probably a mistake, the data should be copied to the
clipboard too (permitting the use of the "Paste" edit menu
entry or Ctrl+V in the target).
<li> When a mime type has an external viewer defined, but the
actual file is compressed (ie: xxx.txt.gz), recoll will try
to start the external viewer on the compressed file, which
will not work in most cases.
<li> NEAR crashes: 1.6 has added NEAR searches. Unlike what
recoll did with PHRASES, stemming expansion is performed on
terms inside NEAR clauses (except if prevented by a
capitalized entry of course). There is a bug in Xapian (all
versions as far as I know), where NEAR does not support
multiple OR subclauses, as would result from a multiple
expansion. This manifests itself by a 'not implemented'
Xapian exception. Workarounds:
<ul>
<li>Prevent expansion of NEAR terms (possibly except one) by
capitalizing them.
<li>Or apply the following patch to xapian, inside the
"api/" directory:
http://www.recoll.org/xapian/xapNearDistrib-1.0.patch
or fetch the already patched source:
http://www.recoll.org/xapian/xapian-core-1.0.7-recollNEARpatch.tar.gz
then recompile, and install.
</li>
</ul>
I hope that an equivalent fix will make it into xapian at
some point (the current fix is not completely correct but
still handles most useful cases).</li>
<li> If you are seeing a delay of a few seconds before the
result list displays for the first query of a recoll
instance, try changing the result list font in the query
preferences. This is not a recoll problem, I don't know the
exact cause (I've seen it happen with "Sans Serif" and go
away with Helvetica or Arial).
<li> Under some versions of KDE (ie: Fedora FC5 KDE
3.5.4-0.5.fc5), there is a problem with the window stacking
order. Opening the "browse" file selection dialog from the
advanced search dialog will stack the latter under the main
window, possibly making it invisible. This is quite probably
a Kwin bug, possibly related to
http://bugs.kde.org/show_bug.cgi?id=79183 or a correction
thereof.
<li> Under Solaris, it is necessary to perform initial indexing with the
recollindex program (the recoll index thread doesn't work for creating
the database). Don't know the reason. Only idea I have is problem with
exception handling (recoll catches an exception while trying the
yet inexistant db).</li>
</ul>
<h2>1.11.1</h2>
<ul>
<li>Unicode space characters like
<em>0x3000,&nbsp;Ideographic&nbsp;space</em>
where not detected inside user entries like the main
interface search entry. Badly parsed searches would retrieve no
results, when the same search entered with ascii space characters
would have succeeded.</li>
<li>Spaces were inserted inside CJK strings when building
abstracts for the result list.</li>
</ul>
<h2>1.10.6</h2>
<ul>
<li> If the locale is not utf-8, non-ascii command line
arguments to recoll and recollq are not converted to utf-8,
which may prevent, for example, the kde applet from
working. The workaround is to apply the following one-line
fix to qtgui/main.cpp, recompile and install recoll:
<pre>
386c386
&lt; sSearch->setSearchString(QString::fromUtf8(qstring.c_str()));
---
&gt; sSearch->setSearchString(QString::fromLocal8Bit(qstring.c_str()));
</pre>
</li>
</ul>
<h2>1.10.1</h2>
<ul>
<li> A relatively simple error case can cause the indexer to
stop processing an mbox file (forgetting all subsequent
messages). More specifically, this happens when encountering
more than than a few dozen errors while handling
attachments. This is relatively common: for exemple if an
external helper application is missing and multiple
attachments of the affected type are found (ie: multiple
images and no exiftool). Workaround: install the helper
application.
<li> The decoding of base-64 data in emails fails in a relatively uncommon
but sometimes encountered case.
<li> In a preview window, when walking the search term hits with the
Previous/Next buttons, 'Previous' actually acts as 'Next' (it does work
normally for the local search).
<li> Problems in detecting message separators inside Thunderbird mailboxes
(quite probably mainly for messages imported from outlook?). Can lead to
unindexed messages, and even apparently indexer crashes in some cases.
<li> File names indexed as terms can sometimes overflow the maximum term
size, halting the indexing.
<li> For Phrase/Near searches, only the first term group is highlighted in
preview.
</ul>
<h2>1.10.0</h2>
<ul>
<li> If a filter fails while trying to extract the data from a file, the file
will not be indexed at all (not even the file name). The file
name should be indexed in this case. This happens in particular in the
very common case where the helper application is not installed (ie:
missing Exiftool -> no *.jpg names in the index).
<li> If several query language "ext:" qualifiers are specified, they will be
joined by an AND instead of OR, resulting in no results. Using an
explicit OR doesn't work (actually OR + field names is generally
broken). In some cases, you can use a "type:" qualifier as a workaround.
- If the user-chosen result list entry format results in several paragraphs
(in the qt textedit sense), right clicks will only work inside the first
one for each entry.
</ul>
<h2>1.9.x</h2>
<ul>
<li> Problems have been reported indexing big mailstores (several hundreds of
thousands of messages): resulting in a very big database and even
crashes.
- When a mime type has an external viewer defined, but the actual file is
compressed (ie: xxx.txt.gz), recoll will try to start the external viewer
on the compressed file, which will not work in most cases.
</ul>
<h2>1.8.2</h2>
<ul>
<li> Under ubuntu (at least, maybe debian too), the default awk interpreter
(mawk) is ancient, and the recoll pdf input filter does not
work (removes all space characters). This can be solved by installing the
gawk package.
$ apt-get install gawk
$ update-alternatives --set awk /usr/bin/gawk
- NEAR crashes: 1.6 has added NEAR searches. Unlike what recoll did
with PHRASES, stemming expansion is performed on terms inside NEAR
clauses (except if prevented by a capitalized entry of course). There is
a bug in Xapian (all versions as far as I know), where NEAR does not support
multiple OR subclauses, as would result from a multiple expansion. This
manifests itself by a 'not implemented' Xapian exception. Workarounds:
<li> There are sometimes problems with document deletions: the index can
get in a state where deleted or moved documents are not purged from the
index (the log file says that the doc are deleted, but they aren't
actually). When this happens, the only solution currently is to reindex
from scratch (recollindex -z). This is due to a xapian bug, which is
fixed in xapian 1.0.2, or you can apply the following patch to xapian
1.0.1 to fix it:
http://www.lesbonscomptes.com/recoll/xapian/xapian-delete-document.patch
- Prevent expansion of NEAR terms (possibly except one) by
capitalizing them.
<li> The dates shown for email attachments in a result list are the email
folder modification date. This should be inherited from the parent
message instead.
- Or apply the following patch to xapian, inside the
"api/" directory:
http://www.recoll.org/xapian/xapNearDistrib-1.0.patch
or fetch the already patched source:
http://www.recoll.org/xapian/xapian-core-1.0.7-recollNEARpatch.tar.gz
<li> There are a few problems in the qt4 version of recoll:
<li> Some accelerators (esc-spc, ctl-arrow) do not work, neither do
copy/paste between the result list and preview windows and x11
applications.
<li> The qt4 q3textedit::find() method is extremely slow, so that
positionning to first search term in Recoll preview has been disabled,
and the application will sometimes appear to be looping when using the
find feature in the preview window (it's not looping, it's searching...)
then recompile, and install.
I hope that an equivalent fix will make it into xapian at some point (the
current fix is not completely correct but still handles most useful cases).
- If you are seeing a delay of a few seconds before the result list
displays for the first query of a recoll instance, try changing the
result list font in the query preferences. This is not a recoll problem,
I don't know the exact cause (I've seen it happen with "Sans Serif" and
go away with Helvetica or Arial).
- Under some versions of KDE (ie: Fedora FC5 KDE 3.5.4-0.5.fc5), there is a
problem with the window stacking order. Opening the "browse" file
selection dialog from the advanced search dialog will stack the latter
under the main window, possibly making it invisible. This is quite
probably a Kwin bug, possibly related to
http://bugs.kde.org/show_bug.cgi?id=79183 or a correction thereof.
- Under Solaris, it is necessary to perform initial indexing with the
recollindex program (the recoll index thread doesn't work for creating
the database). Don't know the reason. Only idea I have is problem with
exception handling (recoll catches an exception while trying the
yet inexistant db).
1.10.1 + xapian 1.0.x
- A relatively simple error case can cause the indexer to stop processing
an mbox file (forgetting all subsequent messages). More specifically,
this happens when encountering more than than a few dozen errors while
handling attachments. This is relatively common: for exemple if an
external helper application is missing and multiple attachments of the
affected type are found (ie: multiple images and no
exiftool). Workaround: install the helper application.
- The decoding of base-64 data in emails fails in a relatively uncommon
but sometimes encountered case.
- In a preview window, when walking the search term hits with the
Previous/Next buttons, 'Previous' actually acts as 'Next' (it does work
normally for the local search).
- Problems in detecting message separators inside Thunderbird mailboxes
(quite probably mainly for messages imported from outlook?). Can lead to
unindexed messages, and even apparently indexer crashes in some cases.
- File names indexed as terms can sometimes overflow the maximum term
size, halting the indexing.
- For Phrase/Near searches, only the first term group is highlighted in
preview.
</ul>
<h2>1.8.1</h2>
<ul>
<li> This is not really a bug but .beagle really should be included in
"skippedNames", or you end up indexing the beagle text cache, which is
not really desirable.
<li> Doc bug: the manual states that the query language supports a "mime:"
switch to filter mime types. There is currently no such thing.
1.10.0
</ul>
<h2>1.7.5</h2>
<ul>
<li> Debian and Ubuntu: the rclsoff Openoffice filter doesn't work,
because of an incorrect shell syntax (understood by bash but not sh). To
fix, you edit /usr[/local]/share/recoll/filters/rclsoff and can change
the line:
trap cleanup EXIT SIGHUP SIGQUIT SIGINT SIGTERM
into:
trap cleanup EXIT HUP QUIT INT TERM
or download the updated filter from the filters page:
http://www.recoll.org/filters/filters.html
- If a filter fails while trying to extract the data from a file, the file
will not be indexed at all (not even the file name). The file
name should be indexed in this case. This happens in particular in the
very common case where the helper application is not installed (ie:
missing Exiftool -> no *.jpg names in the index).
</ul>
<h2>1.7.3</h2>
<ul>
<li> Processing will stop on first error while indexing an mbox file. This
could happen just because an attachment could not be decoded, and can
cause non-indexing of many messages. The most probable cause of error is
a missing filter (ie for ms-word files), so the temporary workaround
would be to install the missing filters. This bug is specific to 1.7 and
1.6 users need not worry. A correction will be issued very soon.
<li> Messages of type multipart/signed are not indexed.
- If several query language "ext:" qualifiers are specified, they will be
joined by an AND instead of OR, resulting in no results. Using an
explicit OR doesn't work (actually OR + field names is generally
broken). In some cases, you can use a "type:" qualifier as a workaround.
</ul>
<h2>1.6.2</h2>
<ul>
<li> Relatively unfrequent issue with message boundary detection in mbox
files, could cause miscellaneous problems.
<li> Executing an external viewer for a file with single-quotes in the name
would not work.
</ul>
<h2>1.5.10</h2>
<ul>
<li> If a defaultcharset was set in the configuration file for a subdirectory,
it would stay in effect for all subsequent files/directories (except if
explicitely overridden), potentially causing many transcoding errors.
1.9.x
- Problems have been reported indexing big mailstores (several hundreds of
thousands of messages): resulting in a very big database and even
crashes.
</ul>
<h2>1.5.[1-7]</h2>
<ul>
<li> Dates in result list come from the file's ctimes, which may be confusing
<li> Some rare MIME messages with null boundaries can crash the indexer.
</ul>
<h2>1.5.0</h2>
<ul>
<li> Under some conditions, recoll startup and exit could be very slow: the
simple search history list had serious problems with non-ascii strings,
whose size sometimes doubled at each program startup/stop.
1.8.2
- Under ubuntu (at least, maybe debian too), the default awk interpreter
(mawk) is ancient, and the recoll pdf input filter does not
work (removes all space characters). This can be solved by installing the
gawk package.
$ apt-get install gawk
$ update-alternatives --set awk /usr/bin/gawk
</ul>
<h2>1.3.3</h2>
<ul>
- There are sometimes problems with document deletions: the index can
get in a state where deleted or moved documents are not purged from the
index (the log file says that the doc are deleted, but they aren't
actually). When this happens, the only solution currently is to reindex
from scratch (recollindex -z). This is due to a xapian bug, which is
fixed in xapian 1.0.2, or you can apply the following patch to xapian
1.0.1 to fix it:
http://www.lesbonscomptes.com/recoll/xapian/xapian-delete-document.patch
<li> Several of the external filters did not handle path names with embedded
spaces (rcluncomp rclsoff rclps rclmedia rcldjvu). This is fixed in 1.4.
- The dates shown for email attachments in a result list are the email
folder modification date. This should be inherited from the parent
message instead.
<li> If your QT installation is built with the QT_NO_STL flag, Recoll will not
compile. I have a patch for this (will be fixed in the next release),
contact me if you get the problem. Typical error message:
main.cpp:160: error: no match for 'operator+=' in 'msg += reason'
- There are a few problems in the qt4 version of recoll:
- Some accelerators (esc-spc, ctl-arrow) do not work, neither do
copy/paste between the result list and preview windows and x11
applications.
- The qt4 q3textedit::find() method is extremely slow, so that
positionning to first search term in Recoll preview has been disabled,
and the application will sometimes appear to be looping when using the
find feature in the preview window (it's not looping, it's searching...)
<li> The 'None of these words' field in the complex search does not work if
there are no other filled fields (it transforms into an ordinary
search). Workaround: enter very common term(s) in the 'any of these
words' field.
1.8.1
- This is not really a bug but .beagle really should be included in
"skippedNames", or you end up indexing the beagle text cache, which is
not really desirable.
- Doc bug: the manual states that the query language supports a "mime:"
switch to filter mime types. There is currently no such thing.
<li> Indexing cannot currently be conveniently and cleanly
stopped when it's started. You can kill the process, and
keyboard interrupt might work, but this may leave the
database in a bad state. This is fixed in the upcoming
release, there is no current workaround.
</ul>
***************************************************************************
1.7.5
- Debian and Ubuntu: the rclsoff Openoffice filter doesn't work,
because of an incorrect shell syntax (understood by bash but not sh). To
fix, you edit /usr[/local]/share/recoll/filters/rclsoff and can change
the line:
trap cleanup EXIT SIGHUP SIGQUIT SIGINT SIGTERM
into:
trap cleanup EXIT HUP QUIT INT TERM
or download the updated filter from the filters page:
http://www.recoll.org/filters/filters.html
<h2>1.2.2</h2>
<ul>
<li> The preview window is supposed to scroll after loading the document so
that the first search term is visible. This does not work in many cases.
<li> The result list title is not shown for sorted lists
1.7.3
- Processing will stop on first error while indexing an mbox file. This
could happen just because an attachment could not be decoded, and can
cause non-indexing of many messages. The most probable cause of error is
a missing filter (ie for ms-word files), so the temporary workaround
would be to install the missing filters. This bug is specific to 1.7 and
1.6 users need not worry. A correction will be issued very soon.
- Messages of type multipart/signed are not indexed.
Notes on older versions:
<li> Trouble compiling on some linux systems (Gentoo and Slackware?). There
existed a quite common issue where the Recoll link will fail trying to
use a libstdc++.la file. This was due to a problem with the xapian-config
program. A workaround has been included in the configure script for
recoll 1.2.2, and the problem should not occur any more.
1.6.2
- Relatively unfrequent issue with message boundary detection in mbox
files, could cause miscellaneous problems.
- Executing an external viewer for a file with single-quotes in the name
would not work.
1.5.10
- If a defaultcharset was set in the configuration file for a subdirectory,
it would stay in effect for all subsequent files/directories (except if
explicitely overridden), potentially causing many transcoding errors.
1.5.[1-7]
- Dates in result list come from the file's ctimes, which may be confusing
- Some rare MIME messages with null boundaries can crash the indexer.
1.5.0
- Under some conditions, recoll startup and exit could be very slow: the
simple search history list had serious problems with non-ascii strings,
whose size sometimes doubled at each program startup/stop.
1.3.3
- Several of the external filters did not handle path names with embedded
spaces (rcluncomp rclsoff rclps rclmedia rcldjvu). This is fixed in 1.4.
- If your QT installation is built with the QT_NO_STL flag, Recoll will not
compile. I have a patch for this (will be fixed in the next release),
contact me if you get the problem. Typical error message:
main.cpp:160: error: no match for 'operator+=' in 'msg += reason'
- The 'None of these words' field in the complex search does not work if
there are no other filled fields (it transforms into an ordinary
search). Workaround: enter very common term(s) in the 'any of these
words' field.
- Indexing cannot currently be conveniently and cleanly stopped when it's
started. You can kill the process, and keyboard interrupt might work, but
this may leave the database in a bad state. This is fixed in the upcoming
release, there is no current workaround.
1.2.2
- The preview window is supposed to scroll after loading the document so
that the first search term is visible. This does not work in many cases.
- The result list title is not shown for sorted lists
Notes on older versions:
- Trouble compiling on some linux systems (Gentoo and Slackware?). There
existed a quite common issue where the Recoll link will fail trying to
use a libstdc++.la file. This was due to a problem with the xapian-config
program. A workaround has been included in the configure script for
recoll 1.2.2, and the problem should not occur any more.
- Case-insensitive search should now work in most cases (used to not work
except for accented ascii).
- All directories and files with names beginning with a dot were ignored
by the skippedNames directive in the default recoll.conf file from
older versions (no indexation of mozilla or thunderbird email !). An
upgrade will not fix this (it will not modify an existing
configuration). You need to edit recoll.conf by hand and remove the .*
from skippedNames.
<li> Case-insensitive search should now work in most cases
(used to not work except for accented ascii).
<li> All directories and files with names beginning with a dot were ignored
by the skippedNames directive in the default recoll.conf file from
older versions (no indexation of mozilla or thunderbird email !). An
upgrade will not fix this (it will not modify an existing
configuration). You need to edit recoll.conf by hand and remove the .*
from skippedNames.</li>
</ul>
</div>
</body>
</html>

15
website/CHANGES.html
View File

@ -31,6 +31,18 @@
<h1>Recoll journal of user-visible changes </h1>
<h2><a name="1.11.0">1.11.2</a></h2>
<ul>
<li>Bugs fixed: process non-ascii space characters inside
user entries. Don't insert spaces in CJK result list abstracts.</li>
<li>The right-click menu "Copy" commands inside the result list
now copy to the clipboard in addition to the main selection,
enabling subsequent ^v commands.</li>
</ul>
<h2><a name="1.11.0">1.11.0</a></h2>
<p><i>Recoll release 1.11 has relatively extensive changes that have
@ -60,7 +72,8 @@
Recoll scripts. Avoided wasteful repeated execution of filters for
which the helper application is missing.</li>
<li>Query language now closer to Xesam specification, (but still far from a
<li>Query language now closer to Xesam specification, (but
still far from a
complete implementation). See the Recoll manual and
<a href="http://www.xesam.org/main/XesamUserSearchLanguage">
http://www.xesam.org/main/XesamUserSearchLanguage</a> </li>

2
website/copydocs
View File

@ -9,7 +9,7 @@ test -d usermanual || mkdir usermanual || exit 1
cd usermanual
thisdir=`pwd`
(cd $docdir; find . -name '*.html' -print | cpio -vp $thisdir)
(cd $docdir; find . -name '*.html' -print | cpio -vudp $thisdir)
cp $docdir/docbook.css .
# The freebsd tool chain generates a link to book.html in the index. Too
# lazy to check if this can be changed

173
website/download.html
View File

@ -53,9 +53,10 @@
<p>Instructions: <a href="usermanual/rcl.install.html">
Installation / building manual</a>.</p>
<p>All binary packages on this page need a Qt 3.3 runtime
environment. They are statically linked with
Xapian, which you don't need to install.</p>
<p>Most binary packages on this page need a Qt 3.3 runtime
environment (QT 4.x is specified for a few). They are
statically linked with Xapian, which you don't need to
install separately.</p>
<p>Optional packages used by document filters:
<a href="usermanual/usermanual.html#RCL.INSTALL.EXTERNAL">
@ -71,11 +72,6 @@
<a href="mailto:jean-francois.dockes@wanadoo.fr">
report them</a>.</p>
<p>Recoll users updating from 1.8 or older,
or who have skipped this step for 1.9 need to delete their old index.
<a href="xapUpg100.html">More details</a>.
<em>You don't need to do this if you did it for Recoll 1.9</em></p>
<h3>What do the release numbers mean?</h3>
<p>The Recoll releases are numbered X.Y.Z. The X
@ -86,12 +82,13 @@
if you don't need the new features,
you may want to wait a little, and especially skip the first
release (X.Y.0), at least for a few weeks.</p>
<p>Z changes for bug fixes only, and moving from X.Y.Z to X.Y.Z+u
should in general involve little risk of regression. But,
<em>any</em> change can bring problems, if you are not
affected by the corrected bugs (check the <a
href="CHANGES.html">changes file</a>), there is probably no
necessity to upgrade anyway.</p>
<p>Z changes for <a href="BUGS/html">bug fixes</a> only,
and moving from X.Y.Z to X.Y.Z+u should in general involve
little risk of regression. But, <em>any</em> change can bring
problems, if you are not affected by the corrected bugs (check
the <a href="CHANGES.html">changes file</a>), there is
probably no necessity to upgrade anyway.</p>
<h2><a name="filters">Updated filters</a></h2>
@ -103,39 +100,46 @@
<h2><a name="source">Source</a></h2>
<p><b>Current version:</b>
1.10.6: <a href="recoll-1.10.6.tar.gz">recoll-1.10.6.tar.gz</a>
See the <a href="BUGS.html">known bugs and issues</a> and
<a href="CHANGES.html">changes</a>.</p>
<p><b>Current version:</b>1.11.2:
<a href="recoll-1.11.2.tar.gz">recoll-1.11.2.tar.gz</a>.
<a href="CHANGES.html">Changes</a>. <a href="BUGS.html">Bugs</a>.
<br>
Version 1.11 has relatively <a href="CHANGES.html">extensive
changes</a> (<a href="pics/recoll0.png">pic</a>), and needs an
index reset after installing over an 1.10 or older
version. For an existing installation you can use option -z to
the command line indexer: <tt>recollindex&nbsp;-z</tt>, or
just delete the old index directory
(ie: <tt>rm&nbsp;-rf&nbsp;~/.recoll/xapiandb/</tt>). The
latter option may be safer with old indexes. If the first
1.11 indexing ends with an error like <em>backend doesn't
implement metadata</em>, you certainly need to do it.</p>
<p>The download page for Recoll 1.10 is
still <a href="download-1.10.html">still available</a>.</p>
<p>In order to build Recoll from source, you will need a
xapian-core installation. You will find
source and binary packages on the
<a href="http://www.xapian.org/download.php">Xapian download
page</a>. Recoll should build with any 0.9.x or 1.0.x
Xapian version. 1.0.x is preferred.</p>
<p>You can build with Qt 3.3 or Qt 4. Recoll will
automatically be configured to build with Qt 4 if the version
of qmake found in $QTDIR/bin:$PATH is for Qt 4 (or if $QMAKE
is set to such a version).</p>
<p>There seems to be a few problems in Qt 4.4.0 (2008-08-23),
resulting in problems in displaying the Recoll result list. I
suggest avoiding this release. Qt 4.3.x and
4.4.1 work fine.</p>
<p><b>Recoll 1.11.0 is out</b>. This version has relatively
<a href="CHANGES.html">extensive changes</a>
(<a href="pics/recoll0.png"> pic</a>): , and needs a full
indexation after installation. I hope that some brave souls
will be willing to help with shaking the last initial
bugs: <a href="recoll-1.11.0.tar.gz">
recoll-1.11.0.tar.gz</a>. </p>
xapian-core installation. You will find source and binary
packages on the <a href="http://www.xapian.org/download.php">
Xapian download page</a>.
Recoll 1.11 needs at least xapian 1.0.5, and I can see no
reason not to use the latest 1.0 Xapian (1.0.9 currently).</p>
<table>
<tr><td valign="top">Qt:</td>
<td>
You can build with Qt 3.3 or Qt 4. Recoll will
automatically be configured to build with Qt 4 if the version
of qmake found in $QTDIR/bin:$PATH is for Qt 4.</td></tr>
<tr><td></td><td>
There seems to be a few issues in Qt 4.4.0 (2008-08-23),
resulting in problems when displaying the Recoll result list. I
suggest avoiding this release. Qt 4.3.x and
4.4.1 work fine.</td></tr>
</table>
<p>Older recoll releases:
<a href="recoll-1.10.5.tar.gz">1.10.5</a>.
<a href="recoll-1.10.0.tar.gz">1.10.0</a>.
<a href="recoll-1.10.6.tar.gz">1.10.6</a>.
<a href="recoll-1.9.0.tar.gz">1.9.0</a>.
<a href="older/recoll-1.8.2.tar.gz">1.8.2</a>.
<a href="older/recoll-1.7.6.tar.gz">1.7.6</a>.
@ -158,7 +162,8 @@
<h2><a name="rpms">Packages</a></h2>
<p>The executables inside the binary rpms have a static link to
xapian 1.0.[4-8], there is no real dependency except Qt 3.3.
xapian 1.0.[4-9], there is no real dependency except Qt 3.3
(or Qt 4.1 when mentioned).
The Fedora and Mandriva packages unfortunately think that they
depend on exiftool (which is needed by the little
used jpeg info filter), due to excessive rpmbuild
@ -169,42 +174,48 @@
<p><b>Fedora Core</b>
FC6 RPM:
<a href="fc6/recoll-1.10.6-1.i386.rpm">
fc6/recoll-1.10.6-1.i386.rpm</a>.
<a href="fc6/recoll-1.11.0-1.i386.rpm">
recoll-1.11.0-1.i386.rpm</a>.
Source:
<a href="fc6/recoll-1.10.6-1.src.rpm">
recoll-1.10.6-1.src.rpm</a>
<a href="fc6/recoll-1.11.0-1.src.rpm">
recoll-1.11.0-1.src.rpm</a>
This package also installs and runs on Fedora 9.
</p>
<p><b>Mandriva 2006</b> (also works on 2005 and 2007).
RPM:
<a href="mandriva2006/recoll-1.10.6-0.1.20060mdk.i586.rpm">
recoll-1.10.6-0.1.20060mdk.i586.rpm</a>.
<a href="mandriva2006/recoll-1.11.0-0.1.20060mdk.i586.rpm">
recoll-1.11.0-0.1.20060mdk.i586.rpm</a>.
Source:
<a href="mandriva2006/recoll-1.10.6-0.1.20060mdk.src.rpm">
recoll-1.10.6-0.1.20060mdk.src.rpm</a>
<a href="mandriva2006/recoll-1.11.0-0.1.20060mdk.src.rpm">
recoll-1.11.0-0.1.20060mdk.src.rpm</a>
</p>
<p><b>Suse 10.3</b>
<p><b>Suse 10.3 / 11.0</b>
RPM:
<a href="suse10.3/recoll-1.10.6-0.i586.rpm">
recoll-1.10.6-0.i586.rpm</a>.
<a href="suse10.3/recoll-1.11.0-0.i586.rpm">
recoll-1.11.0-0.i586.rpm</a>.
Source:
<a href="suse10.3/recoll-1.10.6-0.src.rpm">
recoll-1.10.6-0.src.rpm</a>
<a href="suse10.3/recoll-1.11.0-0.src.rpm">
recoll-1.11.0-0.src.rpm</a><br>
If you build from source on OpenSuse 11, note that the default
qt4 version is 4.4.0 which will badly display the result list
icons. Use qt3 or install a newer version of qt4.
</p>
<p><b>Ubuntu 6.06 dapper / edgy / gutsy / hardy</b>
<a href="debian/dapper/recoll_1.10.6-0ubuntu1_i386.deb">
recoll_1.10.6-0ubuntu1_i386.deb</a>
<a href="debian/dapper/recoll_1.11.0-0ubuntu1_i386.deb">
recoll_1.11.0-0ubuntu1_i386.deb</a>
<a href="debian/dapper/">debian/dapper</a>. This package was
built on "dapper" and appears to work correctly on later
Ubuntu releases. This package is not configured for real-time
indexing. Here is a package for Ubuntu 8.04 Hardy which
is:
<a href="debian/hardy/recoll_1.10.6-0ubuntu1_i386.deb">
recoll_1.10.6-0ubuntu1_i386.deb</a>
indexing.</p>
<p>Here is a package for Ubuntu 8.04 Hardy which supports
real-time indexing. It is also built for qt4, so this must be
installed on the target system. Avoid qt 4.4.0 (from hardy
backports). The standard 4.3.x is fine (or 4.4.1 and later)
<a href="debian/hardy/recoll_1.11.1-0ubuntu1_i386.deb">
recoll_1.11.1-0ubuntu1_i386.deb</a>
</p>
<p><b>Debian unstable</b> Recoll is in the package repository,
@ -215,7 +226,7 @@
<h2><a name="otherbinary">Binary bundles</a></h2>
<p>These are just prebuilt trees (without the source files).
The executables were built with xapian 1.0.5 (patched for the
The executables were built with xapian 1.0.8 (patched for the
NEAR bug) and libiconv 1.9.2 (where relevant) as static
libraries. They depend on Qt 3.3. For Solaris, you should be
able to find a Qt package
@ -224,31 +235,30 @@
<p>The installation instructions are <a
href="usermanual/rcl.install.binary.html"> there</a>.</p>
<p><span class="application">FreeBSD</span> 6.3 i386:
<a href="freebsd/recoll-1.10.6-FreeBSD-6.3-STABLE.tgz">
recoll-1.10.6-FreeBSD-6.3-STABLE.tgz</a>
<p><span class="application">FreeBSD</span> 6.4 i386:
<a href="freebsd/recoll-1.11.0-FreeBSD-6.4-PRERELEASE.tgz">
recoll-1.11.0-FreeBSD-6.4-PRERELEASE.tgz</a>
</p>
<p><span class="application">Solaris 8</span> sparc.
Note to Solaris users: you need to perform the initial
indexing pass with "recollindex", not the recoll GUI indexing
thread. See <a href="BUGS.html">errata</a>.
<a href="sunos/recoll-1.10.6-SunOS-5.8.tgz">
recoll-1.10.6-SunOS-5.8.tgz</a>.
<a href="sunos/recoll-1.11.0-SunOS-5.8.tgz">
recoll-1.11.0-SunOS-5.8.tgz</a>.
<p>Recoll also builds and runs on Solaris 10, but, given the
situation of open source packages for Solaris (very old Qt on
the Companion CD, inconsistent versions of the compiler and
non-threaded version of Qt on sunfreeware), I've come to the
temporary conclusion that you are better off building than
trying to install packages. The approach I recently tried and
which worked was to:
trying to install packages. The approach I tried a couple of
months ago and which worked was to:
<ul>
<li>Install gcc 3.4.6 and gnu make from the sunfreeware
packages (go to /usr/local). I guess that the gcc in
/usr/sfw should be ok too here.</li>
<li>Compile xapian-core and install it (with prefix
/usr/local).</li>
<li>Compile xapian-core and install it (with prefix /usr/local).</li>
<li>Configure and install Qt. The following config worked for me,
with Qt 3.3.8:
<pre>
@ -262,8 +272,8 @@
QMAKESPEC=/usr/local/Trolltech/Qt-3.3.8/mkspecs/solaris-g++
and add $QTDIR/bin to the PATH then configure, make and
install Recoll</li>
<li>Don't forget to use recollindex for the first index
build, recoll does not work for this (exception handling
<li>Don't forget to use <tt>recollindex</tt> for the first index
build, <tt>recoll</tt> does not work for this (exception handling
mystery probably).</li>
</ul>
</p>
@ -276,8 +286,7 @@
<p>There are ports for both xapian-core
and recoll in the standard tree, you may just need to update
your ports (cvsup, portsnap), or you can get the ports from
the FreeBSD site. The ports are not updated for the xapian
NEAR problem though.
the FreeBSD site.
<a href="http://cvsweb.freebsd.org/ports/databases/xapian-core">
xapian port</a>
<a href="http://cvsweb.freebsd.org/ports/deskutils/recoll">
@ -285,7 +294,7 @@
<h2><a name="translations">Translations</a></h2>
<p>Some of the translations for 1.10 are incomplete. The source
<p>Most of the translations for 1.11 are incomplete. The source
translation files are included in the source release. If your
language has some english messages left and you want to take a
shot at fixing the problem, you can send the results to
@ -301,11 +310,13 @@
</p>
<p><a href="translations/recoll_xx.ts">recoll_xx.ts</a> is a blank
Recoll 1.10 message file, handy to work on a new translation.</p>
Recoll 1.11 message file, handy to work on a new translation.</p>
<h3>Updated 1.10 translations that became available after the
<h3>Updated 1.11 translations that became available after the
release:</h3>
<p>None for now :(</p>
<!--
<p>German.
<a href="translations/recoll_de.ts">recoll_de.ts</a>
<a href="translations/recoll_de.qm">recoll_de.qm</a>
@ -318,7 +329,6 @@
<a href="translations/recoll_ru.ts">recoll_ru.ts</a>
<a href="translations/recoll_ru.qm">recoll_ru.qm</a>
</p>
<!--
<p><b>Italian</b>. Thanks to Mario, Christian and Giovanni for this.
<a href="translations/recoll_it.ts">recoll_it.ts</a>
<a href="translations/recoll_it.qm">recoll_it.qm</a>
@ -327,7 +337,6 @@
<a href="translations/recoll_tr.ts">recoll_tr.ts</a>
<a href="translations/recoll_tr.qm">recoll_tr.qm</a>
</p>
-->
</div>

26
website/howtos/buildindex.sh Normal file
View File

@ -0,0 +1,26 @@
#!/bin/sh
# Build howto index page from howto subdirs
fatal()
{
echo $*;exit 1
}
#set -x
test -f fraghead.html || \
fatal repertoire courant pas un repertoire de construction
cat fraghead.html > index.html
subdirs=`ls -F | grep /`
for dir in $subdirs
do
echo processing $dir
title=`grep '<h1>' $dir/index.html | sed -e 's/<h1>//' -e 's!</h1>!!'`
test "$title" = "" && fatal No title line in $dir/index.html
# Add title/label to list of articles
echo "<li><a href=\"${dir}index.html\">$title</a></li>" >> index.html
done
cat fragend.html >> index.html

5
website/howtos/fragend.html Normal file
View File

@ -0,0 +1,5 @@
</ul>
</div>
</body>
</html>

40
website/howtos/fraghead.html Normal file
View File

@ -0,0 +1,40 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Recoll howtos</title>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<meta name="Author" content="Jean-Francois Dockes">
<meta name="Description" content=
"recoll is a simple full-text search system for unix and linux
based on the powerful and mature xapian engine">
<meta name="Keywords" content=
"full text search, desktop search, unix, linux">
<meta http-equiv="Content-language" content="en">
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<meta name="robots" content="All,Index,Follow">
<link type="text/css" rel="stylesheet" href="../styles/style.css">
</head>
<body>
<div class="rightlinks">
<ul>
<li><a href="../../index.html">Home</a></li>
<li><a href="../../doc.html">Documentation</a></li>
<li><a href="../../download.html">Downloads</a></li>
</ul>
</div>
<div class="content">
<h1>Recoll howtos</h1>
<p>The following short documents contain information
mostly extracted from the main user manual (possibly out of
separate sections), arranged differently in order to explain
how to achieve a given goal.</p>
<ul>

22
website/howtos/newdir.sh Normal file
View File

@ -0,0 +1,22 @@
#!/bin/sh
fatal()
{
echo $*; exit 1
}
usage()
{
fatal 'Usage: newdir nom'
}
test $# -gt 1 || usage
dir=`echo $* | sed -e 's/ /_/g' -e 's!/!_!g'`
echo dir: $dir
mkdir $dir || fatal mkdir failed
cp -i template.html $dir/index.html
open -a emacs $dir/index.html

38
website/howtos/template.html Normal file
View File

@ -0,0 +1,38 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Recoll howtos</title>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<meta name="Author" content="Jean-Francois Dockes">
<meta name="Description" content=
"recoll is a simple full-text search system for unix and linux
based on the powerful and mature xapian engine">
<meta name="Keywords" content=
"full text search, desktop search, unix, linux">
<meta http-equiv="Content-language" content="en">
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<meta name="robots" content="All,Index,Follow">
<link type="text/css" rel="stylesheet" href="../../styles/style.css">
</head>
<body>
<div class="rightlinks">
<ul>
<li><a href="../../index.html">Home</a></li>
<li><a href="../../doc.html">Documentation</a></li>
<li><a href="../index.html">Howtos</a></li>
</ul>
</div>
<div class="content">
<h1>Howto do something</h1>
</div>
</body>
</html>

5
website/index.html.en
View File

@ -47,7 +47,7 @@
<p><span class="application">Recoll</span> is free, open source,
and licensed under the GPL. The current version is
<a class="important" href="download.html">1.10.6</a>
<a class="important" href="download.html">1.11.2</a>
(<a href="CHANGES.txt">Changes</a>).</p>
<h2>Features: </h2>
@ -80,8 +80,7 @@
<h2>News: </h2>
<ul>
<li>2008-10-14 : <a href="download.html#source">1.11.0</a> is
out. You may want to give it a try if you are not afraid of
initial bugs.</li>
out.</li>
<li>2008-09-01 : <a href="filters/filters.html">A new
filter</a> for Office Open XML formats (docx ...).</li>
<li>2008-05-22 : we now have a mailing list:

9
website/index.html.fr
View File

@ -48,7 +48,7 @@
<p><span class="application">Recoll</span> est un logiciel libre
gratuit, dont le code source est disponible sous licence GPL.
La dernière version est
<a class="important" href="download.html">1.10.6</a></p>
<a class="important" href="download.html">1.11.2</a></p>
<p>L'interface utilisateur de
<span class="application">Recoll</span> est traduite en
@ -93,11 +93,12 @@
<h2>Nouvelles: </h2>
<ul>
<li>2008-10-14 : la version <a
href="download.html#source">1.11.0</a> vient de sortir.
Essayez la si vous n'avez pas peur des problèmes de jeunesse!</li>
<li>2008-10-14 : la version
<a href="download.html#source">1.11.0</a> vient de sortir.</li>
<li>2008-09-01 : <a href="filters/filters.html">Un nouveau
filtre</a> pour les formats Office Open XML (docx ...).</li>
<li>2008-05-27 Recoll 1.10.2 est sorti.</li>
</ul>

38
website/pics/index.html
View File

@ -1,18 +1,30 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Photos</title>
<title>Recoll Screenshots</title>
<link type="text/css" rel="stylesheet" href="../styles/style.css">
</head>
<body>
<table>
<tr>
<td align="center"><a href="recoll0.html"><img src="recoll0-thumb.png"></a></td>
<td align="center"><a href="recoll1.html"><img src="recoll1-thumb.png"></a></td>
<td align="center"><a href="recoll2.html"><img src="recoll2-thumb.png"></a></td>
<td align="center"><a href="recoll3.html"><img src="recoll3-thumb.png"></a></td>
</tr>
<tr>
<td align="center"><a href="recoll4.html"><img src="recoll4-thumb.png"></a></td>
<td align="center"><a href="recoll5.html"><img src="recoll5-thumb.png"></a></td>
<td align="center"><a href="recoll_chinese.html"><img src="recoll_chinese-thumb.png"></a></td>
</tr></table></body></html>
<body>
<div class="rightlinks">
<ul>
<li><a href="../index.html">Home</a></li>
<li><a href="../download.html">Downloads</a></li>
<li><a href="../usermanual/index.html">User manual</a></li>
</ul>
</div>
<div class="content">
<h1>Recoll screenshots</h1>
<a href="recoll0.html"><img src="recoll0-thumb.png"></a>
<a href="recoll1.html"><img src="recoll1-thumb.png"></a>
<a href="recoll2.html"><img src="recoll2-thumb.png"></a>
<a href="recoll3.html"><img src="recoll3-thumb.png"></a>
<a href="recoll4.html"><img src="recoll4-thumb.png"></a>
<a href="recoll5.html"><img src="recoll5-thumb.png"></a>
<a href="recoll-HTML_search_results.html">
<img src="recoll-HTML_search_results-thumb.png"></a>
</div>
</body>
</html>