Junio C Hamano | 215a7ad | 2005-09-07 17:26:23 -0700 | [diff] [blame] | 1 | git-clone(1) |
| 2 | ============ |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 3 | |
| 4 | NAME |
| 5 | ---- |
william pursell | 29cf5e1 | 2007-06-09 16:44:12 +0100 | [diff] [blame] | 6 | git-clone - Clone a repository into a new directory |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 7 | |
| 8 | |
| 9 | SYNOPSIS |
| 10 | -------- |
Jonas Fonseca | 353ce81 | 2005-12-31 18:37:15 +0100 | [diff] [blame] | 11 | [verse] |
Jonathan Nieder | b1889c3 | 2008-06-30 01:09:04 -0500 | [diff] [blame] | 12 | 'git clone' [--template=<template_directory>] |
Johannes Schindelin | bc699af | 2008-08-02 21:38:56 +0200 | [diff] [blame] | 13 | [-l] [-s] [--no-hardlinks] [-q] [-n] [--bare] [--mirror] |
David Soria Parra | db9bc00 | 2009-11-30 14:27:52 +0100 | [diff] [blame] | 14 | [-o <name>] [-b <name>] [-u <upload-pack>] [--reference <repository>] |
Nguyen Thai Ngoc Duy | 09ffc70 | 2011-05-24 23:40:32 +0700 | [diff] [blame] | 15 | [--separate-git-dir <git dir>] |
Nguyễn Thái Ngọc Duy | 3e6e0ed | 2012-01-07 21:45:59 +0700 | [diff] [blame] | 16 | [--depth <depth>] [--[no-]single-branch] |
Felipe Contreras | 0460ed2 | 2013-05-08 20:16:55 -0500 | [diff] [blame] | 17 | [--recursive | --recurse-submodules] [--] <repository> |
Jens Lehmann | ccdd3da | 2010-11-04 21:27:12 +0100 | [diff] [blame] | 18 | [<directory>] |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 19 | |
| 20 | DESCRIPTION |
| 21 | ----------- |
Junio C Hamano | 4607166 | 2005-11-05 22:26:52 -0800 | [diff] [blame] | 22 | |
J. Bruce Fields | db9819a | 2006-12-08 01:27:21 -0500 | [diff] [blame] | 23 | Clones a repository into a newly created directory, creates |
| 24 | remote-tracking branches for each branch in the cloned repository |
Jonathan Nieder | 33405be | 2009-10-09 18:07:39 -0500 | [diff] [blame] | 25 | (visible using `git branch -r`), and creates and checks out an |
| 26 | initial branch that is forked from the cloned repository's |
| 27 | currently active branch. |
Junio C Hamano | 4607166 | 2005-11-05 22:26:52 -0800 | [diff] [blame] | 28 | |
J. Bruce Fields | db9819a | 2006-12-08 01:27:21 -0500 | [diff] [blame] | 29 | After the clone, a plain `git fetch` without arguments will update |
| 30 | all the remote-tracking branches, and a `git pull` without |
| 31 | arguments will in addition merge the remote master branch into the |
Ralf Thielow | 31b808a | 2012-09-20 20:04:08 +0200 | [diff] [blame] | 32 | current master branch, if any (this is untrue when "--single-branch" |
| 33 | is given; see below). |
Junio C Hamano | 4607166 | 2005-11-05 22:26:52 -0800 | [diff] [blame] | 34 | |
J. Bruce Fields | db9819a | 2006-12-08 01:27:21 -0500 | [diff] [blame] | 35 | This default configuration is achieved by creating references to |
Jeff King | cc1b8d8 | 2010-02-17 20:16:20 -0500 | [diff] [blame] | 36 | the remote branch heads under `refs/remotes/origin` and |
J. Bruce Fields | db9819a | 2006-12-08 01:27:21 -0500 | [diff] [blame] | 37 | by initializing `remote.origin.url` and `remote.origin.fetch` |
| 38 | configuration variables. |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 39 | |
Junio C Hamano | f4bf218 | 2007-01-01 15:08:06 -0800 | [diff] [blame] | 40 | |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 41 | OPTIONS |
| 42 | ------- |
Eric W. Biederman | a2775c2 | 2005-10-02 13:42:57 -0600 | [diff] [blame] | 43 | --local:: |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 44 | -l:: |
| 45 | When the repository to clone from is on a local machine, |
Thomas Ackermann | 2de9b71 | 2013-01-21 20:17:53 +0100 | [diff] [blame] | 46 | this flag bypasses the normal "Git aware" transport |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 47 | mechanism and clones the repository by making a copy of |
| 48 | HEAD and everything under objects and refs directories. |
Junio C Hamano | 3d5c418 | 2007-08-01 23:42:36 -0700 | [diff] [blame] | 49 | The files under `.git/objects/` directory are hardlinked |
Jeff King | 9197a10 | 2012-05-30 07:09:08 -0400 | [diff] [blame] | 50 | to save space when possible. |
| 51 | + |
| 52 | If the repository is specified as a local path (e.g., `/path/to/repo`), |
| 53 | this is the default, and --local is essentially a no-op. If the |
| 54 | repository is specified as a URL, then this flag is ignored (and we |
Jeff King | 189260b | 2012-05-30 07:10:16 -0400 | [diff] [blame] | 55 | never use the local optimizations). Specifying `--no-local` will |
| 56 | override the default when `/path/to/repo` is given, using the regular |
Thomas Ackermann | 2de9b71 | 2013-01-21 20:17:53 +0100 | [diff] [blame] | 57 | Git transport instead. |
Jeff King | 9197a10 | 2012-05-30 07:09:08 -0400 | [diff] [blame] | 58 | + |
| 59 | To force copying instead of hardlinking (which may be desirable if you |
| 60 | are trying to make a back-up of your repository), but still avoid the |
Thomas Ackermann | 2de9b71 | 2013-01-21 20:17:53 +0100 | [diff] [blame] | 61 | usual "Git aware" transport mechanism, `--no-hardlinks` can be used. |
Junio C Hamano | 3d5c418 | 2007-08-01 23:42:36 -0700 | [diff] [blame] | 62 | |
| 63 | --no-hardlinks:: |
| 64 | Optimize the cloning process from a repository on a |
| 65 | local filesystem by copying files under `.git/objects` |
| 66 | directory. |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 67 | |
Eric W. Biederman | a2775c2 | 2005-10-02 13:42:57 -0600 | [diff] [blame] | 68 | --shared:: |
| 69 | -s:: |
| 70 | When the repository to clone is on the local machine, |
Junio C Hamano | 4607166 | 2005-11-05 22:26:52 -0800 | [diff] [blame] | 71 | instead of using hard links, automatically setup |
Björn Gustavsson | 550c66f | 2009-10-20 22:38:38 +0200 | [diff] [blame] | 72 | `.git/objects/info/alternates` to share the objects |
Junio C Hamano | 4607166 | 2005-11-05 22:26:52 -0800 | [diff] [blame] | 73 | with the source repository. The resulting repository |
| 74 | starts out without any object of its own. |
Miklos Vajna | 8466887 | 2008-02-12 01:12:57 +0100 | [diff] [blame] | 75 | + |
| 76 | *NOTE*: this is a possibly dangerous operation; do *not* use |
| 77 | it unless you understand what it does. If you clone your |
Brandon Casey | 2498a1a | 2008-04-03 13:26:13 -0500 | [diff] [blame] | 78 | repository using this option and then delete branches (or use any |
Thomas Ackermann | 2de9b71 | 2013-01-21 20:17:53 +0100 | [diff] [blame] | 79 | other Git command that makes any existing commit unreferenced) in the |
Brandon Casey | 2498a1a | 2008-04-03 13:26:13 -0500 | [diff] [blame] | 80 | source repository, some objects may become unreferenced (or dangling). |
Thomas Ackermann | 2de9b71 | 2013-01-21 20:17:53 +0100 | [diff] [blame] | 81 | These objects may be removed by normal Git operations (such as `git commit`) |
Jonathan Nieder | 483bc4f | 2008-06-30 13:56:34 -0500 | [diff] [blame] | 82 | which automatically call `git gc --auto`. (See linkgit:git-gc[1].) |
| 83 | If these objects are removed and were referenced by the cloned repository, |
| 84 | then the cloned repository will become corrupt. |
Jeff King | 13354f5 | 2009-08-17 02:19:17 -0400 | [diff] [blame] | 85 | + |
| 86 | Note that running `git repack` without the `-l` option in a repository |
| 87 | cloned with `-s` will copy objects from the source repository into a pack |
| 88 | in the cloned repository, removing the disk space savings of `clone -s`. |
| 89 | It is safe, however, to run `git gc`, which uses the `-l` option by |
| 90 | default. |
| 91 | + |
| 92 | If you want to break the dependency of a repository cloned with `-s` on |
| 93 | its source repository, you can simply run `git repack -a` to copy all |
| 94 | objects from the source repository into a pack in the cloned repository. |
Eric W. Biederman | a2775c2 | 2005-10-02 13:42:57 -0600 | [diff] [blame] | 95 | |
Shawn Pearce | 23edecb | 2006-04-18 20:19:48 -0400 | [diff] [blame] | 96 | --reference <repository>:: |
Miklos Vajna | 4059237 | 2009-09-03 13:24:16 +0200 | [diff] [blame] | 97 | If the reference repository is on the local machine, |
Björn Gustavsson | 550c66f | 2009-10-20 22:38:38 +0200 | [diff] [blame] | 98 | automatically setup `.git/objects/info/alternates` to |
Shawn Pearce | 23edecb | 2006-04-18 20:19:48 -0400 | [diff] [blame] | 99 | obtain objects from the reference repository. Using |
| 100 | an already existing repository as an alternate will |
Mike Ralphson | 451e593 | 2007-09-07 17:43:37 +0100 | [diff] [blame] | 101 | require fewer objects to be copied from the repository |
Shawn Pearce | 23edecb | 2006-04-18 20:19:48 -0400 | [diff] [blame] | 102 | being cloned, reducing network and local storage costs. |
Brandon Casey | 2498a1a | 2008-04-03 13:26:13 -0500 | [diff] [blame] | 103 | + |
Björn Gustavsson | 550c66f | 2009-10-20 22:38:38 +0200 | [diff] [blame] | 104 | *NOTE*: see the NOTE for the `--shared` option. |
Shawn Pearce | 23edecb | 2006-04-18 20:19:48 -0400 | [diff] [blame] | 105 | |
Eric W. Biederman | a2775c2 | 2005-10-02 13:42:57 -0600 | [diff] [blame] | 106 | --quiet:: |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 107 | -q:: |
Tay Ray Chuan | 488c316 | 2009-12-26 01:12:04 +0800 | [diff] [blame] | 108 | Operate quietly. Progress is not reported to the standard |
| 109 | error stream. This flag is also passed to the `rsync' |
Steve Haslam | d3296e3 | 2008-07-25 19:37:48 +0100 | [diff] [blame] | 110 | command when given. |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 111 | |
Miklos Vajna | 21188b1 | 2008-10-09 01:40:32 +0200 | [diff] [blame] | 112 | --verbose:: |
| 113 | -v:: |
Tay Ray Chuan | c54b74a | 2010-02-24 20:50:20 +0800 | [diff] [blame] | 114 | Run verbosely. Does not affect the reporting of progress status |
| 115 | to the standard error stream. |
Tay Ray Chuan | 5a518ad | 2009-12-26 01:12:06 +0800 | [diff] [blame] | 116 | |
| 117 | --progress:: |
Tay Ray Chuan | 488c316 | 2009-12-26 01:12:04 +0800 | [diff] [blame] | 118 | Progress status is reported on the standard error stream |
| 119 | by default when it is attached to a terminal, unless -q |
| 120 | is specified. This flag forces progress status even if the |
| 121 | standard error stream is not directed to a terminal. |
Miklos Vajna | 21188b1 | 2008-10-09 01:40:32 +0200 | [diff] [blame] | 122 | |
Jakub Narebski | fd0368f | 2007-07-13 01:54:07 +0200 | [diff] [blame] | 123 | --no-checkout:: |
Eric W. Biederman | a2775c2 | 2005-10-02 13:42:57 -0600 | [diff] [blame] | 124 | -n:: |
| 125 | No checkout of HEAD is performed after the clone is complete. |
| 126 | |
Junio C Hamano | 87e80c4 | 2006-01-22 17:24:22 -0800 | [diff] [blame] | 127 | --bare:: |
Thomas Ackermann | 48a8c26 | 2013-01-21 20:16:20 +0100 | [diff] [blame] | 128 | Make a 'bare' Git repository. That is, instead of |
Junio C Hamano | 8a1a120 | 2006-01-14 16:00:32 -0800 | [diff] [blame] | 129 | creating `<directory>` and placing the administrative |
| 130 | files in `<directory>/.git`, make the `<directory>` |
Petr Baudis | 7182135 | 2006-11-23 23:58:35 +0100 | [diff] [blame] | 131 | itself the `$GIT_DIR`. This obviously implies the `-n` |
| 132 | because there is nowhere to check out the working tree. |
| 133 | Also the branch heads at the remote are copied directly |
| 134 | to corresponding local branch heads, without mapping |
| 135 | them to `refs/remotes/origin/`. When this option is |
J. Bruce Fields | 36566cc | 2006-12-31 18:47:34 -0500 | [diff] [blame] | 136 | used, neither remote-tracking branches nor the related |
| 137 | configuration variables are created. |
Junio C Hamano | 8a1a120 | 2006-01-14 16:00:32 -0800 | [diff] [blame] | 138 | |
Johannes Schindelin | bc699af | 2008-08-02 21:38:56 +0200 | [diff] [blame] | 139 | --mirror:: |
Uwe Kleine-König | 6db2103 | 2010-10-04 19:28:27 +0200 | [diff] [blame] | 140 | Set up a mirror of the source repository. This implies `--bare`. |
| 141 | Compared to `--bare`, `--mirror` not only maps local branches of the |
| 142 | source to local branches of the target, it maps all refs (including |
Matthieu Moy | 29b9a66 | 2010-11-02 16:31:24 +0100 | [diff] [blame] | 143 | remote-tracking branches, notes etc.) and sets up a refspec configuration such |
Uwe Kleine-König | 6db2103 | 2010-10-04 19:28:27 +0200 | [diff] [blame] | 144 | that all these refs are overwritten by a `git remote update` in the |
| 145 | target repository. |
Johannes Schindelin | bc699af | 2008-08-02 21:38:56 +0200 | [diff] [blame] | 146 | |
Andy Parkins | ba158a3 | 2006-11-02 12:11:56 +0100 | [diff] [blame] | 147 | --origin <name>:: |
Johannes Schindelin | e6c310f | 2005-12-22 23:37:24 +0100 | [diff] [blame] | 148 | -o <name>:: |
Björn Gustavsson | 550c66f | 2009-10-20 22:38:38 +0200 | [diff] [blame] | 149 | Instead of using the remote name `origin` to keep track |
| 150 | of the upstream repository, use `<name>`. |
Johannes Schindelin | e6c310f | 2005-12-22 23:37:24 +0100 | [diff] [blame] | 151 | |
Jeff King | 7a4ee28 | 2009-08-26 15:05:08 -0400 | [diff] [blame] | 152 | --branch <name>:: |
| 153 | -b <name>:: |
| 154 | Instead of pointing the newly created HEAD to the branch pointed |
Björn Gustavsson | 550c66f | 2009-10-20 22:38:38 +0200 | [diff] [blame] | 155 | to by the cloned repository's HEAD, point to `<name>` branch |
Ralf Thielow | 31b808a | 2012-09-20 20:04:08 +0200 | [diff] [blame] | 156 | instead. In a non-bare repository, this is the branch that will |
| 157 | be checked out. |
| 158 | `--branch` can also take tags and detaches the HEAD at that commit |
| 159 | in the resulting repository. |
Jeff King | 7a4ee28 | 2009-08-26 15:05:08 -0400 | [diff] [blame] | 160 | |
Eric W. Biederman | a2775c2 | 2005-10-02 13:42:57 -0600 | [diff] [blame] | 161 | --upload-pack <upload-pack>:: |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 162 | -u <upload-pack>:: |
Steve Haslam | d3296e3 | 2008-07-25 19:37:48 +0100 | [diff] [blame] | 163 | When given, and the repository to clone from is accessed |
| 164 | via ssh, this specifies a non-default path for the command |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 165 | run on the other end. |
| 166 | |
Junio C Hamano | a57c8ba | 2006-05-28 10:14:38 -0700 | [diff] [blame] | 167 | --template=<template_directory>:: |
| 168 | Specify the directory from which templates will be used; |
Steven Drake | d8a8488 | 2010-02-17 12:44:46 +1300 | [diff] [blame] | 169 | (See the "TEMPLATE DIRECTORY" section of linkgit:git-init[1].) |
Junio C Hamano | a57c8ba | 2006-05-28 10:14:38 -0700 | [diff] [blame] | 170 | |
Jeff King | 84054f7 | 2011-06-09 16:56:19 -0400 | [diff] [blame] | 171 | --config <key>=<value>:: |
| 172 | -c <key>=<value>:: |
| 173 | Set a configuration variable in the newly-created repository; |
| 174 | this takes effect immediately after the repository is |
| 175 | initialized, but before the remote history is fetched or any |
| 176 | files checked out. The key is in the same format as expected by |
| 177 | linkgit:git-config[1] (e.g., `core.eol=true`). If multiple |
| 178 | values are given for the same key, each value will be written to |
| 179 | the config file. This makes it safe, for example, to add |
| 180 | additional fetch refspecs to the origin remote. |
| 181 | |
Christian Schlotter | f496454 | 2007-02-19 13:35:35 +0100 | [diff] [blame] | 182 | --depth <depth>:: |
Junio C Hamano | f4bf218 | 2007-01-01 15:08:06 -0800 | [diff] [blame] | 183 | Create a 'shallow' clone with a history truncated to the |
Ralf Wildenhues | d9d10bb | 2007-11-01 09:46:02 +0100 | [diff] [blame] | 184 | specified number of revisions. A shallow repository has a |
Junio C Hamano | 5333f2a | 2013-07-15 08:31:52 -0700 | [diff] [blame] | 185 | number of limitations (you cannot clone or fetch from |
| 186 | it, nor push from nor into it), but is adequate if you |
| 187 | are only interested in the recent history of a large project |
| 188 | with a long history, and would want to send in fixes |
| 189 | as patches. |
Junio C Hamano | f4bf218 | 2007-01-01 15:08:06 -0800 | [diff] [blame] | 190 | |
Felipe Contreras | 0460ed2 | 2013-05-08 20:16:55 -0500 | [diff] [blame] | 191 | --[no-]single-branch:: |
Nguyễn Thái Ngọc Duy | 3e6e0ed | 2012-01-07 21:45:59 +0700 | [diff] [blame] | 192 | Clone only the history leading to the tip of a single branch, |
| 193 | either specified by the `--branch` option or the primary |
| 194 | branch remote's `HEAD` points at. When creating a shallow |
| 195 | clone with the `--depth` option, this is the default, unless |
| 196 | `--no-single-branch` is given to fetch the histories near the |
| 197 | tips of all branches. |
Ralf Thielow | 31b808a | 2012-09-20 20:04:08 +0200 | [diff] [blame] | 198 | Further fetches into the resulting repository will only update the |
Matthieu Moy | a6d3bde | 2012-10-23 13:34:05 +0200 | [diff] [blame] | 199 | remote-tracking branch for the branch this option was used for the |
Ralf Thielow | 31b808a | 2012-09-20 20:04:08 +0200 | [diff] [blame] | 200 | initial cloning. If the HEAD at the remote did not point at any |
Matthieu Moy | a6d3bde | 2012-10-23 13:34:05 +0200 | [diff] [blame] | 201 | branch when `--single-branch` clone was made, no remote-tracking |
Ralf Thielow | 31b808a | 2012-09-20 20:04:08 +0200 | [diff] [blame] | 202 | branch is created. |
Nguyễn Thái Ngọc Duy | 3e6e0ed | 2012-01-07 21:45:59 +0700 | [diff] [blame] | 203 | |
Johan Herland | e7fed18 | 2009-08-20 01:07:43 +0200 | [diff] [blame] | 204 | --recursive:: |
Jens Lehmann | ccdd3da | 2010-11-04 21:27:12 +0100 | [diff] [blame] | 205 | --recurse-submodules:: |
Johan Herland | e7fed18 | 2009-08-20 01:07:43 +0200 | [diff] [blame] | 206 | After the clone is created, initialize all submodules within, |
| 207 | using their default settings. This is equivalent to running |
Björn Gustavsson | 550c66f | 2009-10-20 22:38:38 +0200 | [diff] [blame] | 208 | `git submodule update --init --recursive` immediately after |
Johan Herland | e7fed18 | 2009-08-20 01:07:43 +0200 | [diff] [blame] | 209 | the clone is finished. This option is ignored if the cloned |
| 210 | repository does not have a worktree/checkout (i.e. if any of |
| 211 | `--no-checkout`/`-n`, `--bare`, or `--mirror` is given) |
| 212 | |
Nguyễn Thái Ngọc Duy | b57fb80 | 2011-03-19 22:16:56 +0700 | [diff] [blame] | 213 | --separate-git-dir=<git dir>:: |
| 214 | Instead of placing the cloned repository where it is supposed |
| 215 | to be, place the cloned repository at the specified directory, |
Thomas Ackermann | 2de9b71 | 2013-01-21 20:17:53 +0100 | [diff] [blame] | 216 | then make a filesytem-agnostic Git symbolic link to there. |
| 217 | The result is Git repository can be separated from working |
Nguyễn Thái Ngọc Duy | b57fb80 | 2011-03-19 22:16:56 +0700 | [diff] [blame] | 218 | tree. |
| 219 | |
| 220 | |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 221 | <repository>:: |
Andrew Ruder | 37ba056 | 2007-07-04 17:21:36 -0500 | [diff] [blame] | 222 | The (possibly remote) repository to clone from. See the |
| 223 | <<URLS,URLS>> section below for more information on specifying |
| 224 | repositories. |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 225 | |
| 226 | <directory>:: |
Uwe Zeisberger | fb6a9f9 | 2006-06-08 08:50:09 +0200 | [diff] [blame] | 227 | The name of a new directory to clone into. The "humanish" |
Andreas Ericsson | 0879aa2 | 2005-11-10 12:58:08 +0100 | [diff] [blame] | 228 | part of the source repository is used if no directory is |
Björn Gustavsson | 550c66f | 2009-10-20 22:38:38 +0200 | [diff] [blame] | 229 | explicitly given (`repo` for `/path/to/repo.git` and `foo` |
| 230 | for `host.xz:foo/.git`). Cloning into an existing directory |
Alexander Potashev | ec00d6e | 2009-05-07 16:04:08 +0400 | [diff] [blame] | 231 | is only allowed if the directory is empty. |
Junio C Hamano | 4607166 | 2005-11-05 22:26:52 -0800 | [diff] [blame] | 232 | |
Sergei Organov | 347989f | 2007-11-16 21:43:16 +0300 | [diff] [blame] | 233 | :git-clone: 1 |
Andrew Ruder | 37ba056 | 2007-07-04 17:21:36 -0500 | [diff] [blame] | 234 | include::urls.txt[] |
| 235 | |
Junio C Hamano | 1e2ccd3 | 2005-12-12 23:24:06 -0800 | [diff] [blame] | 236 | Examples |
sean | 2b5f3ed | 2006-05-05 15:05:10 -0400 | [diff] [blame] | 237 | -------- |
Junio C Hamano | 1e2ccd3 | 2005-12-12 23:24:06 -0800 | [diff] [blame] | 238 | |
Michael J Gruber | 4763868 | 2010-03-21 18:30:19 +0100 | [diff] [blame] | 239 | * Clone from upstream: |
Junio C Hamano | 1e2ccd3 | 2005-12-12 23:24:06 -0800 | [diff] [blame] | 240 | + |
| 241 | ------------ |
W. Trevor King | 283efb0 | 2013-06-22 10:46:27 -0400 | [diff] [blame] | 242 | $ git clone git://git.kernel.org/pub/scm/.../linux.git my-linux |
| 243 | $ cd my-linux |
Junio C Hamano | 1e2ccd3 | 2005-12-12 23:24:06 -0800 | [diff] [blame] | 244 | $ make |
| 245 | ------------ |
| 246 | |
| 247 | |
Michael J Gruber | 4763868 | 2010-03-21 18:30:19 +0100 | [diff] [blame] | 248 | * Make a local clone that borrows from the current directory, without checking things out: |
Junio C Hamano | 1e2ccd3 | 2005-12-12 23:24:06 -0800 | [diff] [blame] | 249 | + |
| 250 | ------------ |
| 251 | $ git clone -l -s -n . ../copy |
Steffen Prohaska | a6e3768 | 2007-05-12 13:32:34 +0200 | [diff] [blame] | 252 | $ cd ../copy |
Junio C Hamano | 1e2ccd3 | 2005-12-12 23:24:06 -0800 | [diff] [blame] | 253 | $ git show-branch |
| 254 | ------------ |
| 255 | |
Junio C Hamano | 8a1a120 | 2006-01-14 16:00:32 -0800 | [diff] [blame] | 256 | |
Michael J Gruber | 4763868 | 2010-03-21 18:30:19 +0100 | [diff] [blame] | 257 | * Clone from upstream while borrowing from an existing local directory: |
Shawn Pearce | 23edecb | 2006-04-18 20:19:48 -0400 | [diff] [blame] | 258 | + |
| 259 | ------------ |
W. Trevor King | f22a654 | 2013-06-22 10:46:25 -0400 | [diff] [blame] | 260 | $ git clone --reference /git/linux.git \ |
| 261 | git://git.kernel.org/pub/scm/.../linux.git \ |
| 262 | my-linux |
| 263 | $ cd my-linux |
Shawn Pearce | 23edecb | 2006-04-18 20:19:48 -0400 | [diff] [blame] | 264 | ------------ |
| 265 | |
| 266 | |
Michael J Gruber | 4763868 | 2010-03-21 18:30:19 +0100 | [diff] [blame] | 267 | * Create a bare repository to publish your changes to the public: |
Junio C Hamano | 8a1a120 | 2006-01-14 16:00:32 -0800 | [diff] [blame] | 268 | + |
| 269 | ------------ |
Junio C Hamano | 87e80c4 | 2006-01-22 17:24:22 -0800 | [diff] [blame] | 270 | $ git clone --bare -l /home/proj/.git /pub/scm/proj.git |
Junio C Hamano | 8a1a120 | 2006-01-14 16:00:32 -0800 | [diff] [blame] | 271 | ------------ |
| 272 | |
| 273 | |
Junio C Hamano | 6ec311d | 2005-07-13 20:25:54 -0700 | [diff] [blame] | 274 | GIT |
| 275 | --- |
Christian Couder | 9e1f0a8 | 2008-06-06 09:07:32 +0200 | [diff] [blame] | 276 | Part of the linkgit:git[1] suite |