Autogenerated man pages for v1.3.0-g85e6
authorJunio C Hamano <junio@hera.kernel.org>
Wed, 19 Apr 2006 09:44:16 +0000 (09:44 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Wed, 19 Apr 2006 09:44:16 +0000 (09:44 +0000)
man1/git-clone.1

index fb56e48e6c3037e523a3b2644c42ef266f6c1609..d43b3ba1ca864c0144d2d5d3c0dc1439751ba0d5 100755 (executable)
@@ -24,6 +24,7 @@ git-clone \- Clones a repository
 
 .nf
 \fIgit\-clone\fR [\-l [\-s]] [\-q] [\-n] [\-\-bare] [\-o <name>] [\-u <upload\-pack>]
+          [\-\-reference <repository>]
           <repository> [<directory>]
 .fi
 
@@ -50,7 +51,11 @@ When the repository to clone from is on a local machine, this flag bypasses norm
 
 .TP
 \-\-shared, \-s
-When the repository to clone is on the local machine, instead of using hard links, automatically setup \&.git/objects/info/alternatives to share the objects with the source repository\&. The resulting repository starts out without any object of its own\&.
+When the repository to clone is on the local machine, instead of using hard links, automatically setup \&.git/objects/info/alternates to share the objects with the source repository\&. The resulting repository starts out without any object of its own\&.
+
+.TP
+\-\-reference <repository>
+If the reference repository is on the local machine automatically setup \&.git/objects/info/alternates to obtain objects from the reference repository\&. Using an already existing repository as an alternate will require less objects to be copied from the repository being cloned, reducing network and local storage costs\&.
 
 .TP
 \-\-quiet, \-q
@@ -100,6 +105,16 @@ $ cd copy
 $ git show\-branch
 .fi
 
+.TP
+Clone from upstream while borrowing from an existing local directory
+
+.nf
+$ git clone \-\-reference my2\&.6 \\
+        git://git\&.kernel\&.org/pub/scm/\&.\&.\&./linux\-2\&.7 \\
+        my2\&.7
+$ cd my2\&.7
+.fi
+
 .TP
 Create a bare repository to publish your changes to the public