From 555d209708d7d142efce1f79b0be51dde38cd29b Mon Sep 17 00:00:00 2001 From: Jean-Francois Dockes Date: Sun, 12 May 2013 11:19:31 +0200 Subject: [PATCH] doc --- website/BUGS.html | 1686 +++++++++++++++++-------------------- website/download.html | 583 ++++++------- website/index.html.en | 13 +- website/index.html.fr | 8 +- website/release-1.19.html | 387 ++++----- 5 files changed, 1189 insertions(+), 1488 deletions(-) diff --git a/website/BUGS.html b/website/BUGS.html index 29418fbd..14bd7e40 100644 --- a/website/BUGS.html +++ b/website/BUGS.html @@ -1,973 +1,791 @@ - - Recoll known bugs + + Recoll known bugs + + + + + + + + - - - - - - - + - - +
+ +
- - -
- -
- -
+
+

Known bugs in current and older versions

-

Known bugs in current and older versions

+

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.

-

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.

+

recoll 1.19.0

+
    +
  • On systems such as Debian Stable which use Evince version 2.x (not 3.x) + as PDF viewer, the default "Open" command for PDF files will not work. You + need to use the GUI preferences tool to change the --page-index option to + --page-label for the evince command line used for PDF.
    • +
  • It will sometimes happen that the result list paragraph format stored in + the Qt preferences file will get garbled, causing result lists with no + displayed paragraphs (the counts and pages are ok, the results can be seen + in table mode, but not in list mode). The workaround is to go to - -

    recoll 1.19.0

    -
      -
    • On systems such as Debian Stable which use Evince version - 2.x (not 3.x) as PDF viewer, the default "Open" command for - PDF files will not work. You need to use the GUI preferences - tool to change the --page-index option to --page-label for - the evince command line used for PDF.
      • -
    • It will sometimes happen that the result list paragraph - format stored in the Qt preferences file will get garbled, - causing result lists with no displayed paragraphs (the - counts and pages are ok, the results can be seen in table - mode, but not in list mode). The workaround is to go to -
      - Preferences->Query configuration->User interface -
      and erase the result paragraph format string - (^A DEL in the text area), this will reset the string to the - default value.
      • +
      + Preferences->Query configuration->User interface
      + and erase the result paragraph format string (^A DEL in the text area), + this will reset the string to the default value. +
    • Real time indexer: when running with gamin on FreeBSD, the indexer can + deadlock in the gamin dialog in some cases.
      • +
    • After an upgrade, the recoll GUI sometimes crashes on startup. This is + fixed by removing (back it up just in case) + ~/.config/Recoll.org/recoll.conf, the QSettings storage for recoll.
      • +
    -
  • Real time indexer: when running with gamin on FreeBSD, the - indexer can deadlock in the gamin dialog in some - cases.
    • - -
  • After an upgrade, the recoll GUI sometimes crashes on - startup. This is fixed by removing (back it up just in case) - ~/.config/Recoll.org/recoll.conf, the QSettings storage for - recoll.
    • -
- -

recoll 1.18.2

-
    -
  • When no indexing helper applications are actually missing, - an ennoying popup is shown in the GUI at each end of a batch - indexing run (it's supposed to be shown only once).
    • - -
  • Category (media, message, etc.) expansion does not work - for mime types which have no associated filter. This is - quite often the case for video types (so they won't be found - under "media").
    - There is a possible imperfect workaround. Create a filter - shell-script named rclbad inside the filters directory, with - only an 'exit 1' inside it, make it executable and associate - it to the video types, in ~/.recoll/mimeconf: -
    -[index]
+
    recoll 1.18.2
    
+
      
+  
    • When no indexing helper applications are actually missing, an ennoying
+    popup is shown in the GUI at each end of a batch indexing run (it's
+    supposed to be shown only once).
      • 
+  
    • Category (media, message, etc.) expansion does not work for mime types
+    which have no associated filter. This is quite often the case for video
+    types (so they won't be found under "media"). 
      
+    There is a possible imperfect workaround. Create a filter shell-script
+    named rclbad inside the filters directory, with only an 'exit 1' inside it,
+    make it executable and associate it to the video types, in
+    ~/.recoll/mimeconf: 
+    
      [index]
 video/mp2p = exec rclbad
 video/mp2t = exec rclbad
 video/mp4  = exec rclbad
 video/avi  = exec rclbad
 video/divx = exec rclbad
-video/x-msvideo = exec rclbad
-
      
-        
      • 
-
-
-        
    • It's possible to add an external index with a
-          case/diacritics stripping option different from the main
-          index'. Searches will mostly not work.
      • 
-
-        
    • fnmatch() errors sometimes encountered because of
-          character set and locale issues were treated as
-          matches.
      • 
-
-        
    • When an advanced search finds no result, the spelling
-          suggestions screen which is displayed contains links which can
-          only be useful for a simple search. Clicking them will
-          result in confusion.
      • 
-
-        
    • When the real-time indexer updates a compound document
-          which has been shortened (typically, a truncated mbox folder),
-          the obsolete documents beyond the new end were not deleted,
-          resulting in confusing behaviour.
      • 
-
-        
    • Expansions of '*' were sometimes done against the whole
-          indexes in cases where it would have been able data restricted
-          to a field, resulting in much degraded performance.
      • 
-
-        
    • Wildcards were wrongly handled when splitting a string
-          before a query, so that things like recoll@* could
-          end up being split as recoll *.
      • 
-
-      
    
-
-
-      
    recoll 1.18.1
     
-      
      
-
-        
    • When using the Firefox plugin, increasing the web cache
-          size only has an effect when initially creating the
-          cache. If the cache already exists, you need to delete it
-          for the new limit to take effect.
      • 
-
-        
    • Sizes for documents bigger than 2 GB are improperly
-          displayed.
      •  
-
-        
    • Wildcards expressions sometimes cause false matches
-          because of issues in handling errors from fnmatch(). This
-          will only occur in an UTF-8 locale where file name
-          conversion errors are possible (for old 8bit file
-          names).
      • 
-
-        
    • CHM files character encoding is sometimes wrongly processed.
      • 
-
-        
    • Sorting by field 'relevancyrating' is not equivalent to
-          natural Xapian ordering.
      • 
-
-        
    • Weird data in filter output text (e.g.: produced by some
-          versions of pdftotext) can cause an error which will halt
-          the processing of the document, which becomes
-          unsearchable. This is a relatively uncommon problem which
-          signals itself by a specific error in the indexing log, so
-          you can know if you are affected. Look for:
-          xapian add_posting error Empty termnames aren't allowed
-        
      •  
-
-        
    • Raw indexes (not default): diacritics and case expansion
-          is not applied to terms containing numbers so that a
-          case-insensitive search does not work for them (e.g.:
-          searching for ds1820 will not find DS1820).
      • 
-      
    
-
-      
    recoll 1.18.0
     
-      
      
-        
    • Thumbnails are not found on newer desktops (e.g. Ubuntu
-          Quantal) because of a change in the freedesktop.org
-          "standard".
      • 
-        
    • A bug in extracting search term from click data in the
-          snippet window results in passing an incorrect term to the
-          viewer. Only affects non-ascii terms.
      • 
-        
    • Using the snippets window can sometimes crash the
-          GUI.
      • 
-        
    • Tilde expansion is not properly performed for the
-          "beaglequeuedir" parameter. This only affects people who
-          develop scripts over the queue feature.
      • 
-        
    • The missing filter recording code is broken.
      • 
-        
    • Opening embedded documents from the Unity Lens does not
-          work.
      • 
-      
    
-
-      
    recoll 1.17.3
     
-      
-      
    Fixed in 1.17.4 and 1.18:
    
-      
      
-        
    • The real time monitor can be terminated for permissions-related
-          addwatch errors that should be non-fatal.
      • 
-        
    • text/plain files are sometimes opened as csv (using a
-          spreadsheet...)
      •  
-        
    • Tilde expansion was wrong for the
-          beaglequeuedir/webqueuedir variable, causing problem when
-          using the new Web history indexer module with 1.17.
      • 
-        
    • Fixed relatively benign memory leak in the filters
-         cache handler.
      • 
-        
    • Prevent document indexing truncation caused by unac in
-          some marginal case which became quite common with the recent
-          versions of pdftotext.
      • 
-      
    
-
-      
    Only fixed in the 1.18 branch:
    
-      
      
-        
    • Messages in Qt standard dialog messages are not translated.
      • 
-        
    • The unac_except_trans mechanism can generate wrong
-          character translations in some cases.
      •  
-        
    • ODF documents exported by Google docs are badly
-          processed.
      •  
-        
    • It is impossible to open the parent of an
-          embedded document (e.g. the CHM file for an HTML page
-          inside the CHM) if the parent is itself a member of an
-          archive.
      •  
-        
    • Text inside malformed HTML files (appearing before a <body>
-          tag, or after a second one, or after a </body> tag is
-          not indexed. As it would be displayed by current browsers,
-          this is wrong.
      • 
-
-      
    
-
-      
    recoll 1.17.2
     
-
-      
      
-        
    • It appears that recollindex will sometimes crash while
-          indexing mail files. There are 2 separate reports about
-          this, and no resolution for now. This is not specific to
-          1.17 as one of the reports is for 1.16. Refs:
-          Fedora
-          (maildir, processing an attachment), 
-          Ubuntu: apparently (no stack trace): 
-          Recoll was indexing files in .thunderbird when the crash
-            occurred. It seemed to be indexing the INBOX file on
-            disk.  
-        
      • 
-        
    • There were a few small glitches when paging the result
-          list, for example going back from the last page.
      • 
-      
    
-
-      
    recoll 1.17.1
     
-
-      
      
-        
    • You can crash the GUI by starting simultaneous queries,
-          which could be accomplished among others by quickly clicking
-          the sort order buttons.
      • 
-
-        
    • When external indexes set as active are not actually
-          present, the GUI fails to open the db. It should
-          automatically inactivate them instead.
      • 
-
-        
    • Does not display thumbnails for files with an URL which
-          should be encoded (ie: with embedded spaces).
      • 
-
-        
    • chm filter: url-encoded internal paths are mishandled.
      • 
-
-        
    • Does not compile on Solaris (flock() issue).
      • 
-
-        
    • The KDE recoll applet does not work.
      • 
-
-        
    • configure --disable-python-module breaks the installation
-          script.
      • 
-
-        
    • The version string is not correctly updated for 1.17.1, the
-          help dialog and recollindex -v will print 1.17.0.
      • 
-
-        
    • The HTML output from Python (rclexecm) filters is not
-          correctly escaped.
      • 
-
-        
    • Does not compile with gcc 4.7 (missing include).
      • 
-        
-      
    
-
-
-      
    recoll 1.17.0
     
-        
  • The chm filter handles badly some CHM files with encoded
-          internal URLs (the whole file or some parts are not
-          indexed). There is an updated filter on the filters section
-          of the download page.
    • 
-        
  • The application style sheet is not reapplied when changed
-          from the preferences menu, you have to restart the GUI.
    • 
-
-      
    recoll 1.16.2
     
-        
  • Real time indexer: directory moves are not handled at
-          all. Workaround: restart indexer from time to time.
    • 
-        
  • Real time indexer: file move events are not detected when
-          running with inotify (at least for recent
-          versions). Workaround: restart indexer from time to time.
    • 
-        
  • Cancelling a preview in the GUI will also cancel the indexing
-          thread if it is running.
    • 
-        
  • Under Solaris, it is necessary to perform the initial
-          indexing with the recollindex program. For some unknown reason,
-          the recoll index thread does not work for creating the database.
-          The only idea I have is a problem with exception handling (recoll
-          catches an exception while trying the yet inexistant db).
    • 
-
-      
    recoll 1.16.1
     
-      
      
-        
    • At least on OpenSUSE 12.1 / Qt 4.7.4 (and probably other
-          environments), the links to Preview or Open inside the
-          result list do not work. Also the GUI can crash if a
-          temporary directory creation fails.
      • 
-        
    • The Python filters can crash under certain error
-          conditions. This is a benign error, affecting just 
-          the current document, but it causes system reports.
      • 
-        
    • The query is run 2 times, in most cases. This does not
-          cause a too dramatic performance impact because of caching but
-          still...
      • 
-        
    • The output from some filters (most typically text files
-          out from the zip filters) is sometimes not transcoded
-          correctly to UTF-8, causing myriads of error messages (and a
-          possible application crash due to another bug in the unac
-          code, described further).
      • 
-        
    • There is a compilation issue on Linux systems with a 3.x
-          kernel.
      • 
-        
    • Queries without search terms (ie: all files of a given
-          mime type) fail with an "empty query" diagnostic.
      • 
-        
    • The recollq command line query program sometimes does not
-          clean up its temporary directory.
      • 
-        
    • Indexing can crash on files with weird names (inconsistent with the
-          locale) for which the format of the "file -i" command is
-          unexpected. This is probably dependant on the type of system
-          and/or locale. Workaround: arrange for the offending file
-          not to be indexed (move it away or configure it out), or
-          apply this patch,
-          which should work with all versions from 1.13 to 1.16.1
      • 
-        
    • Under certain conditions, the indexer can use all
-          available memory and crash. This is caused by a memory leak
-          in an error handling path inside unac, and can only be
-          triggered in specific conditions (all cases seen were from
-          files inside zip archives). Workaround: arrange for the
-          offending file not to be indexed (move it away or configure
-          it out), or apply this
-          patch, which should work with all versions from 1.13 to
-          1.16.1
      • 
-        
    • The lyx filter does not correctly detect the Lyx version,
-          needed for correct indexing.
      • 
-        
    • A typo in a memory reallocation call inside the firefox
-          web history indexing module may cause problems in a highly
-          improbable case.
      • 
-        
    • Directory creations are not processed by the real time
-          indexer (for indexing directory names).
      •  
-      
    
-
-      
    recoll 1.16.0
     
-      
      
-        
    • The recoll GUI program sometimes crashes when
-          running a query while the indexing thread is active.
-          Possible workarounds:
      
-          
        
-            
      • Upgrade to 1.16.1
        • 
-            
      • Use the command
-              line recollindex program to perform indexing
-              (usually just type "recollindex" in a console, or see "man
-              recollindex").
        • 
-            
      • Do not run queries in recoll while the indexing thread
-              is running (as indicated in the bottom status line).
        • 
-          
            
-        
      • 
-      
    
-      
    recoll 1.15.7
     
-      
      
-        
    • The default filter for files in Microsoft Word format
-          (application/msword, .doc), antiword, has trouble with some
-          relatively rare files with a very small text, resulting in the
-          following error message:
-          
      
-            I'm afraid the text stream of this file is too small to
-            handle.
-          
       
-
-          Only small files produced by Microsoft Word on a Mac, or by
-          OpenOffice will trigger this message.
      
-
-          Workaround: install wvWare and modify
-          mimeconf to use the rcldoc filter (instead of directly
-          executing antiword). Rcldoc will try antiword, then will use
-          vwWare if it is available. This will result in slightly
-          slower indexing for all normal .doc files. This fix was made the
-          default in 1.16
      • 
-
-        
    • Compressed man pages could not be previewed.
      • 
-        
    • Sorting by document and file size in the result table does
-          not work.
      • 
-        
    • idxflushmb was not handled while deleting documents in the
-          index, leading to almost unbounded memory usage.
      • 
-        
    • Email messages for which there would be an error indexing
-          an attachment would not be indexed at all.
      • 
-
-        
    • Performing a full index with release 1.11 or newer, 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 ~/.recoll/xapiandb/)
-          and restart indexing. For big indexes, to avoid losing
-          time, removing the directory preventively may be preferable .
      • 
-
-        
    • Text files bigger than 2 GB can not be indexed.
      • 
-
-        
    • Using the GUI preview while the indexing thread is running
-          will sometimes crash the GUI or provoke other
-          strangeness. This happens much more rarely than in 1.15.7,
-          but still occurs. Workaround if this happens too frequently:
-          use the standalone recollindex program instead of the GUI
-          thread.
      • 
-
-        
    • Real time indexer: uncontrolled concurrent access to
-          the global configuration can cause a startup crash (mostly of
-          big file trees because of timing issues).
      • 
-
-        
    • Using the result preview while the indexing thread is
-          running will sometimes crash the GUI or provoke other
-          strangeness. This is apparently due to insufficient
-          protection of resources shared by several threads. After
-          recent cleanup, the problem occurs quite seldom but it is
-          not completely gone. The current and unsatisfying
-          workaround, is to avoid the situation, for example by using
-          the standalone recollindex program instead of the GUI
-          indexing thread.
      • 
-
-        
    • The GUI preview function sometimes fails with a
-          non-sensical message about a non-related missing
-          helper.
      • 
-
-        
    • Most operations on the parent document in the result table
-          view are not connected and do nothing.
      • 
-
-        
    • The operations on the parent document in the result list
-	  right click menu (Preview and Open), do not work, they
-	  access the file's parent directory instead.
      • 
-
-        
    • The GUI option to remember sort state between invocations
-          only works for sort by date.
      • 
-
-        
    • The rclzip filter can't handle utf-8 in path names for archive
-          members. An 
-            updated filter is available. 
      • 
-
-        
    • The rclzip and rclchm filters can't handle archive members
-          with a colon (':') in the file name or path. The files are normally
-          indexed and can be searched for, but they can't be displayed
-          (neither opened nor previewed). There is a 
-          
-            patch which fixes the issue (then needs full reindex for these
-          files).
      • 
-
-        
    • The ignored suffixes list (recoll_noindex) is itself
-          ignored in some cases.
      •  
-
-        
-        
    • The man filter creates groff temporary png files in the
-          home directory.
      • 
-
-        
    • Indexing can hang or crash after an error occurs on an
-          archive member (which should have affected only the relevant
-          document).
      • 
-
-        
    • The initial indexing pass in the real-time indexer does
-          not monitor the X11 session which can create problems if the
-          user ends the section at this point.
      • 
-
-        
    • Starting the indexing thread inside the GUI while another
-          indexer (batch or real-time) is active will silently
-          failed. It should show an error dialog.
      • 
-
-        
    • When an open error occurs on an external index while
-          starting the GUI, the initial indexing dialog is started,
-          which is incorrect because it cannot fix the problem.
      • 
-
-        
    • The result table row height is not adjusted according to
-          default font size, and the vertical position of text in cells
-          is often bad.
      • 
-      
    
-
-
-      
    recoll 1.15.5
     
-      
  • The Python and PHP modules in 1.15.5 have compile errors. This
-        is solved by 
-        
-          this simple change.
    • 
-      
  • The current stemming language is not indicated by menu
-        checkboxes.
    •  
-
-      
    recoll 1.15.2
     
-      
      
-        
    • If a result table column is both added and moved in the same
-          GUI instance, the list becomes garbled (or/and the GUI
-          crashes). Workaround: remove the Qt GUI config
-          (.config/Recoll.org/recoll.conf), and perform the operation in 2 GUI
-          sessions: add column, exit recoll, restart, move column.
      • 
-
-        
    • Clicking one of the category filter checkboxes
-          (one of the media/message/text/... things) with an empty result
-          list crashes the GUI (just like this, yeah, I know, quality
-          insurance etc.). Workaround: don't click these before running the
-          first query.
      • 
-
-        
    • Changing the indexing configuration parameters from the GUI
-          while the indexing thread (not an external recollindex command) is
-        running will sometimes (quite often) crash the GUI.
      • 
-
-        
    • Script files (ie: .sh .pl) indexed as text do not respect
-        the maximum text file limit (a problem with, ie, shar archives
-        identified as application/x-shellscript).
      • 
-
-        
    • indexing script for xml formats (ie: svg) sometimes stall for
-        30 S while xsltproc tries to access remote dtds.
      • 
-
-        
    • recollindex inapproprietely sets the nice value for its whole
-        process group. In certain cases where the indexing monitor was
-        launched at session start, this could set the whole session to low
-        priority!
      • 
-
-      
    
-
-      
    recoll 1.14.4
     
-      
      
-        
    • rclmon.sh stop would not work.
      • 
-        
    • Some shell, awk, and perl scripts are not indexed. There is a
-        simple 
-       configuration tweak workaround
-        
    • The tree walk in indexing could loop on symbolic links.
      • 
-        
    •  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.
      • 
-      
    
-
-      
    recoll 1.14.3
    
-      
  • Email message preview is broken.
    • 
-      
  • The new mutagen-based audio tags filter (rclaudio) only
-	  works with very recent mutagen
-	  versions. See here for a
-	  corrected version.
    • 
-
-      
    recoll 1.14.1
    
-      
  • Compressed file view fix broke help viewer.
    • 
-
-      
    recoll 1.14.0
    
-	
  • Does not compile with Xapian
-	  1.2. Apply patch.
    •  
-        
  •  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.
    • 
-
-      
    recoll 1.13.04
    
-        
    Note: some of the bugs listed here are not actually
-        "fixed", mostly they were problems caused by old versions of
-        external software (ie: kde, qt), and I stopped carrying them. Just
-        don't use these versions, or live with the problem.
    
-
-        
  • In case a new style filter (persistent) crashed while indexing,
-          it was not restarted, and all further files of the same mime type
-          were not updated (ie: python zip crash on encrypted files).
    • 
-
-	
  • Mac OS X + Qt 4.6.1 : the index configuration dialog
-	  crashes. Fixed with Qt 4.7.
    • 
-
-        
  • 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).
    • 
-
-        
  • It seems that the recoll program sometimes segfaults when
-          exiting after the first execution ?
    • 
-
-        
  • 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 (stopped carrying this bug. Just don't use
-          4.4.0)
    •  
-
-        
  •  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.
    • 
-
-
-      
    recoll 1.13.02
    
-        
  • Stemming does not work in the 1.13 series. The stemming
-        database was not created at all. Things would sort of work as
-        long as an older stemming database was around (which is why
-        this was not discovered earlier.
    • 
-       
  • Fix the lyx filter to properly handle embedded white space in
-        file paths.
    • 
-
-      
    recoll 1.13.01 + xapian 1.0.16
     
-      
  • The GUI display is garbled under Qt 4.6.1 and newer. This is
-      a Qt bug, and a workaround was put in place in Recoll 1.13.02
-      for Qt 4.6.1. If you are using a newer version and the problem
-      is still there, you can fix the
-      4.6.1 fix to hopefully work with your Qt version: edit
-      qtgui/rclmain_w.h, around line 37 (there is only one instance),
-      change:
-
    -  #if QT_VERSION == 0x040601
+video/x-msvideo = exec rclbad
    
+  
    • 
+  
  • It is possible to add an external index with a case/diacritics stripping
+    option different from the main index'. Searches will mostly not work.
    • 
+  
  • fnmatch() errors sometimes encountered because of character set and
+    locale issues were treated as matches.
    • 
+  
  • When an advanced search finds no result, the spelling suggestions screen
+    which is displayed contains links which can only be useful for a simple
+    search. Clicking them will result in confusion.
    • 
+  
  • When the real-time indexer updates a compound document which has been
+    shortened (typically, a truncated mbox folder), the obsolete documents
+    beyond the new end are not deleted, resulting in confusing behaviour.
    • 
+  
  • Expansions of '*' inside a field were sometimes done against the whole
+    index, resulting in much degraded performance.
    • 
+  
  • Wildcards were wrongly handled when splitting a string before a query, so
+    that things like recoll@* could end up being split as recoll
+    *.
    • 
+
+ +

recoll 1.18.1

+
    +
  • When using the Firefox plugin, increasing the web cache size only has an + effect when initially creating the cache. If the cache already exists, you + need to delete it for the new limit to take effect.
    • +
  • Sizes for documents bigger than 2 GB are improperly displayed.
    • +
  • Wildcards expressions sometimes cause false matches because of issues in + handling errors from fnmatch(). This will only occur in an UTF-8 locale + where file name conversion errors are possible (for old 8bit file + names).
    • +
  • CHM files character encoding is sometimes wrongly processed.
    • +
  • Sorting by field 'relevancyrating' is not equivalent to natural Xapian + ordering.
    • +
  • Weird data in filter output text (e.g.: produced by some versions of + pdftotext) can cause an error which will halt the processing of the + document, which becomes unsearchable. This is a relatively uncommon problem + which signals itself by a specific error in the indexing log, so you can + know if you are affected. Look for: xapian add_posting error Empty + termnames aren't allowed
    • +
  • Raw indexes (not default): diacritics and case expansion is not applied + to terms containing numbers so that a case-insensitive search does not work + for them (e.g.: searching for ds1820 will not find DS1820).
    • +
+ +

recoll 1.18.0

+
    +
  • Thumbnails are not found on newer desktops (e.g. Ubuntu Quantal) because + of a change in the freedesktop.org "standard".
    • +
  • A bug in extracting search term from click data in the snippet window + results in passing an incorrect term to the viewer. Only affects non-ascii + terms.
    • +
  • Using the snippets window can sometimes crash the GUI.
    • +
  • Tilde expansion is not properly performed for the "beaglequeuedir" + parameter. This only affects people who develop scripts over the queue + feature.
    • +
  • The missing filter recording code is broken.
    • +
  • Opening embedded documents from the Unity Lens does not work.
    • +
+ +

recoll 1.17.3

+ +

Fixed in 1.17.4 and 1.18:

+
    +
  • The real time monitor can be terminated for permissions-related addwatch + errors that should be non-fatal.
    • +
  • text/plain files are sometimes opened as csv (using a spreadsheet...)
    • +
  • Tilde expansion was wrong for the beaglequeuedir/webqueuedir variable, + causing problem when using the new Web history indexer module with + 1.17.
    • +
  • Fixed relatively benign memory leak in the filters cache handler.
    • +
  • Prevent document indexing truncation caused by unac in some marginal case + which became quite common with the recent versions of pdftotext.
    • +
+ +

Only fixed in the 1.18 branch:

+
    +
  • Messages in Qt standard dialog messages are not translated.
    • +
  • The unac_except_trans mechanism can generate wrong character translations + in some cases.
    • +
  • ODF documents exported by Google docs are badly processed.
    • +
  • It is impossible to open the parent of an embedded document (e.g. the CHM + file for an HTML page inside the CHM) if the parent is itself a member of + an archive.
    • +
  • Text inside malformed HTML files (appearing before a <body> tag, or + after a second one, or after a </body> tag is not indexed. As it + would be displayed by current browsers, this is wrong.
    • +
+ +

recoll 1.17.2

+
    +
  • It appears that recollindex will sometimes crash while indexing mail + files. There are 2 separate reports about this, and no resolution for now. + This is not specific to 1.17 as one of the reports is for 1.16. Refs: Fedora + (maildir, processing an attachment), Ubuntu: + apparently (no stack trace): Recoll was indexing files in .thunderbird + when the crash occurred. It seemed to be indexing the INBOX file on disk. +
    • +
  • There were a few small glitches when paging the result list, for example + going back from the last page.
    • +
+ +

recoll 1.17.1

+
    +
  • You can crash the GUI by starting simultaneous queries, which could be + accomplished among others by quickly clicking the sort order buttons.
    • +
  • When external indexes set as active are not actually present, the GUI + fails to open the db. It should automatically inactivate them instead.
    • +
  • Does not display thumbnails for files with an URL which should be encoded + (ie: with embedded spaces).
    • +
  • chm filter: url-encoded internal paths are mishandled.
    • +
  • Does not compile on Solaris (flock() issue).
    • +
  • The KDE recoll applet does not work.
    • +
  • configure --disable-python-module breaks the installation script.
    • +
  • The version string is not correctly updated for 1.17.1, the help dialog + and recollindex -v will print 1.17.0.
    • +
  • The HTML output from Python (rclexecm) filters is not correctly + escaped.
    • +
  • Does not compile with gcc 4.7 (missing include).
    • +
+ +

recoll 1.17.0

+
    +
  • The chm filter handles badly some CHM files with encoded internal URLs + (the whole file or some parts are not indexed). There is an updated filter + on the filters section of the download page.
    • +
  • The application style sheet is not reapplied when changed from the + preferences menu, you have to restart the GUI.
    • +
+ +

recoll 1.16.2

+
    +
  • Real time indexer: directory moves are not handled at all. Workaround: + restart indexer from time to time.
    • +
  • Real time indexer: file move events are not detected when running with + inotify (at least for recent versions). Workaround: restart indexer from + time to time.
    • +
  • Cancelling a preview in the GUI will also cancel the indexing thread if + it is running.
    • +
  • Under Solaris, it is necessary to perform the initial indexing with the + recollindex program. For some unknown reason, the recoll index thread does + not work for creating the database. The only idea I have is a problem with + exception handling (recoll catches an exception while trying the yet + inexistant db).
    • +
+ +

recoll 1.16.1

+
    +
  • At least on OpenSUSE 12.1 / Qt 4.7.4 (and probably other environments), + the links to Preview or Open inside the result list do not work. Also the + GUI can crash if a temporary directory creation fails.
    • +
  • The Python filters can crash under certain error conditions. This is a + benign error, affecting just the current document, but it causes system + reports.
    • +
  • The query is run 2 times, in most cases. This does not cause a too + dramatic performance impact because of caching but still...
    • +
  • The output from some filters (most typically text files out from the zip + filters) is sometimes not transcoded correctly to UTF-8, causing myriads of + error messages (and a possible application crash due to another bug in the + unac code, described further).
    • +
  • There is a compilation issue on Linux systems with a 3.x kernel.
    • +
  • Queries without search terms (ie: all files of a given mime type) fail + with an "empty query" diagnostic.
    • +
  • The recollq command line query program sometimes does not clean up its + temporary directory.
    • +
  • Indexing can crash on files with weird names (inconsistent with the + locale) for which the format of the "file -i" command is unexpected. This + is probably dependant on the type of system and/or locale. Workaround: + arrange for the offending file not to be indexed (move it away or configure + it out), or apply this patch, + which should work with all versions from 1.13 to 1.16.1
    • +
  • Under certain conditions, the indexer can use all available memory and + crash. This is caused by a memory leak in an error handling path inside + unac, and can only be triggered in specific conditions (all cases seen were + from files inside zip archives). Workaround: arrange for the offending file + not to be indexed (move it away or configure it out), or apply this patch, which should work with + all versions from 1.13 to 1.16.1
    • +
  • The lyx filter does not correctly detect the Lyx version, needed for + correct indexing.
    • +
  • A typo in a memory reallocation call inside the firefox web history + indexing module may cause problems in a highly improbable case.
    • +
  • Directory creations are not processed by the real time indexer (for + indexing directory names).
    • +
+ +

recoll 1.16.0

+
    +
  • The recoll GUI program sometimes crashes when running a query + while the indexing thread is active. Possible workarounds:
    + +
      +
    • Upgrade to 1.16.1
      • +
    • Use the command line recollindex program to perform indexing + (usually just type "recollindex" in a console, or see "man + recollindex").
      • +
    • Do not run queries in recoll while the indexing thread is + running (as indicated in the bottom status line).
      • +
    +
    • +
+ +

recoll 1.15.7

+
    +
  • The default filter for files in Microsoft Word format + (application/msword, .doc), antiword, has trouble with some relatively rare + files with a very small text, resulting in the following error message: + +
    + I'm afraid the text stream of this file is too small to handle. +
    + Only small files produced by Microsoft Word on a Mac, or by OpenOffice will + trigger this message.
    + Workaround: install wvWare and modify mimeconf to use the rcldoc + filter (instead of directly executing antiword). Rcldoc will try antiword, + then will use vwWare if it is available. This will result in slightly + slower indexing for all normal .doc files. This fix was made the default in + 1.16
    • +
  • Compressed man pages could not be previewed.
    • +
  • Sorting by document and file size in the result table does not work.
    • +
  • idxflushmb was not handled while deleting documents in the index, leading + to almost unbounded memory usage.
    • +
  • Email messages for which there would be an error indexing an attachment + would not be indexed at all.
    • +
  • Performing a full index with release 1.11 or newer, 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 ~/.recoll/xapiandb/) and + restart indexing. For big indexes, to avoid losing time, removing the + directory preventively may be preferable .
    • +
  • Text files bigger than 2 GB can not be indexed.
    • +
  • Using the GUI preview while the indexing thread is running will sometimes + crash the GUI or provoke other strangeness. This happens much more rarely + than in 1.15.7, but still occurs. Workaround if this happens too + frequently: use the standalone recollindex program instead of the GUI + thread.
    • +
  • Real time indexer: uncontrolled concurrent access to the global + configuration can cause a startup crash (mostly of big file trees because + of timing issues).
    • +
  • Using the result preview while the indexing thread is running will + sometimes crash the GUI or provoke other strangeness. This is apparently + due to insufficient protection of resources shared by several threads. + After recent cleanup, the problem occurs quite seldom but it is not + completely gone. The current and unsatisfying workaround, is to avoid the + situation, for example by using the standalone recollindex program instead + of the GUI indexing thread.
    • +
  • The GUI preview function sometimes fails with a non-sensical message + about a non-related missing helper.
    • +
  • Most operations on the parent document in the result table view are not + connected and do nothing.
    • +
  • The operations on the parent document in the result list right click menu + (Preview and Open), do not work, they access the file's parent directory + instead.
    • +
  • The GUI option to remember sort state between invocations only works for + sort by date.
    • +
  • The rclzip filter can't handle utf-8 in path names for archive members. + An updated filter is + available.
    • +
  • The rclzip and rclchm filters can't handle archive members with a colon + (':') in the file name or path. The files are normally indexed and can be + searched for, but they can't be displayed (neither opened nor previewed). + There is a patch + which fixes the issue (then needs full reindex for these files).
    • +
  • The ignored suffixes list (recoll_noindex) is itself ignored in some + cases.
    • +
  • The man filter creates groff temporary png files in the home + directory.
    • +
  • Indexing can hang or crash after an error occurs on an archive member + (which should have affected only the relevant document).
    • +
  • The initial indexing pass in the real-time indexer does not monitor the + X11 session which can create problems if the user ends the section at this + point.
    • +
  • Starting the indexing thread inside the GUI while another indexer (batch + or real-time) is active will silently failed. It should show an error + dialog.
    • +
  • When an open error occurs on an external index while starting the GUI, + the initial indexing dialog is started, which is incorrect because it + cannot fix the problem.
    • +
  • The result table row height is not adjusted according to default font + size, and the vertical position of text in cells is often bad.
    • +
+ +

recoll 1.15.5

+
    +
  • The Python and PHP modules in 1.15.5 have compile errors. This is solved + by this + simple change.
    • +
  • The current stemming language is not indicated by menu checkboxes.
    • +
+ +

recoll 1.15.2

+
    +
  • If a result table column is both added and moved in the same GUI + instance, the list becomes garbled (or/and the GUI crashes). Workaround: + remove the Qt GUI config (.config/Recoll.org/recoll.conf), and perform the + operation in 2 GUI sessions: add column, exit recoll, restart, move + column.
    • +
  • Clicking one of the category filter checkboxes (one of the + media/message/text/... things) with an empty result list crashes the GUI + (just like this, yeah, I know, quality insurance etc.). Workaround: don't + click these before running the first query.
    • +
  • Changing the indexing configuration parameters from the GUI while the + indexing thread (not an external recollindex command) is running will + sometimes (quite often) crash the GUI.
    • +
  • Script files (ie: .sh .pl) indexed as text do not respect the maximum + text file limit (a problem with, ie, shar archives identified as + application/x-shellscript).
    • +
  • indexing script for xml formats (ie: svg) sometimes stall for 30 S while + xsltproc tries to access remote dtds.
    • +
  • recollindex inapproprietely sets the nice value for its whole process + group. In certain cases where the indexing monitor was launched at session + start, this could set the whole session to low priority!
    • +
+ +

recoll 1.14.4

+
    +
  • rclmon.sh stop would not work.
    • +
  • Some shell, awk, and perl scripts are not indexed. There is a simple configuration + tweak workaround
    • +
  • The tree walk in indexing could loop on symbolic links.
    • +
  • 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.
    • +
+ +

recoll 1.14.3

+
    +
  • Email message preview is broken.
    • +
  • The new mutagen-based audio tags filter (rclaudio) only works with very + recent mutagen versions. See here for a + corrected version.
    • +
+ +

recoll 1.14.1

+
    +
  • Compressed file view fix broke help viewer.
    • +
+ +

recoll 1.14.0

+
    +
  • Does not compile with Xapian 1.2. Apply patch.
    • +
  • 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.
    • +
+ +

recoll 1.13.04

+ +

Note: some of the bugs listed here are not actually "fixed", mostly +they were problems caused by old versions of external software (ie: kde, qt), +and I stopped carrying them. Just don't use these versions, or live with the +problem.

+
    +
  • In case a new style filter (persistent) crashed while indexing, it was + not restarted, and all further files of the same mime type were not updated + (ie: python zip crash on encrypted files).
    • +
  • Mac OS X + Qt 4.6.1 : the index configuration dialog crashes. Fixed with + Qt 4.7.
    • +
  • 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).
    • +
  • It seems that the recoll program sometimes segfaults when exiting after + the first execution ?
    • +
  • 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 (stopped carrying this bug. + Just don't use 4.4.0)
    • +
  • 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.
    • +
+ +

recoll 1.13.02

+
    +
  • Stemming does not work in the 1.13 series. The stemming database was not + created at all. Things would sort of work as long as an older stemming + database was around (which is why this was not discovered earlier.
    • +
  • Fix the lyx filter to properly handle embedded white space in file + paths.
    • +
+ +

recoll 1.13.01 + xapian 1.0.16

+
    +
  • The GUI display is garbled under Qt 4.6.1 and newer. This is a Qt bug, + and a workaround was put in place in Recoll 1.13.02 for Qt 4.6.1. If you + are using a newer version and the problem is still there, you can fix the + 4.6.1 fix to hopefully work with your Qt version: edit qtgui/rclmain_w.h, + around line 37 (there is only one instance), change: + 
      #if QT_VERSION == 0x040601
   to  
-  #if QT_VERSION >= 0x040601
-
    -
    • + #if QT_VERSION >= 0x040601 + +
-

recoll 1.13.01 + xapian 1.0.16

+

recoll 1.13.01 + xapian 1.0.16

+
    +
  • The field value was ignored in field searches for phrases or capitalized + words (ie: author:John or title:"the title").
    • +
  • The GUI would sometimes crash during the first execution, after the + dialog about starting configuration.
    • +
  • kio-recoll was not fully updated for 1.13 internals.
    • +
  • Would not compile on Solaris 8.
    • +
-
  • The field value was ignored in field searches for phrases or - capitalized words (ie: author:John or title:"the title").
    • -
  • The GUI would sometimes crash during the first execution, - after the dialog about starting configuration.
    • -
  • kio-recoll was not fully updated for 1.13 internals.
    • -
  • Would not compile on Solaris 8.
    • +

    1.12.4

    +
      +
    • There are two bugs specific to 64 bits system, affecting HTML display + inside the preview window (wrong character set used in some cases, and + problems with keyword highlighting).
      • +
    +

    1.12.3

    +
      +
    • Specific File Name searches and Query Language searches for a 'filename:' + field sometimes give different results due to the way we handle wild card + expansion.
      • +
    • Killing recollindex sometimes left filter processes sleeping around.
      • +
    • The last entry in a configuration file was ignored if it was not followed + by a newline (either the file had no ending newline or the line ended with + backslash followed by the last file line.
      • +
    • Non-ascii characters in path names did not work well from the + configuration GUI (editing the configuration files did work).
      • +
    • Accented characters in mail headers encoded according to a lax + interpretation of rfc2047 were sometimes not decoded.
      • +
    • Recoll dumps core when exiting if the configuration was not found.
      • +
    • The Qt4 version sometimes did not display the status bar in the main + window.
      • +
    • Message boundaries were not detected inside mbox format files with quoted + strings inside the 'From ' lines. (ie [From "Smith, John" ...]).
      • +
    • The Term Explorer GUI dialog was not created at all if aspell was not + compiled int (leaving no access to wildcard, regexp and stemming + expansions).
      • +
    • Give priority to the user's PATH when looking for qmake (fixes detecting + the wrong qmake when more than one exists).
      • +
    +

    1.12.2

    +
      +
    • The sort tool does not work with qt3 (at least some versions), the Apply + button does nothing.
      • +
    -

    1.12.4

    -
  • There are two bugs specific to 64 bits system, affecting - HTML display inside the preview window (wrong character set - used in some cases, and problems with keyword highlighting). -
    • +

    1.12.1

    +
      +
    • Uncatched Xapian exceptions can crash the GUI when a query is run while + the index is being updated.
      • +
    • The result list right-click pop up menu does not appear when the cursor + is inside a table.
      • +
    • Multithreaded access to Xlib can crash the real-time indexer.
      • +
    • A looping filter (ie: rclps trying to index loop.ps) can keep on running + forever and stop the indexing while eating cpu.
      • +
    • Filter subprocesses can sometimes be left around after indexing is + interrupted. Two signals are sometimes necessary to get recollindex to + exit.
      • +
    • Signals SIGUSR1 and SIGUSR2 are not blocked.
      • +
    • Sort does not work on queries started from the command line.
      • +
    +

    1.12.0

    +
      +
    • To compile the Python interface for recoll 1.12, you need to edit + setup.py and replace "rcldb/pathhash.cpp" with "utils/fileudi.cpp".
      • +
    • rclman outputs control characters, causing problems with preview and + phrase searches in manual pages.
      • +
    • rcllyx has trouble with 8bit characters in file names.
      • +
    • "recoll -q ..." processes incorrectly second and further command line + arguments.
      • +
    • The following problem was corrected by + Xapian 1.0.11 or 1.0.12, and I can see no reason to use older versions + and/or the patches below. However, they're kept around in case someone + needs them.
      + NEAR expansion errors: recoll performs stemming expansion inside NEAR + clauses (except if prevented by a capitalized entry). Because of a Xapian + bug (up to 1.0.12 (or 11?)), NEAR does not support multiple OR subclauses. + This manifests itself by a 'not implemented' Xapian exception or an + explicit error message. Workarounds: + +
      • +
    -

    1.12.3

    - -
  • Specific File Name searches and Query Language searches - for a 'filename:' field sometimes give different results due - to the way we handle wild card expansion.
    • +

    1.11.4

    +
      +
    • Possibly harmful bug in strerror_r usage (GNU case).
      • +
    • Incorrect handling of "accents" inside Japanese katakana text.
      • +
    • Using the "Erase history" command on an empty history would cause recoll + to crash.
      • +
    -
  • Killing recollindex sometimes left filter processes - sleeping around.
    • +

    1.11.1

    +
      +
    • Unicode space characters like 0x3000, Ideographic space 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.
      • +
    • Spaces were inserted inside CJK strings when building abstracts for the + result list.
      • +
    • Accent removal should not be performed for Japanese.
      • +
    • When using the query language, an OR part with more than two terms will + swallow preceding AND terms, one for each additional OR. Ex: (champagne + ext:odt OR ext:sxw OR ext:lyx) will be interpreted as "champagne OR ext:odt + OR ext:sxw OR ext:lyx" instead of the correct "champagne AND (ext:odt OR + ext:sxw OR ext:lyx)" Workaround until the fix is issued: add non-existing + terms before the OR part and check the resulting query: "champagne + bogusxyztv ext:odt OR ext:sxw OR ext:lyx"
      • +
    • 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).
      • +
    • Possibly harmful bug in strerror_r usage (GNU case).
      • +
    -
  • The last entry in a configuration file was ignored if it - was not followed by a newline (either the file had no ending - newline or the line ended with backslash followed by the last - file line.
    • - -
  • Non-ascii characters in path names did not work well from - the configuration GUI (editing the configuration files did - work).
    • - -
  • Accented characters in mail headers encoded according to a - lax interpretation of rfc2047 were sometimes not decoded.
    • - -
  • Recoll dumps core when exiting if the configuration was not - found.
    • - -
  • The Qt4 version sometimes did not display the - status bar in the main window.
    • - -
  • Message boundaries were not detected inside mbox format - files with quoted strings inside the 'From ' lines. - (ie [From "Smith, John" ...]).
    • - -
  • The Term Explorer GUI dialog was not created at all if - aspell was not compiled int (leaving no access to wildcard, - regexp and stemming expansions).
    • - -
  • Give priority to the user's PATH when looking for qmake - (fixes detecting the wrong qmake when more than one exists).
    • - - -

    1.12.2

    -
  • The sort tool does not work with qt3 (at least some - versions), the Apply button does nothing.
    • - -

    1.12.1

    -
  • Uncatched Xapian exceptions can crash the GUI when a query - is run while the index is being updated.
    • -
  • The result list right-click pop up menu does not appear - when the cursor is inside a table.
    • -
  • Multithreaded access to Xlib can crash the real-time indexer.
    • -
  • A looping filter (ie: rclps trying to index loop.ps) can - keep on running forever and stop the indexing while eating cpu.
    • -
  • Filter subprocesses can sometimes be left around after - indexing is interrupted. Two signals are sometimes necessary - to get recollindex to exit.
    • -
  • Signals SIGUSR1 and SIGUSR2 are not blocked.
    • -
  • Sort does not work on queries started from the command line.
    • - -

    1.12.0

    -
      -
    • To compile the Python interface for recoll 1.12, you need - to edit setup.py and replace "rcldb/pathhash.cpp" with - "utils/fileudi.cpp".
      • -
    • rclman outputs control characters, causing problems with - preview and phrase searches in manual pages.
      • -
    • rcllyx has trouble with 8bit characters in file names.
      • -
    • "recoll -q ..." processes incorrectly second and further - command line arguments.
      • -
    • The - following problem was corrected by Xapian 1.0.11 or - 1.0.12, and I can see no reason to use older versions and/or the - patches below. However, they're kept around in case someone - needs them.
      - NEAR expansion errors: recoll performs stemming expansion inside - NEAR clauses (except if prevented by a capitalized - entry). Because of a Xapian bug (up to 1.0.12 (or 11?)), NEAR - does not support multiple OR subclauses. This manifests itself - by a 'not implemented' Xapian exception or an explicit error - message. Workarounds: - -
      • - -
    - -

    1.11.4

    -
      -
    • Possibly harmful bug in strerror_r usage (GNU case).
      • -
    • Incorrect handling of "accents" inside Japanese katakana - text.
      • -
    • Using the "Erase history" command on an empty history - would cause recoll to crash.
      • -
    - -

    1.11.1

    -
      -
    • Unicode space characters like - 0x3000, Ideographic space - 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.
      • -
    • Spaces were inserted inside CJK strings when building - abstracts for the result list.
      • -
    • Accent removal should not be performed for Japanese.
      • -
    • When using the query language, an OR part with more than - two terms will swallow preceding AND terms, one for each - additional OR. Ex: (champagne ext:odt OR ext:sxw OR ext:lyx) - will be interpreted as - "champagne OR ext:odt OR ext:sxw OR ext:lyx" - instead of the correct - "champagne AND (ext:odt OR ext:sxw OR ext:lyx)" - Workaround until the fix is issued: add non-existing terms - before the OR part and check the resulting query: - "champagne bogusxyztv ext:odt OR ext:sxw OR ext:lyx" -
      • -
    • 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).
      • - -
    • Possibly harmful bug in strerror_r usage (GNU case).
      • -
    - -

    1.10.6

    -
      -
    • 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()));
+
      1.10.6
      
+
        
+  
      • 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()));
-          
        
-        
        • 
-      
      
+            >        sSearch->setSearchString(QString::fromLocal8Bit(qstring.c_str()));
+
      +
      • +
    -

    1.10.1

    +

    1.10.1

    +
      +
    • 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.
      • +
    -
      -
    • 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. -
    +

    1.10.0

    +
      +
    • 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).
      • +
    • 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.
      • +
    -

    1.10.0

    -
      +

      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. +
        • +
      -
    • 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). +

      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
        • +
      • 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 +
        • +
      • 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.
        • +
      • 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...)
        • +
      -
    • 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. +

      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.
        • +
      +

      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
        • +
      -
    -

    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. +

      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.
        • +
      -
    -

    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 +

      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.
        • +
      -
    • 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 +

      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.
        • +
      -
    • 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. +

      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.
        • +
      -
    • 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...) +

      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.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. +

      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.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 - -
    -

    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. - -
    -

    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 indexing 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.
      • - -
    - -
    - +

    1.2.2

    + +
    + diff --git a/website/download.html b/website/download.html index baac6cb2..eae4c023 100644 --- a/website/download.html +++ b/website/download.html @@ -1,382 +1,337 @@ - - - Recoll download + + Recoll download + + + + + + + + - - - - - - - + - - +
    + +
    - - -
    - -
    - -
    +
    +

    Recoll downloads

    -

    Recoll downloads

    +
    -
    - - - - - - - - - - - -
    SourcePackages (.rpm and .deb)Known bugsMac portsFilters Translations
    -
    + + + + + + + + + + + +
    SourcePackages (.rpm and .deb)Known bugsMac portsFilters Translations
    +
    -

    General information

    +

    General information

    -

    The current version is 1.18.2. - Release notes.

    +

    The current version is 1.19.0. Release +notes.

    -

    The download page for Recoll 1.17 is - still available.

    +

    The download page for Recoll 1.18 is still +available.

    -

    Recoll - Installation / building manual.

    +

    Recoll Installation / building +manual.

    -

    The indexing filters used for some document types may need - external packages not installed on your system by default, and - not installed automatically with Recoll: take a look at the list and - decide what you need to - install. Also new or updated - filters sometimes become available after a release. As a - rule, all filters are compatible with all Recoll - versions. Any compatibility problem will be explicitely - mentionned.

    +

    The indexing filters used for some document types may need external packages +not installed on your system by default, and not installed automatically with +Recoll: take a look at the list and decide +what you need to install. Also new or updated +filters sometimes become available after a release. As a rule, all filters +are compatible with all Recoll versions. Any compatibility problem will be +explicitely mentionned.

    -

    The Recoll term explorer tool in phonetic mode (marginally - useful and optional) uses the aspell package, version - 0.60 (utf-8 support) or newer.

    +

    The Recoll term explorer tool in phonetic mode (marginally useful and +optional) uses the aspell package, version 0.60 (utf-8 support) or +newer.

    -

    If you find problems with this page, the package or its - installation, please - report them.

    +

    If you find problems with this page, the package or its installation, +please report them.

    -

    What do the release numbers mean?

    +

    What do the release numbers mean?

    -

    The Recoll releases are numbered X.Y.Z. The X - would only change for really major modifications like a big - change in the index format, and possibly won't ever reach - 2.

    +

    The Recoll releases are numbered X.Y.Z. The X would only change for really +major modifications like a big change in the index format, and possibly won't +ever reach 2.

    -

    Y is for functional modifications. These may bring bugs, so - 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.

    +

    Y is for functional modifications. These may bring bugs, so 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.

    -

    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, any change can bring - problems, if you are not affected by the corrected bugs (check - the release file), there is - probably no necessity to upgrade anyway.

    +

    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, +any change can bring problems, if you are not affected by the +corrected bugs (check the release file), there +is probably no necessity to upgrade anyway.

    -

    Source

    +

    Source

    -

    Current release distribution: 1.18.2:

    - -

    recoll-1.18.2.tar.gz. -

    +

    Current release distribution: 1.19.0:

    + - +

    recoll-1.19.0.tar.gz.

    + -

    Prerequisites for building from source:

    -
      -
    • C++ compiler. Its absence sometimes manifests itself by - strange messages about iconv_open (fixed after 1.13.04).
      • +

      Prerequisites for building from source:

      +
        +
      • C++ compiler. Its absence sometimes manifests itself by strange messages + about iconv_open (fixed after 1.13.04).
        • +

      • Xapian core development libraries. Most Linux distributions carry them + in their package repository. Or you will find source and binary packages on + the Xapian download page. +
        + Recoll should still work with Xapian 1.0, but it is highly recommended to + use a Xapian 1.2 version.

        +

        Note on building Xapian for older CPUs: The build + configurations for Xapian releases 1.0.21 and 1.2.1 or newer enable the use + of SSE2 floating point instructions. These instructions are not available + in CPUs older than Intel Pentium 4 or AMD Athlon 64. When building for such + a CPU, you need to add the --disable-sse flag to the Xapian library + configure command. If this is not done, the problem signals itself by + "Illegal instruction" crashes (SIGILL) in recollindex and recoll.

        +
        • +
      • X11 development files.
        • +
      • zlib development files.
        • +

      • Qt development files: Qt 4.4 or newer. The Recoll GUI will not build + with Qt releases older than 4.4.

        +
        • +

      • Qt webkit development: Qt WebKit is quite often distributed apart from + the main Qt lib. It is possible to configure Recoll not to use Qt WebKit + (see configure --help).

        +
        • +
      • Python development package: you can avoid needing this by configuring + with --disable-python-module.
        • +
      -

    • Xapian core development libraries. Most Linux distributions - carry them in their package repository. Or you will find source and - binary packages on the - - Xapian download page.
      - Recoll should still work with Xapian 1.0, but it is highly - recommended to use a Xapian 1.2 version.

      +

      Source repository:

      -

      Note on building Xapian for older CPUs: The - build configurations for Xapian releases 1.0.21 and - 1.2.1 or newer enable the use of SSE2 floating point - instructions. These instructions are not available in CPUs - older than Intel Pentium 4 or AMD Athlon 64. When - building for such a CPU, you need to add the --disable-sse - flag to the Xapian library configure command. If this is - not done, the problem signals itself by "Illegal - instruction" crashes (SIGILL) in recollindex and recoll. -

      +

      The Recoll source repository is hosted on +bitbucket.org. The +trunk is usually a bit on the bleeding edge, but there is always a maintenance +branch for the current production version.

      -
      • +

      Older recoll releases:

      -
    • X11 development files.
      • +

      1.18.2. 1.18.1. 1.17.3. 1.16.2. 1.15.9. 1.14.4. 1.13.04. 1.12.4. 1.11.4. 1.10.6. 1.9.0. 1.8.2. 1.7.6. 1.6.3. 1.5.11. 1.4.3. 1.3.3. 1.2.3. 1.1.0. 1.0.16.

      -
    • zlib development files.
      • +

      Packages

      -

    • Qt development files: Qt 4.4 or newer. The Recoll GUI - will not build with Qt releases older than 4.4.

      • +

      Packages or ports for Recoll are available in the standard repositories for +many distributions.

      -

    • Qt webkit development: Qt WebKit is quite often - distributed apart from the main Qt lib. It is possible to - configure Recoll not to use Qt WebKit (see - configure --help).

      • +

      However they are often a bit older or built with older Xapian releases. Here +follow a number of updated packages and instructions for a number of +distributions.

      -
    • Python development package: you can avoid needing this by - configuring with --disable-python-module.
      • +

      All binary packages on this page need a Qt 4 (4.4 at least) runtime +environment. To make things easier, on systems where Xapian is not available +from the standard package repositories, the Recoll package will have a static +link to Xapian so that you do not need to build/install it separately.

      -
    +

    Debian

    -

    Source repository:

    -

    The Recoll source repository is - hosted on - bitbucket.org. - The trunk is usually a bit on the bleeding edge, but there is - always a maintenance branch for the current production version.

    +

    The Debian Recoll packages are usually fairly up to date (at least in +testing), just use the appropriate Debian repository.

    -

    Older recoll releases:

    -

    - 1.18.1. - 1.17.3. - 1.16.2. - 1.15.9. - 1.14.4. - 1.13.04. - 1.12.4. - 1.11.4. - 1.10.6. - 1.9.0. - 1.8.2. - 1.7.6. - 1.6.3. - 1.5.11. - 1.4.3. - 1.3.3. - 1.2.3. - 1.1.0. - 1.0.16. -

    +

    Ubuntu

    -

    Packages

    - -

    Packages or ports for Recoll are available in the standard - repositories for many distributions.

    -

    However they are often a bit older or built with older Xapian - releases. Here follow a number of updated packages and - instructions for a number of distributions.

    -

    All binary packages on this page need a Qt 4 (4.4 at least) runtime - environment. To make things easier, on systems where Xapian is - not available from the standard package repositories, the - Recoll package will have a static link to Xapian so that you - do not need to build/install it separately.

    - -

    Debian

    - -

    The Debian Recoll packages are usually fairly up to date (at - least in testing), just use the appropriate Debian repository.

    - -

    Ubuntu

    - -

    There are Personal Package Archives on launchpad.net for - - Recoll, kio-recoll and recoll-lens. These were built from the - latest versions, for a set of Ubuntu series. starting at - Lucid. The installation is very simple: - 

    
+
    There are Personal Package Archives on launchpad.net for Recoll,
+kio-recoll and recoll-lens. These were built from the latest versions, for
+a set of Ubuntu series. starting at Lucid. The installation is very simple: 
    
+
    
           sudo add-apt-repository ppa:recoll-backports/recoll-1.15-on
           sudo apt-get update
           sudo apt-get install recoll
-          
    
+
    -

    Source code for the lens (also included in the main - recoll tar file):
    - For 1.18 installations: - recoll-lens-1.18.1.2997.tar.gz
    - For 1.17: - recoll-lens-1.17.2.2697.tar.gz

    +

    Source code for the lens (also included in the main recoll tar file):
    +For 1.19 installations: recoll-lens-1.19.0.3315.tar.gz
    +For 1.18: recoll-lens-1.18.1.2997.tar.gz
    +For 1.17: recoll-lens-1.17.2.2697.tar.gz

    -

    The packages in the standard repository and on the PPA - are a bit different in the sense that the Python extension - is included in the PPA package, but it's a separate - package in the standard repository. This can give rise to - errors about overwriting the Python module when switching - between versions. Typically, the error message would be - like the following:

    - - 
    
+
    The packages in the standard repository and on the PPA are a bit different
+in the sense that the Python extension is included in the PPA package, but it's
+a separate package in the standard repository. This can give rise to errors
+about overwriting the Python module when switching between versions. Typically,
+the error message would be like the following:
    
+
    
     ErrorMessage: trying to overwrite '/usr/lib/python2.7/dist-packages/recoll.so', which is also in package recoll 1.18.1-1~ppa1~quantal1
    
 
-      
    If this happens, you just need to delete
-        the previous package(s) before installing the other one(s)
-        instead of performing an upgrade.
    
-      
-      
    
-        
    Notes for Ubuntu Lucid
    
+
    If this happens, you just need to delete the previous package(s) before
+installing the other one(s) instead of performing an upgrade.
    
 
-        
      
+
      
+  
      Notes for Ubuntu Lucid
      
+  
        
+    
      • If you use Ubuntu 10.04 (Lucid), you will need to add the Xapian
+      backports PPA to provide the libxapian22 package
        • 
+    
      • The rclepub filter apparently needs Python
+      2.7. You will need to install it and modify the first line of the
+      filter script to execute python2.7 instead of
+    python.
        • 
+  
      
+
      
 
-          
    • Under lucid you will need to add the 
-          
-            Xapian backports PPA to provide the libxapian22
-          package
      • 
+
      Linux Mint
      
 
-          
    • The rclepub filter apparently needs Python
-          2.7. You will need to install it and modify the first
-            line of the filter script to execute python2.7
-            instead of python.
      • 
+
      The Ubuntu PPA works perfectly for Mint 13 (and probably other releases
+too). Just follow the instructions for Ubuntu.
      
 
-        
    
-      
    
+
    RPMS
    
 
-      
    Linux Mint
    
+
    You'll need to install the Xapian, Qt, Qt-Webkit and zlib development
+packages if you want use the source rpms.
    
 
-      
    The Ubuntu PPA works perfectly for Mint 13 (and probably
-        other releases too). Just follow the instructions for Ubuntu.
    
-        
-      
    RPMS
     
-      
    You'll need to install the Xapian, Qt, Qt-Webkit and zlib
-	development packages if you want use the source rpms.
    
-	  
-      
    Fedora
    
+
    Fedora
    
 
-      
    Recoll is present in the standard Fedora package repositories
-        starting from F-12. The new versions are tracked quite
-	closely, so I don't build the rpms any more (email me if you need
-	one).
     
+
    Recoll is present in the standard Fedora package repositories starting from
+F-12. The new versions are tracked quite closely, so I don't build the rpms any
+more (email me if you need one).
    
 
-      
    OpenSUSE
    
-      
    
-        
    Recoll is in the KDE:Extra repository
+
    OpenSUSE
    
 
-          
-        You just need to add the repository to your
-        software sources (Yast2->software->Software repositories).
    
-        
-          Repository list (supported Suse versions). After adding the
-          appropriate repository to your software sources, you will be
-          able to install recoll and kio_recoll from the software
-          management interface. The Xapian dependancy will also be
-          satisfied from the build service repository. Some of the older
-          repositories do not build antiword, just tell the software manager
-          to "break" recoll by installing anyway, and get antiword
-          somewhere else.
    
-      
    
+
    
+  
    Recoll is in the KDE:Extra repository You just need to add the repository to your software
+  sources (Yast2->software->Software repositories).
    
+  Repository
+  list (supported Suse versions). After adding the appropriate repository
+  to your software sources, you will be able to install recoll and kio_recoll
+  from the software management interface. The Xapian dependancy will also be
+  satisfied from the build service repository. Some of the older repositories
+  do not build antiword, just tell the software manager to "break" recoll by
+  installing anyway, and get antiword somewhere else.
    
+
    
 
-      
    Mageia
    
-      
    
+
    Mageia
    
 
-        
    Mageia version 2: 
-	  
-	    mageia2/recoll-1.18.1-1.mga2.i586.rpm,
-          
-            recoll-debug-1.18.1-1.mga2.i586.rpm. 
    
-	  Source: 
-	
-	  recoll-1.18.1-1.mga2.src.rpm
-        
    
-      
    
+
    
+  
    Mageia version 2: mageia2/recoll-1.18.1-1.mga2.i586.rpm,
+  recoll-debug-1.18.1-1.mga2.i586.rpm.
+  
    
+  Source: recoll-1.18.1-1.mga2.src.rpm
+  
    
+
    
 
-      
    Ports
     
+
    Ports
    
 
-      
    Mac port
    
+
    Mac port
    
 
-      
    It seems that Recoll will sometimes find data that Spotlight
-        misses (especially inside pdfs apparently, which is probably
-        more to the credit of poppler than recoll itself).
    
-      
    Recoll is in MacPorts and really easy to install:
    
-      
      
-        
    1. 
-            Install MacPorts.
      2. 
-        
    2. Type "sudo port install recoll"
      3. 
-      
    
+
    It seems that Recoll will sometimes find data that Spotlight misses
+(especially inside pdfs apparently, which is probably more to the credit of
+poppler than recoll itself).
    
 
-      
    Recoll is then available from the command line and as an icon in
-        the usual MacPorts applications place.
    
+
    Recoll is in MacPorts and really easy to install:
    
+
      
+  
    1. Install
+    MacPorts.
      2. 
+  
    2. Type "sudo port install recoll"
      3. 
+
    
 
-      
    Building on Solaris
    
-      
    I did not test building the GUI on Solaris for this version. You
-          will need at least Qt 4.4. The old hints
-          in the previous page may
-          still be valid.
    
-        
    Someone did test the indexer and Python module build, they
-          do work, with a few minor glitches. Be sure to use
-          GNU make and install.
    
+
    Recoll is then available from the command line and as an icon in the usual
+MacPorts applications place.
    
 
-      
    Translations
    
+
    Building on Solaris
    
 
-      
    Most of the translations for 1.18 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 me and earn
-	my gratefulness (and your less multilingual
-	compatriot's)...
    
+
    I did not test building the GUI on Solaris for this version. You will need
+at least Qt 4.4. The old hints in the previous
+page may still be valid.
    
 
-      
    You can use the .ts file to alter the translations if you
-	wish (use Qt's linguist tool to edit the source file,
-	then lrelease to produce the .qm file.).
-	The .qm file should be copied to 
-	/usr/[local/]share/recoll/translations
-      
    
+
    Someone did test the indexer and Python module build, they do work, with a
+few minor glitches. Be sure to use GNU make and install.
    
 
-      
    recoll_xx.ts is a blank
-	Recoll 1.18 message file, handy to work on a new translation.
    
+
    Translations
    
 
-      
    A Czech translation for 1.18, thanks to Pavel
-	recoll_cs.ts
-	recoll_cs.qm
-      
    
+
    Most of the translations for 1.19 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 me and earn my gratefulness
+(and your less multilingual compatriot's)...
    
 
+
    You can use the .ts file to alter the translations if you wish (use
+Qt's linguist tool to edit the source file, then lrelease to
+produce the .qm file.). The .qmfile should be
+copied to /usr/[local/]share/recoll/translations
+
    
+
+
    recoll_xx.ts is a blank Recoll 1.19
+message file, handy to work on a new translation.
    
 
-      
    Note that, if you are running an older release,
-        you may find updated messages by looking inside the
-        appropriate maintenance branch
-        on bitbucket.
    
 
-
-
    - +

    Note that, if you are running an older release, you may find updated +messages by looking inside the appropriate maintenance branch on bitbucket.

    +
    + diff --git a/website/index.html.en b/website/index.html.en index d2ea08a1..f8f18bd8 100644 --- a/website/index.html.en +++ b/website/index.html.en @@ -52,8 +52,8 @@
  • Detailed features.

    The current Recoll version is - 1.18.2 - (Release notes, + 1.19.0 + (Release notes, known bugs).

    Recoll is based on the very @@ -87,12 +87,9 @@

    -
    2013-04-30
    Recoll 1.19.0 will soon be out, and as - usual, there is a pre-release source tarfile for - adventurous souls who would be willing to test and - help the release to be as close to flawless as - possible. The tar file and the - the release notes. +
    2013-05-12
    Recoll 1.19.0 is out. See the + release notes for a description + of the changes.
    2013-04-30
    Thanks to some of its users, Recoll now diff --git a/website/index.html.fr b/website/index.html.fr index bbd07799..80c96a30 100644 --- a/website/index.html.fr +++ b/website/index.html.fr @@ -48,8 +48,8 @@

    Recoll est un logiciel libre gratuit, dont le code source est disponible sous licence GPL. La dernière version est - 1.18.2 - (notes sur la version, en + 1.19.0 + (notes sur la version, en anglais)

    L'interface utilisateur de @@ -102,9 +102,7 @@

    Nouvelles:

    -
    2013-04-14
    Release 1.18.2 corrige quelques - problèmes mineurs de la version - 1.18.1. Elle ne sera pas distribuée sous forme binaire.
    +
    2013-05-12
    La version 1.19.0 est disponible.
    2012-11-05
    Recoll 1.18.1 est disponible. Cette version peut faire des recherches sensibles aux majuscules et diff --git a/website/release-1.19.html b/website/release-1.19.html index b5e80eb7..f008269a 100644 --- a/website/release-1.19.html +++ b/website/release-1.19.html @@ -1,240 +1,173 @@ - - Recoll 1.19 series release notes + + Recoll 1.19 series release notes + + + + + + + + - - - - - - - + - - +
    + +
    - - -
    - -
    - -
    +
    +

    Release notes for Recoll 1.19.x

    -

    Release notes for Recoll 1.19.x

    +

    Caveats

    +

    Installing over an older version: 1.19

    -

    Caveats

    +

    Case/diacritics sensitivity is still off by default for this release. It can +be turned on only by editing recoll.conf (see the manual). +If you do so, you must then reset the index.

    -

    Installing over an older version: 1.19 -

    +

    Always reset the index if you do not know by which version it was created +(you're not sure it's 1.18). The simplest way to do this is to quit all Recoll +programs and just delete the index directory (rm -rf ~/.recoll/xapiandb), then start +recoll or recollindex.
    +recollindex -z  will do the same in most, but +not all, cases. It's better to use the rm method, which will also +ensure that no debris from older releases remain (e.g.: old stemming files +which are not used any more).

    -

    Case/diacritics sensitivity is still off by default for this - release. It can be turned on only by editing recoll.conf - ( - see the manual). If you do so, you must then reset the index.

    +

    Installing 1.19 over an 1.18 index will force a lot of reindexing anyway +because Recoll switched to using st_ctime instead of st_mtime to +detect file modifications, meaning that all files which were modified since +created will be updated.

    -

    Always reset the index if you do not know by which version it - was created (you're not sure it's 1.18). The simplest way to - do this is to quit all recoll programs and just delete the - index directory - (rm -rf ~/.recoll/xapiandb), - then start recoll or recollindex.
    - recollindex -z  will do - the same in most, but not all, cases. It's better to use - the rm method, which will also ensure that no debris - from older releases remain (e.g.: old stemming files which are - not used any more).

    +

    Viewer exceptions: as in 1.18 (but we kept +this section for 1.17 users), there is a list of mime types that should be +opened with the locally configured application even when Use Desktop +Preferences is checked. This allows making use of new functions (direct +access to page), which could not be available through the desktop's +xdg-open. The default list contains PDF, Postscript and DVI, which +should be opened with the evince (or atril for Mint/MATE +users) viewer for the page access functions to work. If you want to keep the +previous behaviour (losing the page number functionality), you need to prune +the list after installation . This can be done from the Preferences->Gui +Configuration menu.

    -

    Installing 1.19 over an 1.18 index will force a lot of - reindexing anyway because Recoll switched from using st_ctime - instead of st_mtime to detect file modifications, meaning that - all files which were modified since created will be - updated.

    - -

    Viewer exceptions: as in 1.18 - (but we kept this section for 1.17 users), - there is a list of mime types that should be opened with - the locally configured application even when Use - Desktop Preferences is checked. This allows making - use of new functions (direct access to page), which could not - be available through the desktop's xdg-open. The - default list contains PDF, Postscript and DVI, which should be - opened with the evince (or atril for - Mint/MATE users) viewer for the page access functions to - work. If you want to keep the previous behaviour (losing the - page number functionality), you need to prune the list after - installation . This can be done from the Preferences->Gui - Configuration menu.

    - -

    Changes in Recoll 1.19.0

    - -
      - -
    • Indexing can use multiple threads. This can be a - major performance boost for people with multiprocessor - machines and big indexes. The threads setup is - roughly auto-configured when recollindex starts, based on - the number of processors, but it is also possible to taylor - it in the configuration. Here are some - - notes about the transformation and the performance - improvements. There is also a - - section in the manual to describe the configuration. -
      • - -
    • There is a new result list/table popup menu option to - display all the sub-documents for a given one. This is - mostly useful to display the attachments to an email. The - resulting screen can be used to save a multiple selection of - the entries to files.
      • - -
    • It is now possible to use OR with "dir:" clauses, and - wildcards have been enabled.
      • - -
    • When the option to follow symbolic links is not set - -which is the default- symbolic links are now indexed as - such (name and content).
      • - -
    • There are new GUI configuration options to run in "search - as you type" mode (which I don't find useful at all...), and - to disable the Qt auto-completion inside the simple search - string. The completion was often more confusing and ennoying than - useful, especially because it is case-insensitive when case - sometimes matter for Recoll searches (capitalization to - disable stemming).
      • - -
    • When the option to collapse identical results is used, - documents which do have duplicates are shown with a - link to list the clones. This function needs new data from - the index, so it will only completely work after a full 1.19 - reindex.
      • - -
    • Recoll should now behave reasonably on video files: index - the name and propose an Open button in the result list to - start the configured player.
      • - -
    • Thanks to Recoll - user Koniu, you can now - access your Recoll indexes through a Web - browser interface. The server side is based on - the Bottle Python - Web framework and the Recoll Python module, and can run - self-contained (no necessity to run apache or another web - server), so it's quite simple to set up. See: - See the - Recoll WebUI project on GitHub.
      • - -
    • Thanks to Recoll user David, there is now a filter to - index and retrieve Lotus Notes messages. See the - software - - site on sourceforge and some - - notes from a user with a slightly different - configuration.
      • - -
    • There is a new path translation facility, with a GUI - interface, to make it easier to share an index from a network - share on clients on which the mount points might be - different. This could also probably be put to use to design - a "portable index" feature (for removable media).
      • - -
    • The first indexing run after Recoll installation (for a new - user) will run in a fashion which will put data likely to be - useful into the index faster, so that an impatient user can - more quickly try searches.
      • - -
    • Implemented cache for last file uncompressed. This will - much improve usage, e.g. for people fetching successive - messages from a compressed mail folder.
      • - -
    • Recollindex will now change its current directory to a - temporary one (e.g. /tmp) to mitigate the problems of some - filters creating temporary files and not cleaning them.
      • - -
    • There is a new recursive reindex option to command line - indexer.
      • - -
    • The default result list paragraph format has been slightly - tweaked (removed the relevance percentage and small ordering - and formatting changes).
      • - -
    • Mime type wildcard expansion is now performed against the - index, not the configuration. This fixes many problems when - searching for, e.g., media files indexed only by name.
      • - -
    • The choice for case/diacritics sensitivity is now fully - processed during wildcard expansion (for case-sensitive - indexes).
      • - -
    • The Snippets popup (list of pages and excerpts typically - produced for PDF documents) can now use an external - CSS stylesheet. This is useful because the Qt Webkit - objects do not fully inherit the Qt configuration so that, - for example, a style sheet is needed for using - a different background color. The style sheet is chosen - from the Preferences->GUI configuration->Result - list panel.
      • - -
    • Improved handling of filters during indexing resulting in - less subprocesses.
      • - -
    • Added function to import tags from external application - (e.g. Tmsu).
      • - -
    • Changed format for rclaptg field. Was colon-separated, - now uses normal value/attributes syntax with an empty value - like: - 
      -            localfields = ; attr1 = val1 ; attr2 = val2
-
      -
      • - -
    • Extended file attributes are now indexed by default. As a - side effect, recoll now uses st_ctime, not st_mtime to detect - file changes. This means that installing 1.19 will reindex - many files (all those that were modified since created). - Recoll now processes the charset - and mime_type standardized extended attributes.
      • - -
    • The Python module has been expanded to include the - interface for extracting data. This means that you could now - write most of the Recoll GUI in Python if you wished. There - is - a bit - of sample code in the source package doing just this. A - few incompatible changes had to be made to the Python - module. Especially the "Query.next" field is gone and the - module structure has been changed (different import - statement needed). Adapting your code is trivial, have a - look at the changes in - the Unity - Lens module for an example. The new module is compatible - with - the Python - Database API Specification v2.0 for the parts that make - sense for a non-relational DB.
      • - -
    • Recoll now uses a dynamic library for the code shared by - the query interface, the indexer and the Python - module. This should have no visible impact but was rendered - necessary by the Python module evolutions.
      • - -
    • And quite a few Fixed bugs
      • - -
    - - -
    - +

    Changes in Recoll 1.19.0

    +
      +
    • Indexing can use multiple threads. This can be a major performance boost + for people with multiprocessor machines and big indexes. The threads setup + is roughly auto-configured when recollindex starts, based on the number of + processors, but it is also possible to taylor it in the configuration.There + is a section + in the manual to describe the configuration, and also some notes about + the transformation and the performance improvements.
      • +
    • There is a new result list/table popup menu option to display all the + sub-documents for a given one. This is mostly useful to display the + attachments to an email. The resulting screen can be used to select + multiple entries and save them to files.
      • +
    • It is now possible to use OR with "dir:" clauses, and wildcards have been + enabled.
      • +
    • When the option to follow symbolic links is not set -which is the + default- symbolic links are now indexed as such (name and content).
      • +
    • There are new GUI configuration options to run in "search as you type" + mode (which I don't find useful at all...), and to disable the Qt + auto-completion inside the simple search string. The completion was often + more confusing and ennoying than useful, especially because it is + case-insensitive when case sometimes matter for Recoll searches + (capitalization to disable stemming).
      • +
    • When the option to collapse identical results is used, documents which do + have duplicates are shown with a link to list the clones. This function + needs new data from the index, so it will only completely work after a full + 1.19 reindex.
      • +
    • Recoll should now behave reasonably on video files: index the name and + propose an Open button in the result list to start the configured + player.
      • +
    • Thanks to Recoll user Koniu, you + can now access your Recoll indexes through a Web browser interface. The + server side is based on the Bottle + Python Web framework and the Recoll Python module, and can run + self-contained (no necessity to run apache or another web server), so it's + quite simple to set up. See: See the Recoll WebUI project on + GitHub.
      • +
    • Thanks to Recoll user David, there is now a filter to index and retrieve + Lotus Notes messages. See the software site on + sourceforge and some notes + from a user with a slightly different configuration.
      • +
    • There is a new path translation facility, with a GUI interface, to make + it easier to share an index from a network share on clients on which the + mount points might be different. This could also probably be put to use to + design a "portable index" feature (for removable media).
      • +
    • The first indexing run after Recoll installation (for a new user) will + run in a fashion which will put data likely to be useful into the index + faster, so that an impatient user can more quickly try searches.
      • +
    • Implemented cache for last file uncompressed. This will much improve + usage, e.g. for people fetching successive messages from a compressed mail + folder.
      • +
    • Recollindex will now change its current directory to a temporary one + (e.g. /tmp) to mitigate the problems of some filters creating temporary + files and not cleaning them.
      • +
    • There is a new recursive explicit reindex option to the command line + indexer.
      • +
    • The default result list paragraph format has been slightly tweaked + (removed the relevance percentage and small ordering and formatting + changes).
      • +
    • Mime type wildcard expansion is now performed against the index, not the + configuration. This fixes many problems when searching for, e.g., media + files indexed only by name.
      • +
    • The choice for case/diacritics sensitivity is now fully processed during + wildcard expansion (for case-sensitive indexes).
      • +
    • The Snippets popup (list of pages and excerpts typically produced for PDF + documents) can now use an external CSS stylesheet. This is useful because + the Qt Webkit objects do not fully inherit the Qt configuration so that, + for example, a style sheet is needed for using a different background + color. The style sheet is chosen from the Preferences->GUI + configuration->Result list panel.
      • +
    • Improved handling of filters during indexing resulting in less + subprocesses.
      • +
    • Added function to import tags from external application (e.g. Tmsu).
      • +
    • Changed format for rclaptg field. Was colon-separated, now uses normal + value/attributes syntax with an empty value like: + 
                  localfields = ; attr1 = val1 ; attr2 = val2
+
      +
      • +
    • Extended file attributes are now indexed by default. As a side effect, + recoll now uses st_ctime, not st_mtime to detect file changes. This means + that installing 1.19 will reindex many files (all those that were modified + since created). Recoll also now processes the charset and + mime_type standardized extended attributes.
      • +
    • The Python module has been expanded to include the interface for + extracting data. This means that you could now write most of the Recoll GUI + in Python if you wished. There is a bit + of sample code in the source package doing just this. A few + incompatible changes had to be made to the Python module. Especially the + "Query.next" field is gone and the module structure has been changed + (different import statement needed). Adapting your code is trivial, have a + look at the changes in the Unity + Lens module for an example. The new module is compatible with the Python Database API + Specification v2.0 for the parts that make sense for a non-relational + DB.
      • +
    • Recoll now uses a dynamic library for the code shared by the query + interface, the indexer and the Python module. This should have no visible + impact but was rendered necessary by the Python module evolutions.
      • +
    • And quite a few Fixed bugs
      • +
    +
    +