user/dev discussion of public-inbox itself
 help / color / mirror / code / Atom feed
f404ede0cd0070ebe649dfeaca3543347dfb60c8 blob 2142 bytes (raw)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
 
=head1 NAME

lei-p2q - use a patch to generate a lei-q query

=head1 SYNOPSIS

lei p2q [OPTIONS] (FILE|COMMIT)

lei p2q [OPTIONS] (--stdin|-)

=head1 DESCRIPTION

Given a patch, create a query that can be fed on stdin to L<lei-q(1)>.
This is useful for mapping the patch to associated messages of an
inbox.

The patch can be provided on stdin or as a file.  Alternatively, when
an argument is given that does not point to an existing file, it is
taken as a reference to a commit in the current repository, and
L<git-format-patch(1)> is used to generate the patch.

=head1 OPTIONS

=over

=item -w PREFIX[,PREFIX]

=item --want=PREFIX[,PREFIX]

Search prefixes to use.  C<dfpost> (post-image git blob ID) and C<dfn>
(file names from the diff) are the most useful.  Other available
values are C<dfa>, C<dfb>, C<dfctx>, C<dfhh>, and C<dfpre>.

=for comment
TODO: Put a table of prefixes somewhere and reference that (at least
here and in lei-q)?

Appending an integer to C<dfpost> or C<dfpre> indicates a minimum ID
length, and the generated query will be for that value up through the
default abbreviation length.  For example, if the repository's
C<core.abbrev> is set to C<auto> and git calculates the default
abbreviation length as 7, C<dfpost6> will expand a post-image blob ID
of e7b4b32 (seven characters) into C<dfpost:e7b4b32 OR dfpost:e7b4b3>.

This option may be given multiple times.

Default: C<dfpost7>

=item --stdin

Read patch from stdin.

=item --debug

Dump output that shows the information collected for every prefix.
This information can be useful for seeing how a patch is processed,
but the format should not be considered stable.

=item -q

=item --quiet

Suppress feedback messages.

=back

=head1 CONTACT

Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>

The mail archives are hosted at L<https://public-inbox.org/meta/> and
L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>

=head1 COPYRIGHT

Copyright 2021 all contributors L<mailto:meta@public-inbox.org>

License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>


=head1 SEE ALSO

L<lei-add-external(1)>
debug log:

solving f404ede0 ...
found f404ede0 in public-inbox.git

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