user/dev discussion of public-inbox itself
 help / color / mirror / code / Atom feed
* "lei q" vs mairix notes...
@ 2021-03-05  2:22 Eric Wong
  0 siblings, 0 replies; only message in thread
From: Eric Wong @ 2021-03-05  2:22 UTC (permalink / raw)
  To: meta

I'm not sure if this should be in the lei-q(1) manpage or
another manpage, probably another.  There ought to be a similar
doc for notmuch and any other existing mail things I'm not
familiar with.

This is intended to be a neutral document to help and set
expectations for mairix users should they attempt to use lei.
It is NOT intended as advocacy document.

mairix and "lei q" share some similarities around common search
prefixes ("f:", "s:", "nq:") but there are several differences
users familiar with mairix should be aware of.

- lei (Xapian) uses ".." for date and size ranges, mairix uses "-".
  This is due to how the Xapian query parser works.

- lei uses git(1) for date and time parsing; mairix has its own
  syntax documented in mairix(1).

- lei does not support MH, yet

- lei currently requires mail to be imported into git ("lei import");
  mairix indexes mail in IMAP, Maildir, MH, mbox directly
  lei may attempt to index mail outside of git if there's interest:
  https://public-inbox.org/meta/20210303035359.GA14438@dcvr/

- mairix can use symlinks and/or hardlinks to speed up writing
  results when using Maildirs; lei must always extract messages
  from git, which will always be slower.

- mairix has different rules around substring matches, negation,
  combining, etc. than Xapian <https://xapian.org/docs/queryparser.html>

- lei doesn't yet support config file entries for output
  (but will support saved searches)

- --raw-output and --excerpt-output in mairix aren't yet
  supported, but the default JSON output in "lei q" may be
  similar

- lei indexes positional data by default (and currently lacks a
  configuration knob in the CLI), so indices use significantly
  more space.

- lei is still in its infancy and far from complete

Again, this is intended to be a neutral document and not
advocacy.  Help appreciated with corrections and addendums.

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2021-03-05  2:22 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-03-05  2:22 "lei q" vs mairix notes Eric Wong

user/dev discussion of public-inbox itself

This inbox may be cloned and mirrored by anyone:

	git clone --mirror https://public-inbox.org/meta
	git clone --mirror http://czquwvybam4bgbro.onion/meta
	git clone --mirror http://hjrcffqmbrq6wope.onion/meta
	git clone --mirror http://ou63pmih66umazou.onion/meta

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V1 meta meta/ https://public-inbox.org/meta \
		meta@public-inbox.org
	public-inbox-index meta

Example config snippet for mirrors.
Newsgroups are available over NNTP:
	nntp://news.public-inbox.org/inbox.comp.mail.public-inbox.meta
	nntp://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/inbox.comp.mail.public-inbox.meta
	nntp://ie5yzdi7fg72h7s4sdcztq5evakq23rdt33mfyfcddc5u3ndnw24ogqd.onion/inbox.comp.mail.public-inbox.meta
	nntp://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/inbox.comp.mail.public-inbox.meta
	nntp://news.gmane.io/gmane.mail.public-inbox.general
 note: .onion URLs require Tor: https://www.torproject.org/

code repositories for project(s) associated with this inbox:

	https://80x24.org/public-inbox.git

AGPL code for this site: git clone https://public-inbox.org/public-inbox.git