=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. 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 git repository, and L is used to generate the patch. =head1 OPTIONS =over =item -w PREFIX[,PREFIX] =item --want=PREFIX[,PREFIX] Search prefixes to use. C (post-image git blob ID) and C (file names from the diff) are the most useful. Other available values are C, C, C, C, and C. =for comment TODO: Put a table of prefixes somewhere and reference that (at least here and in lei-q)? Appending an integer to C or C 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 is set to C and git calculates the default abbreviation length as 7, C will expand a post-image blob ID of e7b4b32 (seven characters) into C. This option may be given multiple times. Default: C =item --stdin Read message from stdin. This is implicit if no arguments are given and stdin is a pipe or regular file. =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 --uri URI escape output for interacting with HTTP(S) public-inbox instances. =item -q =item --quiet Suppress feedback messages. =back =head1 EXAMPLES # to search for all threads which touch a given thread: lei p2q $COMMIT_OID | lei q -t -o /tmp/results # to view results on a remote HTTP(S) public-inbox instance $BROWSER https://example.com/pub-inbox/?q=$(lei p2q --uri $COMMIT_OID) =head1 CONTACT Feedback welcome via plain-text mail to L The mail archives are hosted at L and L =head1 COPYRIGHT Copyright all contributors L License: AGPL-3.0+ L =head1 SEE ALSO L