threads / discuss / 31599

[PATCHv2 2/8] Doc: shallow clone deepens _to_ new depth

Subject: [PATCHv2 2/8] Doc: shallow clone deepens _to_ new depth

## tl;dr

2 messages between Sep 18, 2012 and Sep 19, 2012.

replies: 1people: 2as markdown or json

Philip Oakley· Sep 18, 2012, 23:25 UTC · lore

Clarify that 'depth=' specifies the new depth from the remote's branch tip. It does not add the depth to the existing shallow clone. (details from pack-protocol.txt). Clarify that tags are not fetched. (details from shallow.txt)

Signed-off-by: Philip Oakley <philipoakley@iee.org>

diff --git a/Documentation/fetch-options.txt b/Documentation/fetch-options.txt
index 39d326a..b4d6476 100644
--- a/Documentation/fetch-options.txt
+++ b/Documentation/fetch-options.txt
@@ -10,7 +10,8 @@
 --depth=<depth>::
 	Deepen the history of a 'shallow' repository created by
 	`git clone` with `--depth=<depth>` option (see linkgit:git-clone[1])
-	by the specified number of commits.
+	to the specified number of commits from the tip of each remote
+	branch history. Tags for the deepened commits are not fetched.
 
 ifndef::git-pull[]
 --dry-run::

-- 
1.7.8.msysgit.0

Junio C Hamano· Sep 19, 2012, 03:45 UTC · re: Philip Oakley · lore

Re: [PATCHv2 2/8] Doc: shallow clone deepens _to_ new depth

Philip Oakley <philipoakley@iee.org> writes:

Show 18 quoted lines

> Clarify that 'depth=' specifies the new depth from the remote's
> branch tip. It does not add the depth to the existing shallow clone.
> (details from pack-protocol.txt).
> Clarify that tags are not fetched. (details from shallow.txt)
>
> Signed-off-by: Philip Oakley <philipoakley@iee.org>
>
> diff --git a/Documentation/fetch-options.txt b/Documentation/fetch-options.txt
> index 39d326a..b4d6476 100644
> --- a/Documentation/fetch-options.txt
> +++ b/Documentation/fetch-options.txt
> @@ -10,7 +10,8 @@
>  --depth=<depth>::
>  	Deepen the history of a 'shallow' repository created by
>  	`git clone` with `--depth=<depth>` option (see linkgit:git-clone[1])
> -	by the specified number of commits.
> +	to the specified number of commits from the tip of each remote
> +	branch history. Tags for the deepened commits are not fetched.

Looks good; thanks.