Put the database file in sharedstatedir.

[plocate] / README

diff --git a/README b/README
index bae21703fdf73e8fe429bf429347df054722090a..75da95bf3695f796006756cc787a4ddfba931488 100644 (file)
--- a/README
+++ b/README
@@ -1,15 +1,45 @@
-plocate, a locate based on posting lists, consuming mlocate inputs
-and making a much faster index. Does not support querying by regex,
-case-insensitivity or really any options.
+plocate is a locate based on posting lists. Compared to mlocate,
+it is much faster, and its index is much smaller. updatedb speed
+is similar (or you can convert mlocate's index to plocate format
+using plocate-build). It supports most mlocate options;
+see --help or the man page (man -l plocate.1) for more information.

 
 

-Alpha stage; file format is subject to change. To build, run make.
+The file format may still change (if so, plocate will notify you itself
+that you need to rerun plocate-build or updatedb). To build and install,
+you will need a C++17 compiler and a development package for Zstd
+(https://facebook.github.io/zstd/). liburing (https://github.com/axboe/liburing)
+and a kernel supporting io_uring (Linux 5.1 or newer) is optional,
+but strongly recommended for best performance, especially if you
+do not have an SSD. Installation is run as:
+
+  meson obj
+  cd obj
+  ninja
+  sudo ninja install
+
+To build the database for the first time after install, you can do
+
+  sudo addgroup mlocate
+  sudo updatedb
+
+The initial run of updatedb needs to scan the entire filesystem.
+Subsequent runs of updatedb will be much faster, and create a slightly
+smaller (~5%) database.

 
 If you wish to run some tests of the TurboPFor implementation against
 
 If you wish to run some tests of the TurboPFor implementation against

-the reference implementation, you can run:
+the reference implementation, you can check it out and run as follows:

 
   git clone https://github.com/powturbo/TurboPFor-Integer-Compression
 
   git clone https://github.com/powturbo/TurboPFor-Integer-Compression

-  make -j8 bench
+  ( cd TurboPFor-Integer-Compression && make -j8 )
+  cd obj
+  ninja reconfigure
+  ninja bench

 
 

-Copyright 2020 Steinar H. Gunderson <steinar+git@gunderson.no>.
+plocate (except updatedb), and the plocate-specific changes to updatedb,
+is Copyright 2020 Steinar H. Gunderson <steinar+plocate@gunderson.no>.

 Licensed under the GNU General Public License, either version 2,
 or (at your option) any later version. See the included file COPYING.
 Licensed under the GNU General Public License, either version 2,
 or (at your option) any later version. See the included file COPYING.

+
+updatedb is Copyright (C) 2005, 2007 Red Hat, Inc. All rights reserved.
+Licensed under the GNU General Public License, version 2. See the
+included file COPYING.