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

2 messages from 2012-09-18 to 2012-09-19. Participants: Philip Oakley, Junio C Hamano.
Thread: https://gitlist.dev/t/31599

## Philip Oakley, 2012-09-18 23:25

Subject: [PATCHv2 2/8] Doc: shallow clone deepens _to_ new depth
Message-ID: <1348010734-664-3-git-send-email-philipoakley@iee.org>
URL: https://gitlist.dev/e/1348010734-664-3-git-send-email-philipoakley%40iee.org

```
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, 2012-09-19 03:45

Subject: Re: [PATCHv2 2/8] Doc: shallow clone deepens _to_ new depth
Message-ID: <7vvcfaiskf.fsf@alter.siamese.dyndns.org>
URL: https://gitlist.dev/e/7vvcfaiskf.fsf%40alter.siamese.dyndns.org
In-Reply-To: <1348010734-664-3-git-send-email-philipoakley@iee.org>

```
Philip Oakley <philipoakley@iee.org> writes:

> 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.

```
