diff options
Diffstat (limited to 'Documentation/lei-p2q.pod')
-rw-r--r-- | Documentation/lei-p2q.pod | 25 |
1 files changed, 21 insertions, 4 deletions
diff --git a/Documentation/lei-p2q.pod b/Documentation/lei-p2q.pod index 44798ac3..4bc5d25f 100644 --- a/Documentation/lei-p2q.pod +++ b/Documentation/lei-p2q.pod @@ -16,7 +16,7 @@ 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 +taken as a reference to a commit in the current git repository, and L<git-format-patch(1)> is used to generate the patch. =head1 OPTIONS @@ -57,6 +57,10 @@ 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 @@ -65,6 +69,20 @@ 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) + + # to view unapplied patches for a given $FILE from the past year: + echo \( rt:last.year.. AND dfn:$FILE \) AND NOT \( \ + $(git log -p --pretty=mboxrd --since=last.year $FILE | + lei p2q -F mboxrd ) + \) | lei q -o /tmp/unapplied + =head1 CONTACT Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org> @@ -74,11 +92,10 @@ L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/> =head1 COPYRIGHT -Copyright 2021 all contributors L<mailto:meta@public-inbox.org> +Copyright 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)> +L<lei-q(1)> |