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 --git-dir=DIR
  42
  43 Specify an additional .git/ directory to scan.  This option may be
  44 given multiple times.
  45
  46 Default: the output of C<git rev-parse --git-dir>
  47
  48 =item --no-cwd
  49
  50 Do not look in the git repository of the current working directory.
  51
  52 =item -q
  53
  54 =item --quiet
  55
  56 Suppress progress output.
  57
  58 =item -v
  59
  60 =item --verbose
  61
  62 Provide more feedback on stderr.
  63
  64 =back
  65
  66 The options below, described in L<lei-q(1)>, are also supported.
  67
  68 =over
  69
  70 =item --[no-]remote
  71
  72 =item --no-local
  73
  74 =item --no-external
  75
  76 =item --no-import-remote
  77
  78 =item --torsocks=auto|no|yes, --no-torsocks
  79
  80 =item --proxy=PROTO://HOST[:PORT]
  81
  82 =back
  83
  84 =head1 CONTACT
  85
  86 Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>
  87
  88 The mail archives are hosted at L<https://public-inbox.org/meta/>
  89 and L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
  90
  91 =head1 COPYRIGHT
  92
  93 Copyright 2021 all contributors L<mailto:meta@public-inbox.org>
  94
  95 License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>
  96
  97 =head1 SEE ALSO
  98
  99 L<lei-q(1)>, L<lei-blob(1)>, L<lei-p2q(1)>