From 62eda5206070c994dcfd7423eebf501c0f8d4265 Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Fri, 6 Jul 2007 17:02:02 +0000 Subject: [PATCH] Autogenerated manpages for v1.5.3-rc0-39-g46f7 --- man1/git-clone.1 | 49 ++++++++++++++++++++++++++++++++++++++-- man1/git-fetch.1 | 2 +- man1/git-filter-branch.1 | 4 ++-- man1/git-pull.1 | 2 +- man1/git-push.1 | 2 +- 5 files changed, 52 insertions(+), 7 deletions(-) diff --git a/man1/git-clone.1 b/man1/git-clone.1 index dd8cc531d..9f7cbd100 100644 --- a/man1/git-clone.1 +++ b/man1/git-clone.1 @@ -2,7 +2,7 @@ .\" 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) @@ -55,10 +55,55 @@ Specify the directory from which templates will be used; if unset the templates 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 -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 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 diff --git a/man1/git-fetch.1 b/man1/git-fetch.1 index 2cfdf55bd..3d3715c3b 100644 --- a/man1/git-fetch.1 +++ b/man1/git-fetch.1 @@ -2,7 +2,7 @@ .\" 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) diff --git a/man1/git-filter-branch.1 b/man1/git-filter-branch.1 index 0f0084044..e5caff722 100644 --- a/man1/git-filter-branch.1 +++ b/man1/git-filter-branch.1 @@ -2,7 +2,7 @@ .\" 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) @@ -29,7 +29,7 @@ Always verify that the rewritten version is correct before disposing the origina 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 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 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" diff --git a/man1/git-pull.1 b/man1/git-pull.1 index 7f8fa38fb..65921b391 100644 --- a/man1/git-pull.1 +++ b/man1/git-pull.1 @@ -2,7 +2,7 @@ .\" 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) diff --git a/man1/git-push.1 b/man1/git-push.1 index e12158c0c..4752f3b16 100644 --- a/man1/git-push.1 +++ b/man1/git-push.1 @@ -2,7 +2,7 @@ .\" 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) -- 2.26.2