From 44812cbbec44625083b6e5441a798a21a5e79f71 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Thu, 28 Oct 2021 11:14:57 +0000 Subject: doc: lei blob: wording fixups, describe --remote There's no current way to retrieve blobs by OID directly from remote externals. Maybe the $INBOX_NAME/$OID/s/raw.eml endpoint could be overloaded for that. --- Documentation/lei-blob.pod | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/Documentation/lei-blob.pod b/Documentation/lei-blob.pod index 429d206e..e401bb47 100644 --- a/Documentation/lei-blob.pod +++ b/Documentation/lei-blob.pod @@ -9,9 +9,10 @@ lei blob [OPTIONS] OID =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 git project repository (if any) -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 @@ -64,7 +65,10 @@ L. =over -=item --[no-]remote +=item --remote + +Remote externals only get queried when the blob needs to be +reconstructed from patch emails. =item --no-local -- cgit v1.2.3-24-ge0c7