@git / git-reference / commits / dbdd946

Note difference on default behaviour on fetch/push on repo tags

Soon Van committed Dec 18, 2012 at 18:51 UTC dbdd946cd92bc13da11c6a80f6bb930731cd3702
1 file changed +10 -4
branching/index.html
+10 -4
@@ -774,10 +774,11 @@ ab5ab4c added erlang
774 * 17f4acf first commit
775 </pre>
776
777 - <p>By default, tags are not included when you <code>push</code> to or
778 - <code>fetch</code> from a remote repository. In order to explicitly
779 - update these you must include the <code>--tags</code> option to transfer
780 - all the tags on the repo.
777 + <p>Tags pointing to objects tracked from branch heads will be
778 + automatically downloaded when you <code>fetch</code> from a remote
779 + repository. However, tags that aren't reachable from branch heads
780 + will be skipped. If you want to make sure <em>all</em> tags are <em>always</em>
781 + included, you must include the <code>--tags</code> option.
782 </p>
783
784 <pre>
@@ -796,6 +797,11 @@ From git://github.com:example-user/example-repo
797 <code>git fetch &lt;remote> tag &lt;tag-name></code>.
798 </p>
799
800 + <p>By default, tags are not included when you <code>push</code> to
801 + a remote repository. In order to explicitly update these you must
802 + include the <code>--tags</code> option when using <code>git push</code>.
803 + </p>
804 +
805 <p class="nutshell">
806 <b>In a nutshell</b> you use <code>git tag</code> to mark a
807 commit or point in your repo as important. This also allows