-.TH plocate-build 8 "Oct 2020" plocate-build
+.TH plocate\-build 8 "Oct 2020" plocate\-build
.SH NAME
-plocate-build \- generate index for plocate
+plocate\-build \- generate index for plocate
.SH SYNOPSIS
.B plocate-build
.I "PLOCATE_DB"
.SH DESCRIPTION
-.B plocate-build
+.B plocate\-build
creates an index from
.BR plocate (1)
from an index earlier generated by
-.BR updatedb (1)
+.BR updatedb (8)
from the
.BR mlocate (1)
-package. This is currently the only way to build such an index.
+package. Most users would rather want to use plocate's own
+.BR updatedb (8),
+which is more direct.
If
-.I MLOCATE_DB
+.I PLOCATE_DB
already exists, it will be overwritten (non-atomically). The file is
created such that it is not world-readable, as the final access check
is done by
reducing overall performance for typical queries. The default value is 32.
Setting it to 1 makes one (compressed) block per filename.
+.TP
+\fB\-p\fR, \fB\-\-plaintext\fR
+Treat the input as plain text, with entries delimited by newlines,
+instead of an mlocate database.
+
+.TP
+\fB\-l\fR, \fB\-\-require\-visibility\fR \fIFLAG\fR
+Set the \*(lqrequire file visibility before reporting it\*(rq flag in the
+generated database to \fIFLAG\fR. The default is yes, even for an mlocate
+database with the flag originally set to no (although the latter may
+change in the future).
+
.TP
.B \-\-help
Print out usage information, then exit successfully.
.SH SEE ALSO
\fBplocate\fP(1),
\fB/etc/cron.daily/plocate\fR (which is called
-\fBupdate-plocate.sh\fR in the source distribution)
+\fBupdate\-plocate.sh\fR in the source distribution)