2
2
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
3
<html xmlns="http://www.w3.org/1999/xhtml">
5
<meta name="generator" content="HTML Tidy, see www.w3.org" />
5
<meta name="generator" content=
6
"HTML Tidy for FreeBSD (vers 7 December 2008), see www.w3.org" />
6
7
<title>Recoll user manual</title>
7
8
<meta name="GENERATOR" content="Modular DocBook HTML Stylesheet Version 1.79" />
8
9
<link rel="NEXT" title="Introduction" href="rcl.introduction.html" />
9
10
<link rel="STYLESHEET" type="text/css" href="docbook.css" />
10
11
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
12
<body class="BOOK" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#840084"
14
<div class="BOOK"><a id="AEN1" name="AEN1"></a>
13
<body class="BOOK" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#840084" alink=
15
<div class="BOOK"><a name="AEN1" id="AEN1"></a>
15
16
<div class="TITLEPAGE">
16
<h1 class="TITLE"><a id="AEN2" name="AEN2">Recoll user manual</a></h1>
18
<h3 class="AUTHOR"><a id="AEN4" name="AEN4"></a>Jean-Francois Dockes</h3>
17
<h1 class="TITLE"><a name="AEN2" id="AEN2">Recoll user manual</a></h1>
18
<h3 class="AUTHOR"><a name="AEN4" id="AEN4"></a>Jean-Francois Dockes</h3>
20
19
<div class="AFFILIATION">
21
20
<div class="ADDRESS">
22
<p class="ADDRESS"><code class="EMAIL"><<a
23
href="mailto:jfd@recoll.org">jfd@recoll.org</a>></code></p>
27
<p class="COPYRIGHT">Copyright © 2005-2011 Jean-Francois Dockes</p>
21
<p class="ADDRESS"><code class="EMAIL"><<a href=
22
"mailto:jfd@recoll.org">jfd@recoll.org</a>></code></p>
25
<p class="COPYRIGHT">Copyright � 2005-2012 Jean-Francois Dockes</p>
30
<div class="ABSTRACT"><a id="AEN14" name="AEN14"></a>
27
<div class="ABSTRACT"><a name="AEN13" id="AEN13"></a>
31
28
<p>This document introduces full text search notions and describes the installation and
32
use of the <b class="APPLICATION">Recoll</b> application. It currently describes <b
33
class="APPLICATION">Recoll</b> 1.16.</p>
37
<div class="DOCFORAMTNAVI">[ <a href="./index.html">Split HTML</a> / <a
38
href="./book.html">Single HTML</a> ]</div>
29
use of the <b class="APPLICATION">Recoll</b> application. It currently describes
30
<b class="APPLICATION">Recoll</b> 1.17.</p>
33
<div class="DOCFORAMTNAVI">[ <a href="./index.html">Split HTML</a> / <a href=
34
"./book.html">Single HTML</a> ]</div>
45
38
<dt><b>Table of Contents</b></dt>
47
39
<dt>1. <a href="rcl.introduction.html">Introduction</a></dt>
51
42
<dt>1.1. <a href="rcl.introduction.html#RCL.INTRODUCTION.TRYIT">Giving it a try</a></dt>
53
43
<dt>1.2. <a href="rcl.introduction.search.html">Full text search</a></dt>
55
44
<dt>1.3. <a href="rcl.introduction.recoll.html">Recoll overview</a></dt>
59
47
<dt>2. <a href="rcl.indexing.html">Indexing</a></dt>
63
50
<dt>2.1. <a href="rcl.indexing.html#RCL.INDEXING.INTRODUCTION">Introduction</a></dt>
65
51
<dt>2.2. <a href="rcl.indexing.storage.html">Index storage</a></dt>
69
54
<dt>2.2.1. <a href="rcl.indexing.storage.html#RCL.INDEXING.STORAGE.FORMAT">Xapian index
72
56
<dt>2.2.2. <a href="rcl.indexing.storage.html#RCL.INDEXING.STORAGE.SECURITY">Security
77
60
<dt>2.3. <a href="rcl.indexing.config.html">Indexing configuration</a></dt>
81
63
<dt>2.3.1. <a href="rcl.indexing.config.html#RCL.INDEXING.CONFIG.GUI">The indexing
82
64
configuration GUI</a></dt>
86
67
<dt>2.4. <a href="rcl.indexing.beaglequeue.html">Using Beagle WEB browser
89
69
<dt>2.5. <a href="rcl.indexing.periodic.html">Periodic indexing</a></dt>
93
72
<dt>2.5.1. <a href="rcl.indexing.periodic.html#RCL.INDEXING.PERIODIC.EXEC">Running
96
<dt>2.5.2. <a href="rcl.indexing.periodic.html#RCL.INDEXING.PERIODIC.AUTOMAT">Using <tt
97
class="COMMAND">cron</tt> to automate indexing</a></dt>
74
<dt>2.5.2. <a href="rcl.indexing.periodic.html#RCL.INDEXING.PERIODIC.AUTOMAT">Using
75
<tt class="COMMAND">cron</tt> to automate indexing</a></dt>
101
78
<dt>2.6. <a href="rcl.indexing.monitor.html">Real time indexing</a></dt>
105
81
<dt>2.6.1. <a href="rcl.indexing.monitor.html#RCL.INDEXING.MONITOR.FASTFILES">Slowing
112
87
<dt>3. <a href="rcl.search.html">Searching</a></dt>
116
90
<dt>3.1. <a href="rcl.search.html#RCL.SEARCH.GUI">Searching with the Qt graphical user
117
91
interface</a></dt>
121
94
<dt>3.1.1. <a href="rcl.search.html#RCL.SEARCH.SIMPLE">Simple search</a></dt>
123
95
<dt>3.1.2. <a href="rcl.search.html#RCL.SEARCH.RESLIST">The default result list</a></dt>
125
96
<dt>3.1.3. <a href="rcl.search.html#RCL.SEARCH.RESTABLE">The result table</a></dt>
127
97
<dt>3.1.4. <a href="rcl.search.html#RCL.SEARCH.PREVIEW">The preview window</a></dt>
129
98
<dt>3.1.5. <a href="rcl.search.html#RCL.SEARCH.COMPLEX">Complex/advanced search</a></dt>
131
99
<dt>3.1.6. <a href="rcl.search.html#RCL.SEARCH.TERMEXPLORER">The term explorer
134
101
<dt>3.1.7. <a href="rcl.search.html#RCL.SEARCH.MULTIDB">Multiple databases</a></dt>
136
102
<dt>3.1.8. <a href="rcl.search.html#RCL.SEARCH.HISTORY">Document history</a></dt>
138
103
<dt>3.1.9. <a href="rcl.search.html#RCL.SEARCH.SORT">Sorting search results and
139
104
collapsing duplicates</a></dt>
141
105
<dt>3.1.10. <a href="rcl.search.html#RCL.SEARCH.TIPS">Search tips, shortcuts</a></dt>
143
106
<dt>3.1.11. <a href="rcl.search.html#RCL.SEARCH.CUSTOM">Customizing the search
144
107
interface</a></dt>
148
110
<dt>3.2. <a href="rcl.searchkio.html">Searching with the KDE KIO slave</a></dt>
152
113
<dt>3.2.1. <a href="rcl.searchkio.html#RCL.SEARCHKIO.INTRO">What's this</a></dt>
154
114
<dt>3.2.2. <a href="rcl.searchkio.html#RCL.SEARCHKIO.SEARCHABLEDOCS">Searchable
155
115
documents</a></dt>
159
118
<dt>3.3. <a href="rcl.search.commandline.html">Searching on the command line</a></dt>
161
119
<dt>3.4. <a href="rcl.search.lang.html">The query language</a></dt>
165
<dt>3.4.1. <a href="rcl.search.lang.html#AEN1130">Modifiers</a></dt>
122
<dt>3.4.1. <a href="rcl.search.lang.html#RCL.SEARCH.LANG.MODIFIERS">Modifiers</a></dt>
169
125
<dt>3.5. <a href="rcl.search.anchorwild.html">Anchored searches and wildcards</a></dt>
173
128
<dt>3.5.1. <a href="rcl.search.anchorwild.html#RCL.SEARCH.WILDCARDS">More about
174
129
wildcards</a></dt>
176
130
<dt>3.5.2. <a href="rcl.search.anchorwild.html#RCL.SEARCH.ANCHOR">Anchored
177
131
searches</a></dt>
181
134
<dt>3.6. <a href="rcl.search.desktop.html">Desktop integration</a></dt>
185
137
<dt>3.6.1. <a href="rcl.search.desktop.html#RCL.SEARCH.SHORTCUT">Hotkeying
188
139
<dt>3.6.2. <a href="rcl.search.desktop.html#RCL.KICKER-APPLET">The KDE Kicker Recoll
195
145
<dt>4. <a href="rcl.program.html">Programming interface</a></dt>
199
148
<dt>4.1. <a href="rcl.program.html#RCL.PROGRAM.FILTERS">Writing a document
204
<dt>4.1.1. <a href="rcl.program.html#RCL.PROGRAM.FILTERS.HTML">Filter HTML
152
<dt>4.1.1. <a href="rcl.program.html#RCL.PROGRAM.FILTERS.SIMPLE">Simple filters</a></dt>
153
<dt>4.1.2. <a href="rcl.program.html#RCL.PROGRAM.FILTERS.ASSOCIATION">Telling <b class=
154
"APPLICATION">Recoll</b> about the filter</a></dt>
155
<dt>4.1.3. <a href="rcl.program.html#RCL.PROGRAM.FILTERS.HTML">Filter HTML
209
159
<dt>4.2. <a href="rcl.program.fields.html">Field data processing</a></dt>
211
160
<dt>4.3. <a href="rcl.program.api.html">API</a></dt>
215
163
<dt>4.3.1. <a href="rcl.program.api.html#RCL.PROGRAM.API.ELEMENTS">Interface
216
164
elements</a></dt>
218
165
<dt>4.3.2. <a href="rcl.program.api.html#RCL.PROGRAM.API.PYTHON">Python
219
166
interface</a></dt>
225
171
<dt>5. <a href="rcl.install.html">Installation and configuration</a></dt>
229
174
<dt>5.1. <a href="rcl.install.html#RCL.INSTALL.BINARY">Installing a binary copy</a></dt>
233
177
<dt>5.1.1. <a href="rcl.install.html#RCL.INSTALL.BINARY.PACKAGE">Installing through a
234
178
package system</a></dt>
236
<dt>5.1.2. <a href="rcl.install.html#RCL.INSTALL.BINARY.RCL">Installing a prebuilt <b
237
class="APPLICATION">Recoll</b></a></dt>
179
<dt>5.1.2. <a href="rcl.install.html#RCL.INSTALL.BINARY.RCL">Installing a prebuilt
180
<b class="APPLICATION">Recoll</b></a></dt>
241
183
<dt>5.2. <a href="rcl.install.external.html">Supporting packages</a></dt>
243
184
<dt>5.3. <a href="rcl.install.building.html">Building from source</a></dt>
248
href="rcl.install.building.html#RCL.INSTALL.BUILDING.PREREQS">Prerequisites</a></dt>
251
href="rcl.install.building.html#RCL.INSTALL.BUILDING.BUILD">Building</a></dt>
254
href="rcl.install.building.html#RCL.INSTALL.BUILDING.INSTALL">Installation</a></dt>
188
"rcl.install.building.html#RCL.INSTALL.BUILDING.PREREQS">Prerequisites</a></dt>
190
"rcl.install.building.html#RCL.INSTALL.BUILDING.BUILD">Building</a></dt>
192
"rcl.install.building.html#RCL.INSTALL.BUILDING.INSTALL">Installation</a></dt>
258
195
<dt>5.4. <a href="rcl.install.config.html">Configuration overview</a></dt>
262
198
<dt>5.4.1. <a href="rcl.install.config.html#RCL.INSTALL.CONFIG.RECOLLCONF">Main
263
199
configuration file</a></dt>
265
200
<dt>5.4.2. <a href="rcl.install.config.html#RCL.INSTALL.CONFIG.FIELDS">The fields
268
202
<dt>5.4.3. <a href="rcl.install.config.html#RCL.INSTALL.CONFIG.MIMEMAP">The mimemap
271
204
<dt>5.4.4. <a href="rcl.install.config.html#RCL.INSTALL.CONFIG.MIMECONF">The mimeconf
274
206
<dt>5.4.5. <a href="rcl.install.config.html#RCL.INSTALL.CONFIG.MIMEVIEW">The mimeview
277
208
<dt>5.4.6. <a href="rcl.install.config.html#RCL.INSTALL.CONFIG.EXAMPLES">Examples of
278
209
configuration adjustments</a></dt>
287
217
<div class="NAVFOOTER">
288
<hr align="LEFT" width="100%" />
218
<hr align="left" width="100%" />
289
219
<table summary="Footer navigation table" width="100%" border="0" cellpadding="0"
292
<td width="33%" align="left" valign="top"> </td>
293
<td width="34%" align="center" valign="top"> </td>
294
<td width="33%" align="right" valign="top"><a href="rcl.introduction.html"
295
accesskey="N">Next</a></td>
222
<td width="33%" align="left" valign="top">�</td>
223
<td width="34%" align="center" valign="top">�</td>
224
<td width="33%" align="right" valign="top"><a href="rcl.introduction.html" accesskey=
299
<td width="33%" align="left" valign="top"> </td>
300
<td width="34%" align="center" valign="top"> </td>
228
<td width="33%" align="left" valign="top">�</td>
229
<td width="34%" align="center" valign="top">�</td>
301
230
<td width="33%" align="right" valign="top">Introduction</td>