]> Sergey Matveev's repositories - public-inbox.git/blob - Documentation/lei-blob.pod
doc lei q: fix a typo
[public-inbox.git] / 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
35
36 =item --oid-a=OID-A
37
38 Provide pre-image object ID as a hint for reconstructing C<OID>.
39
40 =item -a PATH-A
41
42 =item --path-a=PATH-A
43
44 Provide pre-image pathname as a hint for reconstructing C<OID>.
45
46 =item -b PATH-B
47
48 =item --path-b=PATH-B
49
50 Provide post-image pathname as a hint for reconstructing C<OID>.
51
52 =item -v
53
54 =item --verbose
55
56 Provide more feedback on stderr.
57
58 =back
59
60 The following options are also supported and are described in
61 L<lei-q(1)>.
62
63 =over
64
65 =item --[no-]remote
66
67 =item --no-local
68
69 =item --no-external
70
71 =item -I LOCATION, --include=LOCATION
72
73 =item --exclude=LOCATION
74
75 =item --only=LOCATION
76
77 =item --no-import-remote
78
79 =item --torsocks=auto|no|yes
80
81 =item --no-torsocks
82
83 =back
84
85 =head1 CONTACT
86
87 Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>
88
89 The mail archives are hosted at L<https://public-inbox.org/meta/> and
90 L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
91
92 =head1 COPYRIGHT
93
94 Copyright 2021 all contributors L<mailto:meta@public-inbox.org>
95
96 License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>
97
98
99 =head1 SEE ALSO
100
101 L<lei-add-external(1)>, L<lei-q(1)>