]> Sergey Matveev's repositories - public-inbox.git/blob - Documentation/lei-rediff.pod
cmd_ipc4: retry sendmsg on ENOBUFS/ENOMEM/ETOOMANYREFS
[public-inbox.git] / Documentation / lei-rediff.pod
1 =head1 NAME
2
3 lei-rediff - regenerate a diff with different options
4
5 =head1 SYNOPSIS
6
7 lei rediff [OPTIONS] LOCATION [LOCATION...]
8
9 lei rediff [OPTIONS] (--stdin|-)
10
11 =head1 DESCRIPTION
12
13 Read a message from C<LOCATION> or stdin and regenerate its diff with
14 the specified L<git-diff(1)> options.  This is useful if you want to
15 change the display of the original patch (e.g., increasing context,
16 coloring moved lines differently, or using an external diff viewer).
17
18 It relies on the contents of the .git directory of your current
19 project working tree.  In other words, it works anywhere
20 L<git-am(1)> works.  Otherwise, C<--git-dir=> may be specified
21 any number of times to add repositories to build blob data from.
22
23 =head1 OPTIONS
24
25 In addition to many L<git-diff(1)> options (e.g. C<-W>, C<-w>,
26 C<-U $LINES>) the following options are supported:
27
28 =over
29
30 =item --stdin
31
32 Read message from stdin.  This is implicit if no arguments are given
33 and stdin is a pipe or regular file.
34
35 For users of text editors and pagers capable of piping its
36 buffer to arbitrary commands, it is useful to pipe a patch email
37 to C<lei rediff> before piping it to L<git-am(1)>.  The output
38 of C<lei rediff> is compatible with C<git am> if its input was a
39 patch email.
40
41 =item --drq[=COUNT]
42
43 De-Re-Quote.  De-quotes the input and re-quotes (the output).
44 Removes COUNT levels of C<E<gt> > email reply prefixes and
45 re-adds them upon regenerating the diff.
46
47 This switch is intended as a convenience for running inside a
48 pipe-capable text editor when writing replies to a patch email.
49 Note: this may over-add C<E<gt> > prefixes if some input lines
50 are missing C<E<gt> > prefixes.
51
52 COUNT is 1 if unspecified; in other words, C<--drq=1> and
53 C<--drq> are equivalent.
54
55 It implies L</--quiet> unless L</--verbose> is specified
56 since text editors tend to combine stderr with stdout.
57
58 =item --dequote-only[=COUNT]
59
60 Like L</--drq>, but does not re-add quote prefixes to the output.
61
62 This can be useful for feeding a hunk to L<git-apply(1)>
63 or L<patch(1)> while writing a reply or further processing
64 by another diff viewer.
65
66 Unlike L</--drq>, it does NOT imply L</--quiet>.
67
68 =item --git-dir=DIR
69
70 Specify an additional .git/ directory to scan.  This option may be
71 given multiple times.
72
73 Default: the output of C<git rev-parse --git-dir>
74
75 =item --no-cwd
76
77 Do not look in the git repository of the current working directory.
78
79 =item -q
80
81 =item --quiet
82
83 Suppress progress output.
84
85 =item -v
86
87 =item --verbose
88
89 Provide more feedback on stderr.
90
91 =back
92
93 The options below, described in L<lei-q(1)>, are also supported.
94
95 =over
96
97 =item --[no-]remote
98
99 =item --no-local
100
101 =item --no-external
102
103 =item --no-import-remote
104
105 =item --torsocks=auto|no|yes, --no-torsocks
106
107 =item --proxy=PROTO://HOST[:PORT]
108
109 =back
110
111 =head1 CONTACT
112
113 Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>
114
115 The mail archives are hosted at L<https://public-inbox.org/meta/>
116 and L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
117
118 =head1 COPYRIGHT
119
120 Copyright 2021 all contributors L<mailto:meta@public-inbox.org>
121
122 License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>
123
124 =head1 SEE ALSO
125
126 L<lei-q(1)>, L<lei-blob(1)>, L<lei-p2q(1)>