.TP
\fB\-d\fR, \fB\-\-database\fR \fIDBPATH\fR
-Find matches in \fB/var/lib/mlocate/plocate.db\fR, instead of the given database.
-(
-.B plocate
-does not currently support multiple databases.)
+Find matches in the given database, instead of \fB/var/lib/plocate/plocate.db\fR.
+This argument can be given multiple times, to search multiple databases.
+It is also possible to give multiple databases in one argument, separated by
+.BR : .
+(Any character, including : and \\, can be escaped by prepending a \\.)
+
+.TP
+\fB\-e\fR, \fB\-\-existing\fR
+Print only entries that refer to files existing at the time
+.B locate
+is run. Note that unlike
+.BR mlocate (1),
+symlinks are not followed by default (and indeed, there is no option
+to change this).
.TP
\fB\-i\fR, \fB\-\-ignore\-case\fR
.B \-\-count
is given, the number printed out will be at most \fILIMIT\fR.
+.TP
+\fB\-N\fR, \fB\-\-literal\fR
+Print entry names without quoting. Normally,
+.B plocate
+will escape special characters in filenames, so that they are safe for
+consumption by typical shells (similar to the GNU coreutils
+.I shell-escape-always
+quoting style), unless printing to a pipe, but this options will
+turn off such quoting.
+
.TP
\fB\-0\fR, \fB\-\-null\fR
Instead of writing a newline after every match, write a NUL
.B \-\-version
Print out version information, then exit successfully.
+.SH ENVIRONMENT
+
+.TP
+\fBLOCATE_PATH\fR
+If given, appended after the list of \fB\-\-database\fR paths
+(whether an explicit is given or the default is used).
+Colon-delimiting and character escaping follows the same rules
+as for \fB\-\-database\fR.
+
.SH AUTHOR
Steinar H. Gunderson <steinar+plocate@gunderson.no>
projects / plocate / blobdiff