diff options
| author | Junio C Hamano <junio@hera.kernel.org> | 2006-02-07 08:04:39 +0000 |
|---|---|---|
| committer | Junio C Hamano <junio@hera.kernel.org> | 2006-02-07 08:04:39 +0000 |
| commit | 40f2f8dd79c1622a7986e2ff2faa15c72860c79f (patch) | |
| tree | 8caad58489c0d80a936d8185c85f45f19cf0703e /git-push.html | |
| parent | 5e461f9764f680aa78a7c16f1c9182dc36961662 (diff) | |
| download | git-htmldocs-40f2f8dd79c1622a7986e2ff2faa15c72860c79f.tar.gz | |
Autogenerated HTML docs for v1.1.6-g5a79
Diffstat (limited to 'git-push.html')
| -rw-r--r-- | git-push.html | 223 |
1 files changed, 80 insertions, 143 deletions
diff --git a/git-push.html b/git-push.html index c74e3a62e..5bf5b062d 100644 --- a/git-push.html +++ b/git-push.html @@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 7.0.1" />
+<meta name="generator" content="AsciiDoc 7.0.2" />
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@@ -278,7 +278,7 @@ git-push(1) Manual Page <div class="sectionbody">
<p>Updates remote refs using local refs, while sending objects
necessary to complete the given refs.</p>
-<p>You can make "interesting" things to happen on the repository
+<p>You can make interesting things happen to a repository
every time you push into it, by setting up <em>hooks</em> there. See
documentation for <a href="git-receive-pack.html">git-receive-pack(1)</a>.</p>
</div>
@@ -290,11 +290,80 @@ documentation for <a href="git-receive-pack.html">git-receive-pack(1)</a>.</p> </dt>
<dd>
<p>
- The "remote" repository that is the source of a fetch
- or pull operation, or the destination of a push operation.
- One of the following notations can be used
- to name the remote repository:
+ The "remote" repository that is destination of a push
+ operation. See the section <a href="#URLS">GIT URLS</a> below.
</p>
+</dd>
+<dt>
+<refspec>
+</dt>
+<dd>
+<p>
+ The canonical format of a <refspec> parameter is
+ <tt>+?<src>:<dst></tt>; that is, an optional plus <tt>+</tt>, followed
+ by the source ref, followed by a colon <tt>:</tt>, followed by
+ the destination ref.
+</p>
+<p>The <src> side can be an
+arbitrary "SHA1 expression" that can be used as an
+argument to <tt>git-cat-file -t</tt>. E.g. <tt>master~4</tt> (push
+four parents before the current master head).</p>
+<p>The local ref that matches <src> is used
+to fast forward the remote ref that matches <dst>. If
+the optional plus <tt>+</tt> is used, the remote ref is updated
+even if it does not result in a fast forward update.</p>
+<p>Some short-cut notations are also supported.</p>
+<ul>
+<li>
+<p>
+<tt>tag <tag></tt> means the same as <tt>refs/tags/<tag>:refs/tags/<tag></tt>.
+</p>
+</li>
+<li>
+<p>
+A parameter <ref> without a colon is equivalent to
+ <ref><tt>:</tt><ref>, hence updates <ref> in the destination from <ref>
+ in the source.
+</p>
+</li>
+</ul>
+</dd>
+<dt>
+--all
+</dt>
+<dd>
+<p>
+ Instead of naming each ref to push, specifies that all
+ refs be pushed.
+</p>
+</dd>
+<dt>
+--tags
+</dt>
+<dd>
+<p>
+ All refs under <tt>$GIT_DIR/refs/tags</tt> are pushed, in
+ addition to refspecs explicitly listed on the command
+ line.
+</p>
+</dd>
+<dt>
+-f, --force
+</dt>
+<dd>
+<p>
+ Usually, the command refuses to update a remote ref that is
+ not a descendent of the local ref used to overwrite it.
+ This flag disables the check. This can cause the
+ remote repository to lose commits; use it with care.
+</p>
+</dd>
+</dl>
+</div>
+<h2>GIT URLS<a id="URLS"></a></h2>
+<div class="sectionbody">
+<p>One of the following notations can be used
+to name the remote repository:</p>
<div class="exampleblock">
<div class="exampleblock-content">
<ul>
@@ -375,6 +444,9 @@ host.xz:path/to/repo.git </li>
</ul>
</div></div>
+</div>
+<h2>REMOTES</h2>
+<div class="sectionbody">
<p>In addition to the above, as a short-hand, the name of a
file in <tt>$GIT_DIR/remotes</tt> directory can be given; the
named file should be in the following format:</p>
@@ -384,7 +456,7 @@ named file should be in the following format:</p> Push: <refspec>
Pull: <refspec></tt></pre>
</div></div>
-<p>When such a short-hand is specified in place of
+<p>Then such a short-hand is specified in place of
<repository> without <refspec> parameters on the command
line, <refspec> specified on <tt>Push:</tt> lines or <tt>Pull:</tt>
lines are used for <tt>git-push</tt> and <tt>git-fetch</tt>/<tt>git-pull</tt>,
@@ -409,141 +481,6 @@ Pull: refs/heads/master:<remote></tt></pre> <pre><tt>URL: <url>
Pull: refs/heads/<head>:<remote></tt></pre>
</div></div>
-</dd>
-<dt>
-<refspec>
-</dt>
-<dd>
-<p>
- The canonical format of a <refspec> parameter is
- <tt>+?<src>:<dst></tt>; that is, an optional plus <tt>+</tt>, followed
- by the source ref, followed by a colon <tt>:</tt>, followed by
- the destination ref.
-</p>
-<p>When used in <tt>git-push</tt>, the <src> side can be an
-arbitrary "SHA1 expression" that can be used as an
-argument to <tt>git-cat-file -t</tt>. E.g. <tt>master~4</tt> (push
-four parents before the current master head).</p>
-<p>For <tt>git-push</tt>, the local ref that matches <src> is used
-to fast forward the remote ref that matches <dst>. If
-the optional plus <tt>+</tt> is used, the remote ref is updated
-even if it does not result in a fast forward update.</p>
-<p>For <tt>git-fetch</tt> and <tt>git-pull</tt>, the remote ref that matches <src>
-is fetched, and if <dst> is not empty string, the local
-ref that matches it is fast forwarded using <src>.
-Again, if the optional plus <tt>+</tt> is used, the local ref
-is updated even if it does not result in a fast forward
-update.</p>
-<div class="admonitionblock">
-<table><tr>
-<td class="icon">
-<div class="title">Note</div>
-</td>
-<td class="content">If the remote branch from which you want to pull is
-modified in non-linear ways such as being rewound and
-rebased frequently, then a pull will attempt a merge with
-an older version of itself, likely conflict, and fail.
-It is under these conditions that you would want to use
-the <tt>+</tt> sign to indicate non-fast-forward updates will
-be needed. There is currently no easy way to determine
-or declare that a branch will be made available in a
-repository with this behavior; the pulling user simply
-must know this is the expected usage pattern for a branch.</td>
-</tr></table>
-</div>
-<div class="admonitionblock">
-<table><tr>
-<td class="icon">
-<div class="title">Note</div>
-</td>
-<td class="content">You never do your own development on branches that appear
-on the right hand side of a <refspec> colon on <tt>Pull:</tt> lines;
-they are to be updated by <tt>git-fetch</tt>. If you intend to do
-development derived from a remote branch <tt>B</tt>, have a <tt>Pull:</tt>
-line to track it (i.e. <tt>Pull: B:remote-B</tt>), and have a separate
-branch <tt>my-B</tt> to do your development on top of it. The latter
-is created by <tt>git branch my-B remote-B</tt> (or its equivalent <tt>git
-checkout -b my-B remote-B</tt>). Run <tt>git fetch</tt> to keep track of
-the progress of the remote side, and when you see something new
-on the remote branch, merge it into your development branch with
-<tt>git pull . remote-B</tt>, while you are on <tt>my-B</tt> branch.
-The common <tt>Pull: master:origin</tt> mapping of a remote <tt>master</tt>
-branch to a local <tt>origin</tt> branch, which is then merged to a
-local development branch, again typically named <tt>master</tt>, is made
-when you run <tt>git clone</tt> for you to follow this pattern.</td>
-</tr></table>
-</div>
-<div class="admonitionblock">
-<table><tr>
-<td class="icon">
-<div class="title">Note</div>
-</td>
-<td class="content">There is a difference between listing multiple <refspec>
-directly on <tt>git-pull</tt> command line and having multiple
-<tt>Pull:</tt> <refspec> lines for a <repository> and running
-<tt>git-pull</tt> command without any explicit <refspec> parameters.
-<refspec> listed explicitly on the command line are always
-merged into the current branch after fetching. In other words,
-if you list more than one remote refs, you would be making
-an Octopus. While <tt>git-pull</tt> run without any explicit <refspec>
-parameter takes default <refspec>s from <tt>Pull:</tt> lines, it
-merges only the first <refspec> found into the current branch,
-after fetching all the remote refs. This is because making an
-Octopus from remote refs is rarely done, while keeping track
-of multiple remote heads in one-go by fetching more than one
-is often useful.</td>
-</tr></table>
-</div>
-<p>Some short-cut notations are also supported.</p>
-<ul>
-<li>
-<p>
-<tt>tag <tag></tt> means the same as <tt>refs/tags/<tag>:refs/tags/<tag></tt>;
- used with pull or fetch, it requests fetching everything up to
- the given tag.
-</p>
-</li>
-<li>
-<p>
-A parameter <ref> without a colon is equivalent to
- <ref>: when pulling/fetching, and <ref><tt>:</tt><ref> when
- pushing. That is, do not store it locally if
- fetching, and update the same name if pushing.
-</p>
-</li>
-</ul>
-</dd>
-<dt>
---all
-</dt>
-<dd>
-<p>
- Instead of naming each ref to push, specifies all refs
- to be pushed.
-</p>
-</dd>
-<dt>
---tags
-</dt>
-<dd>
-<p>
- All refs under <tt>$GIT_DIR/refs/tags</tt> are pushed, in
- addition to refspecs explicitly listed on the command
- line.
-</p>
-</dd>
-<dt>
--f, --force
-</dt>
-<dd>
-<p>
- Usually, the command refuses to update a remote ref that is
- not a descendent of the local ref used to overwrite it.
- This flag disables the check. This can cause the
- remote repository to lose commits; use it with care.
-</p>
-</dd>
-</dl>
</div>
<h2>Author</h2>
<div class="sectionbody">
@@ -559,7 +496,7 @@ A parameter <ref> without a colon is equivalent to </div>
<div id="footer">
<div id="footer-text">
-Last updated 29-Jan-2006 20:18:18 PDT
+Last updated 07-Feb-2006 08:04:31 UTC
</div>
</div>
</body>
|