=head1 DESCRIPTION
Display a git blob. The blob may correspond to a message from the
-local store, an existing blob in the current repository, or a
-not-yet-created blob in the current repository that can be
-reconstructed from a message.
+local store, any local external, or blobs associated with a
+project git repository (if run from a git (working) directory).
+For blobs which do not exist, it will attempt to recreate the blob
+using patch emails.
=head1 OPTIONS
Specify an additional .git/ directory to scan. This option may be
given multiple times.
+Default: the output of C<git rev-parse --git-dir>
+
=item --no-cwd
Do not look in the git repository of the current working directory.
Do not look in mail storage for C<OID>. This is implied by
C<--oid-a>, C<--path-a>, and C<--path-b>.
-=item -A OID-A, --oid-a=OID-A
+=item -A OID-A
+
+=item --oid-a=OID-A
Provide pre-image object ID as a hint for reconstructing C<OID>.
-=item -a PATH-A, --path-a=PATH-A
+=item -a PATH-A
+
+=item --path-a=PATH-A
Provide pre-image pathname as a hint for reconstructing C<OID>.
-=item -b PATH-B, --path-b=PATH-B
+=item -b PATH-B
+
+=item --path-b=PATH-B
Provide post-image pathname as a hint for reconstructing C<OID>.
-=for comment
-TODO: The below options are shared with lei-q. Any good approaches to
-not repeating the text?
+=item -v
-=item --[no-]remote
+=item --verbose
-Whether to include results requiring network access. When local
-externals are configured, C<--remote> must be explicitly passed to
-enable reporting of results from remote externals.
+Provide more feedback on stderr.
-=item --no-local
+=back
-Limit operations to those requiring network access.
+The following options are also supported and are described in
+L<lei-q(1)>.
-=item --no-external
+=over
-Don't include results from externals.
+=item --remote
-=item -I LOCATION, --include=LOCATION
+Remote externals only get queried when the blob needs to be
+reconstructed from patch emails.
-Include specified external in search. This option may be given
-multiple times.
+=item --no-local
-=item --exclude=LOCATION
+=item --no-external
-Exclude specified external from search. This option may be given
-multiple times.
+=item -I LOCATION, --include=LOCATION
-=item --only=LOCATION
+=item --exclude=LOCATION
-Use only the specified external for search. This option may be given
-multiple times, in which case the search uses only the specified set.
+=item --only=LOCATION
=item --no-import-remote
-Disable the default behavior of memoizing remote messages into the
-local store.
-
-=item -v, --verbose
-
-Provide more feedback on stderr.
-
-=item --torsocks=auto|no|yes, --no-torsocks
+=item --torsocks=auto|no|yes
-Whether to wrap L<git(1)> and L<curl(1)> commands with torsocks.
+=item --no-torsocks
-Default: C<auto>
+=item --proxy=PROTO://HOST[:PORT]
=back
=head1 SEE ALSO
-L<lei-add-external(1)>
+L<lei-add-external(1)>, L<lei-q(1)>