diff options
| author | Eric Wong <e@80x24.org> | 2021-09-11 08:33:19 +0000 |
|---|---|---|
| committer | Eric Wong <e@80x24.org> | 2021-09-11 21:12:40 +0000 |
| commit | aa500f0243133f2e9e0c912eea3497e52ebc1903 (patch) | |
| tree | f3f996a118afe5cc9014ac5a793f3285ffae4d25 /Documentation/lei-q.pod | |
| parent | 57fed2e4b78ed394db38ac6d9b9227722d546d98 (diff) | |
| download | public-inbox-aa500f0243133f2e9e0c912eea3497e52ebc1903.tar.gz | |
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).
Diffstat (limited to 'Documentation/lei-q.pod')
| -rw-r--r-- | Documentation/lei-q.pod | 11 |
1 files changed, 9 insertions, 2 deletions
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<text>, C<json>, C<jsonl>, or C<concatjson> are all supported, +C<reply>, C<text>, C<json>, C<jsonl>, or C<concatjson> are all supported, as are the various mbox variants described in L</--output>. 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<auto> =back +=head1 TIPS + +C<-f reply> is intended to aid in turning a cover letter +into a reply (since using C<git format-patch --in-reply-to=...> +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<mailto:meta@public-inbox.org> |