X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=plocate-build.8;h=00e3899f21847d1b72503f8f0b9ee9fd3e1142e6;hb=HEAD;hp=f92def5b5ea4b4530b1cc76f9c0ff24e9db2a95b;hpb=9cdb6c7988b2ab73a4536da1d8ec33d4083bb2d1;p=plocate diff --git a/plocate-build.8 b/plocate-build.8 index f92def5..00e3899 100644 --- a/plocate-build.8 +++ b/plocate-build.8 @@ -1,6 +1,6 @@ -.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 @@ -9,16 +9,18 @@ plocate-build \- generate index for plocate .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 @@ -47,6 +49,13 @@ Setting it to 1 makes one (compressed) block per filename. 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. @@ -61,4 +70,4 @@ Steinar H. Gunderson .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)