]> git.sesse.net Git - plocate/blobdiff - README
Bump version number.
[plocate] / README
diff --git a/README b/README
index 820205236de9e9946b4a408e4ca97d8f31d7ebc9..dcb60c827403d6817727a3323ea16e254561682e 100644 (file)
--- a/README
+++ b/README
@@ -1,12 +1,38 @@
-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, consuming mlocate's database
+ahead-of-time and making a much faster (and smaller) index out of it.
+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:
+plocate is in beta. The file format is stable, but may still change
+(if so, plocate will notify you itself that you need to rerun
+plocate-build). 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:
 
 
-  git submodule init
-  make -j8
+  meson obj
+  cd obj
+  ninja
+  sudo ninja install
 
 
-Copyright 2020 Steinar H. Gunderson <steinar+git@gunderson.no>.
+To build the database for the first time after install, you can do
+
+  sudo /etc/cron.daily/plocate
+
+or equivalently, run the update-plocate.sh script from the source
+directory as root (it is the same file installed to /etc/cron.d).
+
+If you wish to run some tests of the TurboPFor implementation against
+the reference implementation, you can check it out and run as follows:
+
+  git clone https://github.com/powturbo/TurboPFor-Integer-Compression
+  ( cd TurboPFor-Integer-Compression && make -j8 )
+  cd obj
+  ninja reconfigure
+  ninja bench
+
+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.