]> 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.