diff options
| author | Junio C Hamano <gitster@pobox.com> | 2007-08-10 23:05:04 -0700 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2007-08-10 23:05:04 -0700 |
| commit | fa548703d1e60231828266856467d3d73ac51f0f (patch) | |
| tree | 3ca496e49fefa959aaa0300d0e5cd7016f87715f /Documentation | |
| parent | 566b5c057c452d04605805ea2f7af210c6fb9b59 (diff) | |
| parent | 3d5c418ff56645e13bdbd8c9f7d84fdaf7c8494b (diff) | |
| download | git-fa548703d1e60231828266856467d3d73ac51f0f.tar.gz git-fa548703d1e60231828266856467d3d73ac51f0f.tar.xz | |
Merge branch 'jc/clone'
* jc/clone:
git-clone: aggressively optimize local clone behaviour.
connect: accept file:// URL scheme
Diffstat (limited to 'Documentation')
| -rw-r--r-- | Documentation/git-clone.txt | 18 | ||||
| -rw-r--r-- | Documentation/urls.txt | 16 |
2 files changed, 25 insertions, 9 deletions
diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt index a0a10e3e2..227f092e2 100644 --- a/Documentation/git-clone.txt +++ b/Documentation/git-clone.txt @@ -9,7 +9,8 @@ git-clone - Clone a repository into a new directory SYNOPSIS -------- [verse] -'git-clone' [--template=<template_directory>] [-l [-s]] [-q] [-n] [--bare] +'git-clone' [--template=<template_directory>] + [-l] [-s] [--no-hardlinks] [-q] [-n] [--bare] [-o <name>] [-u <upload-pack>] [--reference <repository>] [--depth <depth>] <repository> [<directory>] @@ -40,8 +41,19 @@ OPTIONS 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. + The files under `.git/objects/` directory are hardlinked + to save space when possible. This is now the default when + the source repository is specified with `/path/to/repo` + syntax, so it essentially is a no-op option. To force + copying instead of hardlinking (which may be desirable + if you are trying to make a back-up of your repository), + but still avoid the usual "git aware" transport + mechanism, `--no-hardlinks` can be used. + +--no-hardlinks:: + Optimize the cloning process from a repository on a + local filesystem by copying files under `.git/objects` + directory. --shared:: -s:: diff --git a/Documentation/urls.txt b/Documentation/urls.txt index 781df4174..b38145faf 100644 --- a/Documentation/urls.txt +++ b/Documentation/urls.txt @@ -15,11 +15,11 @@ to name the remote repository: - ssh://{startsb}user@{endsb}host.xz/~/path/to/repo.git =============================================================== -SSH is the default transport protocol. You can optionally specify -which user to log-in as, and an alternate, scp-like syntax is also -supported. Both syntaxes support username expansion, -as does the native git protocol. The following three are -identical to the last three above, respectively: +SSH is the default transport protocol over the network. You can +optionally specify which user to log-in as, and an alternate, +scp-like syntax is also supported. Both syntaxes support +username expansion, as does the native git protocol. The following +three are identical to the last three above, respectively: =============================================================== - {startsb}user@{endsb}host.xz:/path/to/repo.git/ @@ -27,8 +27,12 @@ identical to the last three above, respectively: - {startsb}user@{endsb}host.xz:path/to/repo.git =============================================================== -To sync with a local directory, use: +To sync with a local directory, you can use: =============================================================== - /path/to/repo.git/ +- file:///path/to/repo.git/ =============================================================== + +They are mostly equivalent, except when cloning. See +gitlink:git-clone[1] for details. |