X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=man1%2Fgit-clone.1;h=772f953e4b925e16b6464db25dcd695b1fabeff6;hb=b4e975d722493c0934ffc9343d98a554a64a545e;hp=fb56e48e6c3037e523a3b2644c42ef266f6c1609;hpb=c720187e454696c492deebcc5c94089c636b8dec;p=git.git

diff --git a/man1/git-clone.1 b/man1/git-clone.1
index fb56e48e..772f953e 100755
--- a/man1/git-clone.1
+++ b/man1/git-clone.1
@@ -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
@@ -80,7 +85,7 @@ The (possibly remote) repository to clone from\&. It can be any URL git\-fetch s
 <directory>
 The name of a new directory to clone into\&. The "humanish" part of the source repository is used if no directory is explicitly given ("repo" for "/path/to/repo\&.git" and "foo" for "host\&.xz:foo/\&.git")\&. Cloning into an existing directory is not allowed\&.
 
-.SS "Examples"
+.SH "EXAMPLES"
 
 .TP
 Clone from upstream
@@ -101,6 +106,16 @@ $ 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
 
 .nf