4607166d07
Josef Weidendorfer points out that git-clone documentation does not mention the initial copying of remote branch heads into corresponding local branches. Also clarify the purpose of the ref mappings description in the "remotes" file and recommended workflow. Signed-off-by: Junio C Hamano <junkio@cox.net>
87 lines
2.1 KiB
Plaintext
87 lines
2.1 KiB
Plaintext
git-clone(1)
|
|
============
|
|
|
|
NAME
|
|
----
|
|
git-clone - Clones a repository.
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
'git-clone' [-l [-s]] [-q] [-n] [-u <upload-pack>] <repository> <directory>
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Clones a repository into a newly created directory. All remote
|
|
branch heads are copied under `$GIT_DIR/refs/heads/`, except
|
|
that the remote `master` is also copied to `origin` branch.
|
|
|
|
In addition, `$GIT_DIR/remotes/origin` file is set up to have
|
|
this line:
|
|
|
|
Pull: master:origin
|
|
|
|
This is to help the typical workflow of working off of the
|
|
remote `master` branch. Every time `git pull` without argument
|
|
is run, the progress on the remote `master` branch is tracked by
|
|
copying it into the local `origin` branch, and merged into the
|
|
branch you are currently working on.
|
|
|
|
|
|
OPTIONS
|
|
-------
|
|
--local::
|
|
-l::
|
|
When the repository to clone from is on a local machine,
|
|
this flag bypasses normal "git aware" transport
|
|
mechanism and clones the repository by making a copy of
|
|
HEAD and everything under objects and refs directories.
|
|
The files under .git/objects/ directory are hardlinked
|
|
to save space when possible.
|
|
|
|
--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.
|
|
|
|
--quiet::
|
|
-q::
|
|
Operate quietly. This flag is passed to "rsync" and
|
|
"git-clone-pack" commands when given.
|
|
|
|
-n::
|
|
No checkout of HEAD is performed after the clone is complete.
|
|
|
|
--upload-pack <upload-pack>::
|
|
-u <upload-pack>::
|
|
When given, and the repository to clone from is handled
|
|
by 'git-clone-pack', '--exec=<upload-pack>' is passed to
|
|
the command to specify non-default path for the command
|
|
run on the other end.
|
|
|
|
<repository>::
|
|
The (possibly remote) repository to clone from. It can
|
|
be any URL git-fetch supports.
|
|
|
|
<directory>::
|
|
The name of a new directory to be cloned into. It is an
|
|
error to specify an existing directory.
|
|
|
|
|
|
Author
|
|
------
|
|
Written by Linus Torvalds <torvalds@osdl.org>
|
|
|
|
Documentation
|
|
--------------
|
|
Documentation by Junio C Hamano.
|
|
|
|
|
|
GIT
|
|
---
|
|
Part of the gitlink:git[7] suite
|
|
|