.\" $Id: recollq.1,v 1.1 2007-11-13 10:07:35 dockes Exp $ (C) 2005 J.F.Dockes\$
.TH RECOLLQ 1 "13 November 2007"
.SH NAME
recollq \- command line / standard output Recoll query command.
.SH SYNOPSIS
.B recollq
[
.B \-c
<configdir>
]
[
.B \-o
|
.B \-f
|
.B \-a
]
[
.B \-b
]
[
.B \-d
]
[
.B \-A
]
[
.B \-m
]
[
.B \-n
<cnt>
]
[
.B \-s
<stemming language>
]
[
.B \-S
<fldname>
]
[
.B \-D
]
[
.B \-i
<additional index directory>
]
<query string>
.B recollq \-P
.SH DESCRIPTION
The
.B recollq
command will execute the Recoll query specified on the command line and
print the results to the standard output.
.PP
The
.B \-c
option specifies the configuration directory name, overriding the
default or $RECOLL_CONFDIR.
.PP
The query string will be interpreted by default as a query language string.
If
.B \-a
is specified, the query string will be interpreted as an
.I all words
simple search query. If
.B \-o
is specified, the query string will be interpreted as an
.I any word
simple search query. If
.B \-f
is specified, the query string will be interpreted as a
.I file name
simple search query.
.PP
.B \-b
(basic) can be specified to only print the result urls in the output
stream.
.PP
If
.B \-d
is set, the text for the result files contents will be dumped to stdout.
.PP
If
.B \-m
is set, the whole metadata array will be dumped for each document.
.PP
If
.B \-A
is set, the document abstracts will be printed.
.PP
.B \-S
<fieldname>
sorts the results according to the specified field. Use
.B \-D
for descending order.
.PP
.B \-n
<cnt>
can be used to set the maximum number of results that should be printed.
.PP
.B \-s
<language>
selects the word stemming language. The value should match an existing
stemming database (as set in the configuration or added with recollindex \-s).
.PP
.B \-i
<extra dbdir>
adds the specified Xapian index to the set used for the query. Can be
specified multiple times.
.PP
.B recollq \-P
(Period) will print the minimum and maximum modification years for
documents in the index.
.SH SEE ALSO
.PP
recollindex(1) recollq(1) recoll.conf(5)