git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] clone,fetch: explain the shallow-clone option a little more clearly

From
Duy Nguyen <pclouds@gmail.com>
Date
Dec 7, 2016, 14:07 UTC
Message-ID
<CACsJy8Aug-q6uFKAHpvnvt_9ZhH85q5YcFgK4Cf1bZSnC7Khag@mail.gmail.com>
In-Reply-To
<xmqqshq029o7.fsf@gitster.mtv.corp.google.com>
On Wed, Dec 7, 2016 at 1:29 AM, Junio C Hamano <gitster@pobox.com> wrote:
Show 27 quoted lines
> Duy Nguyen <pclouds@gmail.com> writes:
>
>> On Tue, Dec 6, 2016 at 1:28 AM, Junio C Hamano <gitster@pobox.com> wrote:
>>> I however offhand do not think the feature can be used to make the
>>> repository shallower
>>
>> I'm pretty sure it can,...
>
> I wrote my message after a short local testing, but it is very
> possible I botched it and reached a wrong conclusion above.
>
> If we can use the command to make it shallower, then the phrase
> "deepen" would probably be what we need to be fixing in this patch:
>
>>       OPT_STRING_LIST(0, "shallow-exclude", &option_not, N_("revision"),
>> -                     N_("deepen history of shallow clone by excluding rev")),
>> +                     N_("deepen history of shallow clone, excluding rev")),
>
> Perhaps a shorter version of:
>
>     Adjust the depth of shallow clone so that commits that are
>     decendants of the named rev are made available, while commits
>     that are ancestors of the named rev are made beyond reach.
>
> or something like that.  Here is my (somewhat botched) attempt:
>
>     Adjust shallow clone's history to be cut at the rev
OK mine is "exclude the given tag from local history".

BTW the clone's string could be rephrased better because we know there's no local history to begin with, if we stick to any verbs that involves deepening or shortening.

-- 
Duy
Previous: Junio C Hamano
Message 5 of 5 in “clone,fetch: explain the shallow-clone option a little more clearly”
  1. clone,fetch: explain the shallow-clone option a little more clearlyAlex Henrie, Dec 4, 2016
  2. Junio C HamanoDec 5, 2016
  3. Duy NguyenDec 6, 2016
  4. Junio C HamanoDec 6, 2016
  5. Duy NguyenDec 7, 2016

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.