org.eclipse.egit.doc/help/EGit/User_Guide/Tags.html

   1 <?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   2 <html xmlns="http://www.w3.org/1999/xhtml">
   3         <head>
   4                 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
   5                 <title>EGit User Guide - Tags</title>
   6                 <link type="text/css" rel="stylesheet" href="../../book.css"/>
   7         </head>
   8         <body>
   9                 <table class="navigation" style="width: 100%;" border="0" summary="navigation">
  10                         <tr>
  11                                 <th style="width: 100%" align="center" colspan="3">Tags</th>
  12                         </tr>
  13                         <tr>
  14                                 <td style="width: 20%" align="left">
  15                                         <a href="Merge.html" title="Merge">
  16                                                 <img alt="Previous" border="0" src="../../images/prev.gif"/>
  17                                         </a>
  18                                 </td>
  19                                 <td style="width: 60%" align="center"></td>
  20                                 <td style="width: 20%" align="right">
  21                                         <a href="Patches.html" title="Patches">
  22                                                 <img alt="Next" border="0" src="../../images/next.gif"/>
  23                                         </a>
  24                                 </td>
  25                         </tr>
  26                         <tr>
  27                                 <td style="width: 20%" align="left" valign="top">Merge</td>
  28                                 <td style="width: 60%" align="center"></td>
  29                                 <td style="width: 20%" align="right" valign="top">Patches</td>
  30                         </tr>
  31                 </table><hr/>
  32                 <h1 id="Tags">Tags</h1>
  33                 <h2 id="Creating_a_Tag">Creating a Tag</h2>
  34                 <ul>
  35                         <li>Select "Team" -&gt; "Tag..." from the project context menu.</li>
  36                 </ul>
  37                 <p>
  38                         <img border="0" src="images/Egit-0.8-tag-create.png"/>
  39                 </p>
  40                 <ul>
  41                         <li>Enter the tag name</li>
  42                         <li>Enter the tag message</li>
  43                         <li>Optionally select the commit you want to tag (default is HEAD)</li>
  44                         <li>Click OK to create the annotated tag</li>
  45                 </ul>
  46                 <h2 id="Replacing_an_Existing_Tag">Replacing an Existing Tag</h2>
  47                 <p>What to do if you tagged the wrong commit or ended up with some sort of typo ?</p>
  48                 <ul>
  49                         <li>If you didn't yet push this out just replace the tag and you are done.</li>
  50                         <li>If it's already published you shouldn't replace the tag but use a new name since otherwise you have to tell everybody who got the old tag to replace it manually with your updated one. This is because, Git does not (and it should not) change tags behind users back. So if somebody already got the old tag, doing a git pull on your tree shouldn't just make them overwrite the old one.</li>
  51                 </ul>
  52                 <p>
  53                         <br/>
  54                 </p>
  55                 <p>So if your old tag wasn't yet pushed you may correct it in the following way :</p>
  56                 <ul>
  57                         <li>Select "Team" -&gt; "Tag..." from the project context menu.</li>
  58                 </ul>
  59                 <p>
  60                         <img border="0" src="images/Egit-0.8-tag-replace.png"/>
  61                 </p>
  62                 <ul>
  63                         <li>Select the tag you want to replace from the list of existing tags</li>
  64                         <li>or start typing any part of the tag you look for into the Tag Name field, this will filter the list of existing tags to those tags which contain the string you are typing, then select the tag you want to replace</li>
  65                         <li>Mark the checkbox "Force replace existing tag"</li>
  66                         <li>Change the tag and press "OK"</li>
  67                 </ul>
  68                 <h2 id="Light-weight_and_Signed_Tags">Light-weight and Signed Tags</h2>
  69                 <p>Light-weight and signed tags are not yet supported by EGit, use command line <tt>git tag</tt> or <tt>git tag -s</tt> as a workaround</p><hr/>
  70                 <table class="navigation" style="width: 100%;" border="0" summary="navigation">
  71                         <tr>
  72                                 <td style="width: 20%" align="left">
  73                                         <a href="Merge.html" title="Merge">
  74                                                 <img alt="Previous" border="0" src="../../images/prev.gif"/>
  75                                         </a>
  76                                 </td>
  77                                 <td style="width: 60%" align="center">
  78                                         <a href="User-Guide.html" title="EGit User Guide">
  79                                                 <img alt="EGit User Guide" border="0" src="../../images/home.gif"/>
  80                                         </a>
  81                                 </td>
  82                                 <td style="width: 20%" align="right">
  83                                         <a href="Patches.html" title="Patches">
  84                                                 <img alt="Next" border="0" src="../../images/next.gif"/>
  85                                         </a>
  86                                 </td>
  87                         </tr>
  88                         <tr>
  89                                 <td style="width: 20%" align="left" valign="top">Merge</td>
  90                                 <td style="width: 60%" align="center"></td>
  91                                 <td style="width: 20%" align="right" valign="top">Patches</td>
  92                         </tr>
  93                 </table>
  94         </body>
  95 </html>