From f50bfec34b15905ceaf58be4271c896a60565bd1 Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Wed, 19 Apr 2006 09:44:12 +0000 Subject: [PATCH] Autogenerated HTML docs for v1.3.0-g85e6 --- git-clone.html | 30 ++++++++++++++++++++++++++++-- git-clone.txt | 21 ++++++++++++++++++++- 2 files changed, 48 insertions(+), 3 deletions(-) diff --git a/git-clone.html b/git-clone.html index 42c85d57..1d3b4512 100644 --- a/git-clone.html +++ b/git-clone.html @@ -274,6 +274,7 @@ git-clone(1) Manual Page
git-clone [-l [-s]] [-q] [-n] [--bare] [-o <name>] [-u <upload-pack>] + [--reference <repository>] <repository> [<directory>]

DESCRIPTION

@@ -323,12 +324,25 @@ branch you are currently working on. Remote branches other than

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 + .git/objects/info/alternates to share the objects with the source repository. The resulting repository starts out without any object of its own.

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

+
+
--quiet
@@ -434,6 +448,18 @@ $ git show-branch
+Clone from upstream while borrowing from an existing local directory +
+
+
+
+
$ git clone --reference my2.6 \
+        git://git.kernel.org/pub/scm/.../linux-2.7 \
+        my2.7
+$ cd my2.7
+
+
+
Create a bare repository to publish your changes to the public
@@ -468,7 +494,7 @@ Create a repository on the kernel.org machine that borrows from Linus diff --git a/git-clone.txt b/git-clone.txt index 9ac54c28..131e4457 100644 --- a/git-clone.txt +++ b/git-clone.txt @@ -10,6 +10,7 @@ SYNOPSIS -------- [verse] 'git-clone' [-l [-s]] [-q] [-n] [--bare] [-o ] [-u ] + [--reference ] [] DESCRIPTION @@ -46,10 +47,18 @@ OPTIONS -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 + .git/objects/info/alternates to share the objects with the source repository. The resulting repository starts out without any object of its own. +--reference :: + 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. + --quiet:: -q:: Operate quietly. This flag is passed to "rsync" and @@ -112,6 +121,16 @@ $ git show-branch ------------ +Clone from upstream while borrowing from an existing local directory:: ++ +------------ +$ git clone --reference my2.6 \ + git://git.kernel.org/pub/scm/.../linux-2.7 \ + my2.7 +$ cd my2.7 +------------ + + Create a bare repository to publish your changes to the public:: + ------------ -- 2.11.0