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