{"thread":{"id":"6837","subject":"[PATCH] git-clone: Sync documentation to usage note.","startedAt":"2007-02-15T22:13:54Z","lastAt":"2007-02-15T22:38:02Z","messageCount":2,"participants":["Christian Schlotter","Shawn O. Pearce"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"34740","messageId":"117157763494-git-send-email-schlotter@users.sourceforge.net","threadId":"6837","inReplyTo":null,"subject":"[PATCH] git-clone: Sync documentation to usage note.","fromName":"Christian Schlotter","fromEmail":"schlotter@users.sourceforge.net","sentAt":"2007-02-15T22:13:54Z","receivedAt":"2007-02-15T22:13:54Z","isPatch":true,"sender":{"key":"schlotter@users.sourceforge.net","avatar":null},"body":"Documentation advertises the new `--depth <n>' parameter with an equal\nsign, while the usage notes (shown after `git-clone --help') do not.  If I\nunderstood git-clone's source code correctly, the version without the\nequal sign is correct, which is why this patch syncs documentation to the\nusage note.\n\nPlease note that I was not able to test the new shallow clone feature, as\nboth\n    git clone --depth=5 git://git2.kernel.org/pub/scm/git/git.git\nand\n    git clone --depth 5 git://git2.kernel.org/pub/scm/git/git.git\ndo not seem to work.  The former correctly produces the usage note, while\nthe latter prints\n\n    Initialized empty Git repository in /home/cs/tmp2/git/.git/\n    fatal: read error (Connection reset by peer)\n    fetch-pack from 'git://git2.kernel.org/pub/scm/git/git.git' failed.\n\nIs this a problem on my end?\n\nSigned-off-by: Christian Schlotter <schlotter@users.sourceforge.net>\n---\n Documentation/RelNotes-1.5.0.txt |    2 +-\n Documentation/git-clone.txt      |    4 ++--\n 2 files changed, 3 insertions(+), 3 deletions(-)\n\ndiff --git a/Documentation/RelNotes-1.5.0.txt b/Documentation/RelNotes-1.5.0.txt\nindex 599efb8..daf4bdb 100644\n--- a/Documentation/RelNotes-1.5.0.txt\n+++ b/Documentation/RelNotes-1.5.0.txt\n@@ -448,7 +448,7 @@ Updates in v1.5.0 since v1.4.4 series\n  - There is a partial support for 'shallow' repositories that\n    keeps only recent history.  A 'shallow clone' is created by\n    specifying how deep that truncated history should be\n-   (e.g. \"git clone --depth=5 git://some.where/repo.git\").\n+   (e.g. \"git clone --depth 5 git://some.where/repo.git\").\n \n    Currently a shallow repository has number of limitations:\n \ndiff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt\nindex 707376f..6d32c49 100644\n--- a/Documentation/git-clone.txt\n+++ b/Documentation/git-clone.txt\n@@ -11,7 +11,7 @@ SYNOPSIS\n [verse]\n 'git-clone' [--template=<template_directory>] [-l [-s]] [-q] [-n] [--bare]\n \t  [-o <name>] [-u <upload-pack>] [--reference <repository>]\n-\t  [--depth=<depth>] <repository> [<directory>]\n+\t  [--depth <depth>] <repository> [<directory>]\n \n DESCRIPTION\n -----------\n@@ -96,7 +96,7 @@ OPTIONS\n \tif unset the templates are taken from the installation\n \tdefined default, typically `/usr/share/git-core/templates`.\n \n---depth=<depth>::\n+--depth <depth>::\n \tCreate a 'shallow' clone with a history truncated to the\n \tspecified number of revs.  A shallow repository has\n \tnumber of limitations (you cannot clone or fetch from\n-- \n1.5.0\n"},{"id":"34742","messageId":"20070215223802.GA27992@spearce.org","threadId":"6837","inReplyTo":"117157763494-git-send-email-schlotter@users.sourceforge.net","subject":"Re: [PATCH] git-clone: Sync documentation to usage note.","fromName":"Shawn O. Pearce","fromEmail":"spearce@spearce.org","sentAt":"2007-02-15T22:38:02Z","receivedAt":"2007-02-15T22:38:02Z","isPatch":true,"sender":{"key":"spearce@spearce.org","avatar":"https://avatars.githubusercontent.com/u/34844?v=4"},"body":"Christian Schlotter <schlotter@users.sourceforge.net> wrote:\n> Please note that I was not able to test the new shallow clone feature, as\n> both\n>     git clone --depth=5 git://git2.kernel.org/pub/scm/git/git.git\n> and\n>     git clone --depth 5 git://git2.kernel.org/pub/scm/git/git.git\n> do not seem to work.  The former correctly produces the usage note, while\n> the latter prints\n> \n>     Initialized empty Git repository in /home/cs/tmp2/git/.git/\n>     fatal: read error (Connection reset by peer)\n>     fetch-pack from 'git://git2.kernel.org/pub/scm/git/git.git' failed.\n> \n> Is this a problem on my end?\n\nSort of.  ;-)\n\nThe server side must also support shallow clone.  I don't think\nthe server on kernel.org has been upgraded yet to a version which\nsupports that feature, so you cannot shallow clone from there.\n\n-- \nShawn.\n"}]}