.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-CLONE" "1" "06/16/2007" "Git 1.5.2.2.236.g952c8" "Git Manual"
+.TH "GIT\-CLONE" "1" "07/06/2007" "Git 1.5.3.rc0.39.g46f7" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
Create a \fIshallow\fR clone with a history truncated to the specified number of revs. A shallow repository has number of limitations (you cannot clone or fetch from it, nor push from nor into it), but is adequate if you want to only look at near the tip of a large project with a long history, and would want to send in a fixes as patches.
.TP
<repository>
-The (possibly remote) repository to clone from. It can be any URL git\-fetch supports.
+The (possibly remote) repository to clone from. See the URLS section below for more information on specifying repositories.
.TP
<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.
+.SH "GIT URLS"
+One of the following notations can be used to name the remote repository:
+.IP
+.TP 3
+\(bu
+rsync://host.xz/path/to/repo.git/
+.TP
+\(bu
+http://host.xz/path/to/repo.git/
+.TP
+\(bu
+https://host.xz/path/to/repo.git/
+.TP
+\(bu
+git://host.xz/path/to/repo.git/
+.TP
+\(bu
+git://host.xz/~user/path/to/repo.git/
+.TP
+\(bu
+ssh://[user@]host.xz/path/to/repo.git/
+.TP
+\(bu
+ssh://[user@]host.xz/~user/path/to/repo.git/
+.TP
+\(bu
+ssh://[user@]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:
+.IP
+.TP 3
+\(bu
+[user@]host.xz:/path/to/repo.git/
+.TP
+\(bu
+[user@]host.xz:~user/path/to/repo.git/
+.TP
+\(bu
+[user@]host.xz:path/to/repo.git
+
+To sync with a local directory, use:
+.IP
+.TP 3
+\(bu
+/path/to/repo.git/
.SH "EXAMPLES"
.TP
Clone from upstream
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-FETCH" "1" "06/16/2007" "Git 1.5.2.1.144.gabc40" "Git Manual"
+.TH "GIT\-FETCH" "1" "07/06/2007" "Git 1.5.3.rc0.39.g46f7" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-FILTER\-BRANCH" "1" "07/05/2007" "Git 1.5.3.rc0.30.g114f" "Git Manual"
+.TH "GIT\-FILTER\-BRANCH" "1" "07/06/2007" "Git 1.5.3.rc0.39.g46f7" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
Note that since this operation is extensively I/O expensive, it might be a good idea to redirect the temporary directory off\-disk, e.g. on tmpfs. Reportedly the speedup is very noticeable.
.SS "Filters"
-The filters are applied in the order as listed below. The <command> argument is always evaluated in shell using the \fIeval\fR command. Prior to that, the $GIT_COMMIT environment variable will be set to contain the id of the commit being rewritten. Also, GIT_AUTHOR_NAME, GIT_AUTHOR_EMAIL, GIT_AUTHOR_DATE, GIT_COMMITTER_NAME, GIT_COMMITTER_EMAIL, and GIT_COMMITTER_DATE are set according to the current commit.
+The filters are applied in the order as listed below. The <command> argument is always evaluated in shell using the \fIeval\fR command (with the notable exception of the commit filter, for technical reasons). Prior to that, the $GIT_COMMIT environment variable will be set to contain the id of the commit being rewritten. Also, GIT_AUTHOR_NAME, GIT_AUTHOR_EMAIL, GIT_AUTHOR_DATE, GIT_COMMITTER_NAME, GIT_COMMITTER_EMAIL, and GIT_COMMITTER_DATE are set according to the current commit.
A \fImap\fR function is available that takes an "original sha1 id" argument and outputs a "rewritten sha1 id" if the commit has been already rewritten, and "original sha1 id" otherwise; the \fImap\fR function can return several ids on separate lines if your commit filter emitted multiple commits.
.SH "OPTIONS"
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-PULL" "1" "06/16/2007" "Git 1.5.2.1.144.gabc40" "Git Manual"
+.TH "GIT\-PULL" "1" "07/06/2007" "Git 1.5.3.rc0.39.g46f7" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-PUSH" "1" "06/16/2007" "Git 1.5.2.2.236.g952c8" "Git Manual"
+.TH "GIT\-PUSH" "1" "07/06/2007" "Git 1.5.3.rc0.39.g46f7" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
projects / git.git / commitdiff