public-inbox.git - an "archives first" approach to mailing lists

diff options

author	Eric Wong <e@80x24.org>	2021-02-28 18:25:26 +0600
committer	Eric Wong <e@80x24.org>	2021-03-01 05:51:54 +0000
commit	9c55d0015717c198dce748afd97db12eb70586c7 (patch)
tree	ab3a94a944293cd08425aa7acfe566c5c3d0e8d7 /MANIFEST
parent	c9ff20cbef45d32e4b46a78f081312543c781428 (diff)
download	public-inbox-9c55d0015717c198dce748afd97db12eb70586c7.tar.gz

lei p2q: patch-to-query generator for "lei q --stdin"

Instead of teaching the to-be-implemented "lei show" to search
threads/messages based commits, this orthogonal sub-command is
designed to generate queries for use with "lei q --stdin".

URI-escaped query parameters may be generated with --uri for
HTTP(S) public-inbox instances, but otherwise the output is
designed for "lei q --stdin".

To find threads for a given git commit from a git worktree:

	lei p2q $COMMIT_OID | lei q --stdin -t ...

It can also read via --stdin|-

	curl $INBOX_URL/$MSGID/raw | lei p2q - | lei q --stdin -t

Or from the filesystem:

	lei p2q $(git format-patch -1) | lei q --stdin -t

This defaults to only generating "dfpost:"-prefixed terms since
I've found those most useful for finding messages relating to a
commit.  This is subject to change.

--want=s@ is a comma-separated or multi-value list of prefixes
that defaults to "dfpost7".  Not all are implemented, yet, but
s, dfn, dfpre, and dfpost all seem to mostly work.  Phrase
handling may need to be tweaked to work with Xapian.

OR, NEAR, ADJ, AND, NOT may be used with --want
(e.g. --want=dfpost,OR,dfn)

Prefixing the field prefix with '+' or '-' (e.g. --want=+dfpost)
generates "+dfpost:$EXTRACTED_OID" for Xapian.   For non-boolean
search prefixes, wildcard (*) may also be supplied: (--want=dfn*)

For boolean search prefixes, suffixing the field prefix with a
digit (e.g. --want=dfpost7) provides a minimum length, allowing
truncated variations to be searched.  This is helpful for
finding older messages as git chooses longer dfpost|dfpre
abbreviations as repos get larger.

Automatic date range generation is not implemented, yet.

Diffstat (limited to 'MANIFEST')

-rw-r--r--

MANIFEST

1 files changed, 2 insertions, 0 deletions


context:
space:
mode: