From aa500f0243133f2e9e0c912eea3497e52ebc1903 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Sat, 11 Sep 2021 08:33:19 +0000 Subject: lei q|lcat: support "-f reply" output format When composing replies in "git format-patch" cover letters, I'd been relying on "lei q -f text ...", but that still requires several steps to make it suitable for composing a reply: * s/^/> / to quote the body * drop existing In-Reply-To+References * s/^Message-ID:/In-Reply-To:/; * add an attribute line ... "lei q -f reply" takes care of most of that and users will only have to trim "From " lines, unnecessary results and over-quoted text (and trimming is likely less error-prone than doing all the steps above manually). This should also be a good replacement for "git format-patch --in-reply-to=...", since copying long Message-IDs can be error-prone (and this lets you include quoted text in replies). --- Documentation/lei-q.pod | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) (limited to 'Documentation/lei-q.pod') diff --git a/Documentation/lei-q.pod b/Documentation/lei-q.pod index 69a6cdf2..1d9e66cd 100644 --- a/Documentation/lei-q.pod +++ b/Documentation/lei-q.pod @@ -60,7 +60,7 @@ Default: C<-> (stdout) Format of results to stdout. This option exists as a convenient way to specify the format for the default stdout destination. -C, C, C, or C are all supported, +C, C, C, C, or C are all supported, as are the various mbox variants described in L. When a format isn't specified, it's chosen based on the @@ -72,7 +72,7 @@ preferred when not writing to stdout. =item --no-color -Disable color (for C<--format=text>). +Disable color (for C<-f reply> and C<-f text>). =item --pretty @@ -241,6 +241,13 @@ Default: C =back +=head1 TIPS + +C<-f reply> is intended to aid in turning a cover letter +into a reply (since using C +is tedious). Results (including "From " lines) should be edited +and trimmed in your favorite C<$EDITOR> before sending. + =head1 CONTACT Feedback welcome via plain-text mail to L -- cgit v1.2.3-24-ge0c7