Documentation/lei-blob.pod

   1 =head1 NAME
   2
   3 lei-blob - display a git blob, reconstructing from mail if necessary
   4
   5 =head1 SYNOPSIS
   6
   7 lei blob [OPTIONS] OID
   8
   9 =head1 DESCRIPTION
  10
  11 Display a git blob.  The blob may correspond to a message from the
  12 local store, an existing blob in the current repository, or a
  13 not-yet-created blob in the current git project repository (if any)
  14 that can be reconstructed from a message.
  15
  16 =head1 OPTIONS
  17
  18 =over
  19
  20 =item --git-dir=DIR
  21
  22 Specify an additional .git/ directory to scan.  This option may be
  23 given multiple times.
  24
  25 Default: the output of C<git rev-parse --git-dir>
  26
  27 =item --no-cwd
  28
  29 Do not look in the git repository of the current working directory.
  30
  31 =item --no-mail
  32
  33 Do not look in mail storage for C<OID>.  This is implied by
  34 C<--oid-a>, C<--path-a>, and C<--path-b>.
  35
  36 =item -A OID-A
  37
  38 =item --oid-a=OID-A
  39
  40 Provide pre-image object ID as a hint for reconstructing C<OID>.
  41
  42 =item -a PATH-A
  43
  44 =item --path-a=PATH-A
  45
  46 Provide pre-image pathname as a hint for reconstructing C<OID>.
  47
  48 =item -b PATH-B
  49
  50 =item --path-b=PATH-B
  51
  52 Provide post-image pathname as a hint for reconstructing C<OID>.
  53
  54 =item -v
  55
  56 =item --verbose
  57
  58 Provide more feedback on stderr.
  59
  60 =back
  61
  62 The following options are also supported and are described in
  63 L<lei-q(1)>.
  64
  65 =over
  66
  67 =item --[no-]remote
  68
  69 =item --no-local
  70
  71 =item --no-external
  72
  73 =item -I LOCATION, --include=LOCATION
  74
  75 =item --exclude=LOCATION
  76
  77 =item --only=LOCATION
  78
  79 =item --no-import-remote
  80
  81 =item --torsocks=auto|no|yes
  82
  83 =item --no-torsocks
  84
  85 =item --proxy=PROTO://HOST[:PORT]
  86
  87 =back
  88
  89 =head1 CONTACT
  90
  91 Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>
  92
  93 The mail archives are hosted at L<https://public-inbox.org/meta/> and
  94 L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
  95
  96 =head1 COPYRIGHT
  97
  98 Copyright 2021 all contributors L<mailto:meta@public-inbox.org>
  99
 100 License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>
 101
 102
 103 =head1 SEE ALSO
 104
 105 L<lei-add-external(1)>, L<lei-q(1)>