From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: X-Spam-Status: No, score=-4.0 required=3.0 tests=ALL_TRUSTED,BAYES_00 shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from localhost (dcvr.yhbt.net [127.0.0.1]) by dcvr.yhbt.net (Postfix) with ESMTP id 4970C1FA10 for ; Thu, 28 Oct 2021 11:15:02 +0000 (UTC) From: Eric Wong To: meta@public-inbox.org Subject: [PATCH 4/8] doc: lei blob: wording fixups, describe --remote Date: Thu, 28 Oct 2021 11:14:57 +0000 Message-Id: <20211028111501.24014-5-e@80x24.org> In-Reply-To: <20211028111501.24014-1-e@80x24.org> References: <20211028111501.24014-1-e@80x24.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit List-Id: 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 429d206e358e..e401bb4711a6 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