From 2ca7db34a51b858c9d7f6f7366afb9fffee86b6e Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Fri, 17 Jul 2020 03:57:24 +0000 Subject: doc: add some recommendations around slow HDDs grok-pull is still painful with serialization on an old USB 2.0 HDD, but at least it can finish with flock(1) and disabling parallelization. While parallel "git fetch" doesn't seem so bad, slow seeks are exacerbated by parallel reads in Xapian. That means some updates can take days instead of hours. The same updates take only seconds or minutes on an SSD. --- Documentation/public-inbox-index.pod | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'Documentation') diff --git a/Documentation/public-inbox-index.pod b/Documentation/public-inbox-index.pod index b1b24917..ff2e5486 100644 --- a/Documentation/public-inbox-index.pod +++ b/Documentation/public-inbox-index.pod @@ -32,6 +32,16 @@ normal search functionality. =over +=item --jobs=JOBS, -j + +Control the number of Xapian indexing jobs in a +(L) inbox. + +C<--jobs=0> is accepted as of public-inbox 1.6.0 (PENDING) +to disable parallel indexing. + +Default: the number of existing Xapian shards + =item --compact / -c Compacts the Xapian DBs after indexing. This is recommended -- cgit v1.2.3-24-ge0c7