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 repository that can be
  14 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 =item --no-cwd
  26
  27 Do not look in the git repository of the current working directory.
  28
  29 =item --no-mail
  30
  31 Do not look in mail storage for C<OID>.  This is implied by
  32 C<--oid-a>, C<--path-a>, and C<--path-b>.
  33
  34 =item -A OID-A, --oid-a=OID-A
  35
  36 =item -a PATH-A, --path-a=PATH-A
  37
  38 =item -b PATH-B, --path-b=PATH-B
  39
  40 Provide pre-image object ID, pre-image pathname, or post-image
  41 pathname as a hint for reconstructing C<OID>.
  42
  43 =for comment
  44 TODO: The below options are shared with lei-q.  Any good approaches to
  45 not repeating the text?
  46
  47 =item --[no-]remote
  48
  49 Whether to include results requiring network access.  When local
  50 externals are configured, C<--remote> must be explicitly passed to
  51 enable reporting of results from remote externals.
  52
  53 =item --no-local
  54
  55 Limit operations to those requiring network access.
  56
  57 =item --no-external
  58
  59 Don't include results from externals.
  60
  61 =item -I LOCATION, --include=LOCATION
  62
  63 Include specified external in search.  This option may be given
  64 multiple times.
  65
  66 =item --exclude=LOCATION
  67
  68 Exclude specified external from search.  This option may be given
  69 multiple times.
  70
  71 =item --only=LOCATION
  72
  73 Use only the specified external for search.  This option may be given
  74 multiple times, in which case the search uses only the specified set.
  75
  76 =item --no-import-remote
  77
  78 Disable the default behavior of memoizing remote messages into the
  79 local store.
  80
  81 =item -v, --verbose
  82
  83 Provide more feedback on stderr.
  84
  85 =item --torsocks=auto|no|yes, --no-torsocks
  86
  87 Whether to wrap L<git(1)> and L<curl(1)> commands with torsocks.
  88
  89 Default: C<auto>
  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)>