RubyGems - wayfarer - Versions diffs - 0.4.7 → 0.4.9 - Mend

wayfarer 0.4.7 → 0.4.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (773) hide show

data/spec/support/static/git-scm.com/book/en/v2/Git-Basics-Tagging.html DELETED Viewed

@@ -1,1049 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <!-- Global site tag (gtag.js) - Google Analytics -->
-  <script async src="https://www.googletagmanager.com/gtag/js?id=UA-49925874-3"></script>
-  <script>
-    window.dataLayer = window.dataLayer || [];
-    function gtag(){dataLayer.push(arguments);}
-    gtag('js', new Date());
-    gtag('config', 'UA-49925874-3');
-  </script>
-  <meta charset='utf-8'>
-  <meta content='IE=edge,chrome=1' http-equiv='X-UA-Compatible'>
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Git - Tagging</title>
-  <link href='../../../favicon.ico' rel='shortcut icon' type='image/x-icon'>
-  <link rel="stylesheet" media="screen" href="../../../assets/application-cafcf280f67db0e6d8168ba98a38da878769a9d5f37793b68ffb963a02d185e0.css" />
-  <script src="../../../assets/modernize-b3ebe0c31c24f230dc62179d3e1030d2e57a53b1668d9382c0a27dbd44a94beb.js"></script>
-  <!--[if (gte IE 6)&(lte IE 8)]>
-  <script src="/javascripts/selectivizr-min.js"></script>
-  <![endif]-->
-</head>
-<body id="documentation">
-  <div class="inner">
-    <header>
-  <a href="https://git-scm.com/"><img src="../../../images/logo@2x.png" width="110" height="46" alt="Git" /></a>
-  <span id="tagline"></span>
-  <script type="text/javascript">
-    var taglines = ["fast-version-control","everything-is-local","distributed-even-if-your-workflow-isnt","local-branching-on-the-cheap","distributed-is-the-new-centralized"];
-    var tagline = taglines[Math.floor(Math.random() * taglines.length)];
-    document.getElementById('tagline').innerHTML = '--' + tagline;
-  </script>
-  <form id="search" action="https://git-scm.com/search/results">
-    <input id="search-text" name="search" placeholder="Search entire site..." autocomplete="off" type="text" />
-  </form>
-  <div id="search-results"></div>
-</header>
-  </div> <!-- .inner -->
-    <div class="inner">
-      <div id="content-wrapper">
-        <button class="sidebar-btn"></button>
-<aside class="sidebar" id="sidebar">
-  <nav>
-    <ul>
-      <li>
-        <a href="https://git-scm.com/about">About</a>
-        <ul class="">
-          <li>
-            <a href="https://git-scm.com/about">Branching and Merging</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/about/small-and-fast">Small and Fast</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/about/distributed">Distributed</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/about/info-assurance">Data Assurance</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/about/staging-area">Staging Area</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/about/free-and-open-source">Free and Open Source</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/about/trademark">Trademark</a>
-          </li>
-        </ul>
-      </li>
-      <li>
-        <a class="active" href="https://git-scm.com/doc">Documentation</a>
-        <ul class="expanded">
-          <li>
-            <a href="https://git-scm.com/docs">Reference</a>
-          </li>
-          <li>
-            <a class="active" href="https://git-scm.com/book">Book</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/videos">Videos</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/doc/ext">External Links</a>
-          </li>
-        </ul>
-      </li>
-      <li>
-        <a href="https://git-scm.com/downloads">Downloads</a>
-        <ul class="">
-          <li>
-            <a href="https://git-scm.com/downloads/guis">GUI Clients</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/downloads/logos">Logos</a>
-          </li>
-        </ul>
-      </li>
-      <li>
-        <a href="https://git-scm.com/community">Community</a>
-      </li>
-    </ul>
-      <hr class="sidebar">
-        <p>
-This book is available in
-  <a href="https://git-scm.com/book/en">English</a>.
-</p>
-<p>
-  Full translation available in
-  <table>
-    <tr><td><a href="https://git-scm.com/book/az">azərbaycan dili</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/bg">български език</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/de">Deutsch</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/es">Español</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/fr">Français</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/gr">Ελληνικά</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/ja">日本語</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/ko">한국어</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/nl">Nederlands</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/ru">Русский</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/sl">Slovenščina</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/tl">Tagalog</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/uk">Українська</a></td></tr>
-    <tr><td><a href="https://git-scm.com/book/zh">简体中文</a>,</td></tr>
-  </table>
-</p>
-<p>
-  Partial translations available in
-  <table>
-    <tr><td><a href="https://git-scm.com/book/cs">Čeština</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/mk">Македонски</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/pl">Polski</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/sr">Српски</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/uz">Ўзбекча</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/zh-tw">繁體中文</a>,</td></tr>
-  </table>
-</p>
-<p>
-  Translations started for
-  <table>
-    <tr><td><a href="https://git-scm.com/book/be">Беларуская</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/fa" dir="rtl">فارسی</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/id">Indonesian</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/it">Italiano</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/ms">Bahasa Melayu</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/pt-br">Português (Brasil)</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/pt-pt">Português (Portugal)</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/sv">Svenska</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/tr">Türkçe</a>.</td></tr>
-  </table>
-</p>
-<hr class="sidebar"/>
-<p>
-The source of this book is <a href="https://github.com/progit/progit2">hosted on GitHub.</a></br>
-Patches, suggestions and comments are welcome.
-</p>
-  </nav>
-</aside>
-        <div id="content">
-<div id='book-chapters'>
-  <a class="dropdown-trigger" id="book-chapters-trigger" data-panel-id="chapters-dropdown" href="ch00/_annotated_tags.html#">Chapters ▾</a>
-<div class='dropdown-panel' id='chapters-dropdown'>
-  <div class="three-column">
-    <div class='column-left'>
-      <ol class='book-toc'>
-  <li class='chapter'>
-  <h2>1. <a href="ch00/ch01-getting-started.html">Getting Started</a></h2>
-    <ol>
-        <li>
-          1.1
-          <a href="ch00/ch01-getting-started.html" >About Version Control </a>
-        </li>
-        <li>
-          1.2
-          <a href="Getting-Started-A-Short-History-of-Git.html" >A Short History of Git </a>
-        </li>
-        <li>
-          1.3
-          <a href="ch00/what_is_git_section.html" >What is Git? </a>
-        </li>
-        <li>
-          1.4
-          <a href="Getting-Started-The-Command-Line.html" >The Command Line </a>
-        </li>
-        <li>
-          1.5
-          <a href="Getting-Started-Installing-Git.html" >Installing Git </a>
-        </li>
-        <li>
-          1.6
-          <a href="ch00/_editor.html" >First-Time Git Setup </a>
-        </li>
-        <li>
-          1.7
-          <a href="ch00/_git_help.html" >Getting Help </a>
-        </li>
-        <li>
-          1.8
-          <a href="Getting-Started-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>2. <a href="ch00/_git_cloning.html">Git Basics</a></h2>
-    <ol>
-        <li>
-          2.1
-          <a href="ch00/_git_cloning.html" >Getting a Git Repository </a>
-        </li>
-        <li>
-          2.2
-          <a href="ch00/_git_mv.html" >Recording Changes to the Repository </a>
-        </li>
-        <li>
-          2.3
-          <a href="ch00/_viewing_history.html" >Viewing the Commit History </a>
-        </li>
-        <li>
-          2.4
-          <a href="ch00/_unstaging.html" >Undoing Things </a>
-        </li>
-        <li>
-          2.5
-          <a href="ch00/_remote_repos.html" >Working with Remotes </a>
-        </li>
-        <li>
-          2.6
-          <a href="ch00/_annotated_tags.html" class=active>Tagging </a>
-        </li>
-        <li>
-          2.7
-          <a href="ch00/_git_aliases.html" >Git Aliases </a>
-        </li>
-        <li>
-          2.8
-          <a href="Git-Basics-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>3. <a href="ch00/_switching_branches.html">Git Branching</a></h2>
-    <ol>
-        <li>
-          3.1
-          <a href="ch00/_switching_branches.html" >Branches in a Nutshell </a>
-        </li>
-        <li>
-          3.2
-          <a href="ch00/_basic_branching.html" >Basic Branching and Merging </a>
-        </li>
-        <li>
-          3.3
-          <a href="ch00/_branch_management.html" >Branch Management </a>
-        </li>
-        <li>
-          3.4
-          <a href="ch00/_topic_branch.html" >Branching Workflows </a>
-        </li>
-        <li>
-          3.5
-          <a href="ch00/_delete_branches.html" >Remote Branches </a>
-        </li>
-        <li>
-          3.6
-          <a href="ch00/_rebase_rebase.html" >Rebasing </a>
-        </li>
-        <li>
-          3.7
-          <a href="Git-Branching-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>4. <a href="Git-on-the-Server-The-Protocols.html">Git on the Server</a></h2>
-    <ol>
-        <li>
-          4.1
-          <a href="Git-on-the-Server-The-Protocols.html" >The Protocols </a>
-        </li>
-        <li>
-          4.2
-          <a href="ch00/_bare_repo.html" >Getting Git on a Server </a>
-        </li>
-        <li>
-          4.3
-          <a href="ch00/_generate_ssh_key.html" >Generating Your SSH Public Key </a>
-        </li>
-        <li>
-          4.4
-          <a href="ch00/_setting_up_server.html" >Setting Up the Server </a>
-        </li>
-        <li>
-          4.5
-          <a href="Git-on-the-Server-Git-Daemon.html" >Git Daemon </a>
-        </li>
-        <li>
-          4.6
-          <a href="Git-on-the-Server-Smart-HTTP.html" >Smart HTTP </a>
-        </li>
-        <li>
-          4.7
-          <a href="Git-on-the-Server-GitWeb.html" >GitWeb </a>
-        </li>
-        <li>
-          4.8
-          <a href="ch00/_gitlab_groups_section.html" >GitLab </a>
-        </li>
-        <li>
-          4.9
-          <a href="Git-on-the-Server-Third-Party-Hosted-Options.html" >Third Party Hosted Options </a>
-        </li>
-        <li>
-          4.10
-          <a href="Git-on-the-Server-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>5. <a href="ch00/_integration_manager.html">Distributed Git</a></h2>
-    <ol>
-        <li>
-          5.1
-          <a href="ch00/_integration_manager.html" >Distributed Workflows </a>
-        </li>
-        <li>
-          5.2
-          <a href="ch00/_project_over_email.html" >Contributing to a Project </a>
-        </li>
-        <li>
-          5.3
-          <a href="ch00/_git_am.html" >Maintaining a Project </a>
-        </li>
-        <li>
-          5.4
-          <a href="Distributed-Git-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-</ol>
-    </div>
-    <div class='column-middle'>
-      <ol class='book-toc'>
-  <li class='chapter'>
-  <h2>6. <a href="ch00/_personal_avatar.html">GitHub</a></h2>
-    <ol>
-        <li>
-          6.1
-          <a href="ch00/_personal_avatar.html" >Account Setup and Configuration </a>
-        </li>
-        <li>
-          6.2
-          <a href="ch00/_fetch_and_push_on_different_repositories.html" >Contributing to a Project </a>
-        </li>
-        <li>
-          6.3
-          <a href="ch00/_email_notifications.html" >Maintaining a Project </a>
-        </li>
-        <li>
-          6.4
-          <a href="ch00/_team_page.html" >Managing an organization </a>
-        </li>
-        <li>
-          6.5
-          <a href="ch00/_commit_status.html" >Scripting GitHub </a>
-        </li>
-        <li>
-          6.6
-          <a href="GitHub-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>7. <a href="ch00/_git_reflog.html">Git Tools</a></h2>
-    <ol>
-        <li>
-          7.1
-          <a href="ch00/_git_reflog.html" >Revision Selection </a>
-        </li>
-        <li>
-          7.2
-          <a href="ch00/_interactive_staging.html" >Interactive Staging </a>
-        </li>
-        <li>
-          7.3
-          <a href="ch00/_git_clean.html" >Stashing and Cleaning </a>
-        </li>
-        <li>
-          7.4
-          <a href="ch00/_signing_commits.html" >Signing Your Work </a>
-        </li>
-        <li>
-          7.5
-          <a href="ch00/_git_grep.html" >Searching </a>
-        </li>
-        <li>
-          7.6
-          <a href="ch00/_removing_file_every_commit.html" >Rewriting History </a>
-        </li>
-        <li>
-          7.7
-          <a href="ch00/_the_index.html" >Reset Demystified </a>
-        </li>
-        <li>
-          7.8
-          <a href="ch00/_reverse_commit.html" >Advanced Merging </a>
-        </li>
-        <li>
-          7.9
-          <a href="ch00/ref_rerere.html" >Rerere </a>
-        </li>
-        <li>
-          7.10
-          <a href="ch00/_file_annotation.html" >Debugging with Git </a>
-        </li>
-        <li>
-          7.11
-          <a href="ch00/_publishing_submodules.html" >Submodules </a>
-        </li>
-        <li>
-          7.12
-          <a href="ch00/_bundling.html" >Bundling </a>
-        </li>
-        <li>
-          7.13
-          <a href="ch00/_replace.html" >Replace </a>
-        </li>
-        <li>
-          7.14
-          <a href="ch00/_credential_caching.html" >Credential Storage </a>
-        </li>
-        <li>
-          7.15
-          <a href="Git-Tools-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>8. <a href="ch00/_external_merge_tools.html">Customizing Git</a></h2>
-    <ol>
-        <li>
-          8.1
-          <a href="ch00/_external_merge_tools.html" >Git Configuration </a>
-        </li>
-        <li>
-          8.2
-          <a href="ch00/_keyword_expansion.html" >Git Attributes </a>
-        </li>
-        <li>
-          8.3
-          <a href="ch00/_email_hooks.html" >Git Hooks </a>
-        </li>
-        <li>
-          8.4
-          <a href="ch00/_enforcing_commit_message_format.html" >An Example Git-Enforced Policy </a>
-        </li>
-        <li>
-          8.5
-          <a href="Customizing-Git-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>9. <a href="ch00/_git_svn.html">Git and Other Systems</a></h2>
-    <ol>
-        <li>
-          9.1
-          <a href="ch00/_git_svn.html" >Git as a Client </a>
-        </li>
-        <li>
-          9.2
-          <a href="ch00/_git_p4.html" >Migrating to Git </a>
-        </li>
-        <li>
-          9.3
-          <a href="Git-and-Other-Systems-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>10. <a href="ch00/_plumbing_porcelain.html">Git Internals</a></h2>
-    <ol>
-        <li>
-          10.1
-          <a href="ch00/_plumbing_porcelain.html" >Plumbing and Porcelain </a>
-        </li>
-        <li>
-          10.2
-          <a href="ch00/_git_commit_objects.html" >Git Objects </a>
-        </li>
-        <li>
-          10.3
-          <a href="ch00/ref_the_ref.html" >Git References </a>
-        </li>
-        <li>
-          10.4
-          <a href="Git-Internals-Packfiles.html" >Packfiles </a>
-        </li>
-        <li>
-          10.5
-          <a href="ch00/_pushing_refspecs.html" >The Refspec </a>
-        </li>
-        <li>
-          10.6
-          <a href="Git-Internals-Transfer-Protocols.html" >Transfer Protocols </a>
-        </li>
-        <li>
-          10.7
-          <a href="ch00/_git_gc.html" >Maintenance and Data Recovery </a>
-        </li>
-        <li>
-          10.8
-          <a href="Git-Internals-Environment-Variables.html" >Environment Variables </a>
-        </li>
-        <li>
-          10.9
-          <a href="Git-Internals-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-</ol>
-    </div>
-    <div class='column-right'>
-      <ol class='book-toc'>
-  <li class='chapter'>
-  <h2>A1. <a href="./Appendix-A:-Git-in-Other-Environments-Graphical-Interfaces.html">Appendix A: Git in Other Environments</a></h2>
-    <ol>
-        <li>
-          A1.1
-          <a href="./Appendix-A:-Git-in-Other-Environments-Graphical-Interfaces.html" >Graphical Interfaces </a>
-        </li>
-        <li>
-          A1.2
-          <a href="./Appendix-A:-Git-in-Other-Environments-Git-in-Visual-Studio.html" >Git in Visual Studio </a>
-        </li>
-        <li>
-          A1.3
-          <a href="./Appendix-A:-Git-in-Other-Environments-Git-in-Visual-Studio-Code.html" >Git in Visual Studio Code </a>
-        </li>
-        <li>
-          A1.4
-          <a href="./Appendix-A:-Git-in-Other-Environments-Git-in-IntelliJ-%252F-PyCharm-%252F-WebStorm-%252F-PhpStorm-%252F-RubyMine.html" >Git in IntelliJ / PyCharm / WebStorm / PhpStorm / RubyMine </a>
-        </li>
-        <li>
-          A1.5
-          <a href="./Appendix-A:-Git-in-Other-Environments-Git-in-Sublime-Text.html" >Git in Sublime Text </a>
-        </li>
-        <li>
-          A1.6
-          <a href="./Appendix-A:-Git-in-Other-Environments-Git-in-Bash.html" >Git in Bash </a>
-        </li>
-        <li>
-          A1.7
-          <a href="ch00/oh_my_zsh_git.html" >Git in Zsh </a>
-        </li>
-        <li>
-          A1.8
-          <a href="./Appendix-A:-Git-in-Other-Environments-Git-in-PowerShell.html" >Git in PowerShell </a>
-        </li>
-        <li>
-          A1.9
-          <a href="./Appendix-A:-Git-in-Other-Environments-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>A2. <a href="./Appendix-B:-Embedding-Git-in-your-Applications-Command-line-Git.html">Appendix B: Embedding Git in your Applications</a></h2>
-    <ol>
-        <li>
-          A2.1
-          <a href="./Appendix-B:-Embedding-Git-in-your-Applications-Command-line-Git.html" >Command-line Git </a>
-        </li>
-        <li>
-          A2.2
-          <a href="ch00/_libgit2_bindings.html" >Libgit2 </a>
-        </li>
-        <li>
-          A2.3
-          <a href="./Appendix-B:-Embedding-Git-in-your-Applications-JGit.html" >JGit </a>
-        </li>
-        <li>
-          A2.4
-          <a href="./Appendix-B:-Embedding-Git-in-your-Applications-go-git.html" >go-git </a>
-        </li>
-        <li>
-          A2.5
-          <a href="./Appendix-B:-Embedding-Git-in-your-Applications-Dulwich.html" >Dulwich </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>A3. <a href="ch00/ch_core_editor.html">Appendix C: Git Commands</a></h2>
-    <ol>
-        <li>
-          A3.1
-          <a href="ch00/ch_core_editor.html" >Setup and Config </a>
-        </li>
-        <li>
-          A3.2
-          <a href="./Appendix-C:-Git-Commands-Getting-and-Creating-Projects.html" >Getting and Creating Projects </a>
-        </li>
-        <li>
-          A3.3
-          <a href="./Appendix-C:-Git-Commands-Basic-Snapshotting.html" >Basic Snapshotting </a>
-        </li>
-        <li>
-          A3.4
-          <a href="./Appendix-C:-Git-Commands-Branching-and-Merging.html" >Branching and Merging </a>
-        </li>
-        <li>
-          A3.5
-          <a href="./Appendix-C:-Git-Commands-Sharing-and-Updating-Projects.html" >Sharing and Updating Projects </a>
-        </li>
-        <li>
-          A3.6
-          <a href="./Appendix-C:-Git-Commands-Inspection-and-Comparison.html" >Inspection and Comparison </a>
-        </li>
-        <li>
-          A3.7
-          <a href="./Appendix-C:-Git-Commands-Debugging.html" >Debugging </a>
-        </li>
-        <li>
-          A3.8
-          <a href="./Appendix-C:-Git-Commands-Patching.html" >Patching </a>
-        </li>
-        <li>
-          A3.9
-          <a href="./Appendix-C:-Git-Commands-Email.html" >Email </a>
-        </li>
-        <li>
-          A3.10
-          <a href="./Appendix-C:-Git-Commands-External-Systems.html" >External Systems </a>
-        </li>
-        <li>
-          A3.11
-          <a href="./Appendix-C:-Git-Commands-Administration.html" >Administration </a>
-        </li>
-        <li>
-          A3.12
-          <a href="./Appendix-C:-Git-Commands-Plumbing-Commands.html" >Plumbing Commands </a>
-        </li>
-    </ol>
-  </li>
-</ol>
-    </div>
-  </div>
- </div>
-    <span class="light" id="edition">
-      2nd Edition
-    </span>
-</div>
-<div id='main' class="book edition2">
-    <h1>2.6 Git Basics - Tagging</h1>
-  <div>
-<h2 id="_git_tagging">Tagging</h2>
-<div class="paragraph">
-<p>
-Like most VCSs, Git has the ability to tag specific points in a repository’s history as being important.
-Typically, people use this functionality to mark release points (<code>v1.0</code>, <code>v2.0</code> and so on).
-In this section, you’ll learn how to list existing tags, how to create and delete tags, and what the different types of tags are.</p>
-</div>
-<div class="sect3">
-<h3 id="_listing_your_tags">Listing Your Tags</h3>
-<div class="paragraph">
-<p>Listing the existing tags in Git is straightforward.
-Just type <code>git tag</code> (with optional <code>-l</code> or <code>--list</code>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git tag
-v1.0
-v2.0</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This command lists the tags in alphabetical order; the order in which they are displayed has no real importance.</p>
-</div>
-<div class="paragraph">
-<p>You can also search for tags that match a particular pattern.
-The Git source repo, for instance, contains more than 500 tags.
-If you’re interested only in looking at the 1.8.5 series, you can run this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git tag -l "v1.8.5*"
-v1.8.5
-v1.8.5-rc0
-v1.8.5-rc1
-v1.8.5-rc2
-v1.8.5-rc3
-v1.8.5.1
-v1.8.5.2
-v1.8.5.3
-v1.8.5.4
-v1.8.5.5</code></pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Note</div>
-</td>
-<td class="content">
-<div class="title">Listing tag wildcards requires <code>-l</code> or <code>--list</code> option</div>
-<div class="paragraph">
-<p>If you want just the entire list of tags, running the command <code>git tag</code> implicitly assumes you want a listing and provides one; the use of <code>-l</code> or <code>--list</code> in this case is optional.</p>
-</div>
-<div class="paragraph">
-<p>If, however, you’re supplying a wildcard pattern to match tag names, the use of <code>-l</code> or <code>--list</code> is mandatory.</p>
-</div>
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect3">
-<h3 id="_creating_tags">Creating Tags</h3>
-<div class="paragraph">
-<p>Git supports two types of tags: <em>lightweight</em> and <em>annotated</em>.</p>
-</div>
-<div class="paragraph">
-<p>A lightweight tag is very much like a branch that doesn’t change — it’s just a pointer to a specific commit.</p>
-</div>
-<div class="paragraph">
-<p>Annotated tags, however, are stored as full objects in the Git database.
-They’re checksummed; contain the tagger name, email, and date; have a tagging message; and can be signed and verified with GNU Privacy Guard (GPG).
-It’s generally recommended that you create annotated tags so you can have all this information; but if you want a temporary tag or for some reason don’t want to keep the other information, lightweight tags are available too.</p>
-</div>
-</div>
-<div class="sect3">
-<h3 id="_annotated_tags">Annotated Tags</h3>
-<div class="paragraph">
-<p>
-Creating an annotated tag in Git is simple.
-The easiest way is to specify <code>-a</code> when you run the <code>tag</code> command:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git tag -a v1.4 -m "my version 1.4"
-$ git tag
-v0.1
-v1.3
-v1.4</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The <code>-m</code> specifies a tagging message, which is stored with the tag.
-If you don’t specify a message for an annotated tag, Git launches your editor so you can type it in.</p>
-</div>
-<div class="paragraph">
-<p>You can see the tag data along with the commit that was tagged by using the <code>git show</code> command:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git show v1.4
-tag v1.4
-Tagger: Ben Straub &lt;ben@straub.cc&gt;
-Date:   Sat May 3 20:19:12 2014 -0700
-my version 1.4
-commit ca82a6dff817ec66f44342007202690a93763949
-Author: Scott Chacon &lt;schacon@gee-mail.com&gt;
-Date:   Mon Mar 17 21:52:11 2008 -0700
-    Change version number</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>That shows the tagger information, the date the commit was tagged, and the annotation message before showing the commit information.</p>
-</div>
-</div>
-<div class="sect3">
-<h3 id="_lightweight_tags">Lightweight Tags</h3>
-<div class="paragraph">
-<p>
-Another way to tag commits is with a lightweight tag.
-This is basically the commit checksum stored in a file — no other information is kept.
-To create a lightweight tag, don’t supply any of the <code>-a</code>, <code>-s</code>, or <code>-m</code> options, just provide a tag name:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git tag v1.4-lw
-$ git tag
-v0.1
-v1.3
-v1.4
-v1.4-lw
-v1.5</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This time, if you run <code>git show</code> on the tag, you don’t see the extra tag information.
-The command just shows the commit:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git show v1.4-lw
-commit ca82a6dff817ec66f44342007202690a93763949
-Author: Scott Chacon &lt;schacon@gee-mail.com&gt;
-Date:   Mon Mar 17 21:52:11 2008 -0700
-    Change version number</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h3 id="_tagging_later">Tagging Later</h3>
-<div class="paragraph">
-<p>You can also tag commits after you’ve moved past them.
-Suppose your commit history looks like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git log --pretty=oneline
-15027957951b64cf874c3557a0f3547bd83b3ff6 Merge branch 'experiment'
-a6b4c97498bd301d84096da251c98a07c7723e65 Create write support
-0d52aaab4479697da7686c15f77a3d64d9165190 One more thing
-6d52a271eda8725415634dd79daabbc4d9b6008e Merge branch 'experiment'
-0b7434d86859cc7b8c3d5e1dddfed66ff742fcbc Add commit function
-4682c3261057305bdd616e23b64b0857d832627b Add todo file
-166ae0c4d3f420721acbb115cc33848dfcc2121a Create write support
-9fceb02d0ae598e95dc970b74767f19372d61af8 Update rakefile
-964f16d36dfccde844893cac5b347e7b3d44abbc Commit the todo
-8a5cbc430f1a9c3d00faaeffd07798508422908a Update readme</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now, suppose you forgot to tag the project at v1.2, which was at the “Update rakefile” commit.
-You can add it after the fact.
-To tag that commit, you specify the commit checksum (or part of it) at the end of the command:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git tag -a v1.2 9fceb02</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can see that you’ve tagged the commit:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git tag
-v0.1
-v1.2
-v1.3
-v1.4
-v1.4-lw
-v1.5
-$ git show v1.2
-tag v1.2
-Tagger: Scott Chacon &lt;schacon@gee-mail.com&gt;
-Date:   Mon Feb 9 15:32:16 2009 -0800
-version 1.2
-commit 9fceb02d0ae598e95dc970b74767f19372d61af8
-Author: Magnus Chacon &lt;mchacon@gee-mail.com&gt;
-Date:   Sun Apr 27 20:43:35 2008 -0700
-    Update rakefile
-...</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h3 id="_sharing_tags">Sharing Tags</h3>
-<div class="paragraph">
-<p>By default, the <code>git push</code> command doesn’t transfer tags to remote servers.
-You will have to explicitly push tags to a shared server after you have created them.
-This process is just like sharing remote branches — you can run <code>git push origin &lt;tagname&gt;</code>.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git push origin v1.5
-Counting objects: 14, done.
-Delta compression using up to 8 threads.
-Compressing objects: 100% (12/12), done.
-Writing objects: 100% (14/14), 2.05 KiB | 0 bytes/s, done.
-Total 14 (delta 3), reused 0 (delta 0)
-To git@github.com:schacon/simplegit.git
- * [new tag]         v1.5 -&gt; v1.5</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you have a lot of tags that you want to push up at once, you can also use the <code>--tags</code> option to the <code>git push</code> command.
-This will transfer all of your tags to the remote server that are not already there.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git push origin --tags
-Counting objects: 1, done.
-Writing objects: 100% (1/1), 160 bytes | 0 bytes/s, done.
-Total 1 (delta 0), reused 0 (delta 0)
-To git@github.com:schacon/simplegit.git
- * [new tag]         v1.4 -&gt; v1.4
- * [new tag]         v1.4-lw -&gt; v1.4-lw</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now, when someone else clones or pulls from your repository, they will get all your tags as well.</p>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Note</div>
-</td>
-<td class="content">
-<div class="title">
-<code>git push</code> pushes both types of tags</div>
-<div class="paragraph">
-<p><code>git push &lt;remote&gt; --tags</code> will push both lightweight and annotated tags.
-There is currently no option to push only lightweight tags, but if you use <code>git push &lt;remote&gt; --follow-tags</code> only annotated tags will be pushed to the remote.</p>
-</div>
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect3">
-<h3 id="_deleting_tags">Deleting Tags</h3>
-<div class="paragraph">
-<p>To delete a tag on your local repository, you can use <code>git tag -d &lt;tagname&gt;</code>.
-For example, we could remove our lightweight tag above as follows:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git tag -d v1.4-lw
-Deleted tag 'v1.4-lw' (was e7d5add)</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that this does not remove the tag from any remote servers.
-There are two common variations for deleting a tag from a remote server.</p>
-</div>
-<div class="paragraph">
-<p>The first variation is <code>git push &lt;remote&gt; :refs/tags/&lt;tagname&gt;</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git push origin :refs/tags/v1.4-lw
-To /git@github.com:schacon/simplegit.git
- - [deleted]         v1.4-lw</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The way to interpret the above is to read it as the null value before the colon is being pushed to the remote tag name, effectively deleting it.</p>
-</div>
-<div class="paragraph">
-<p>The second (and more intuitive) way to delete a remote tag is with:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git push origin --delete &lt;tagname&gt;</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h3 id="_checking_out_tags">Checking out Tags</h3>
-<div class="paragraph">
-<p>If you want to view the versions of files a tag is pointing to, you can do a <code>git checkout</code> of that tag, although this puts your repository in “detached HEAD” state, which has some ill side effects:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git checkout v2.0.0
-Note: switching to 'v2.0.0'.
-You are in 'detached HEAD' state. You can look around, make experimental
-changes and commit them, and you can discard any commits you make in this
-state without impacting any branches by performing another checkout.
-If you want to create a new branch to retain commits you create, you may
-do so (now or later) by using -c with the switch command. Example:
-  git switch -c &lt;new-branch-name&gt;
-Or undo this operation with:
-  git switch -
-Turn off this advice by setting config variable advice.detachedHead to false
-HEAD is now at 99ada87... Merge pull request #89 from schacon/appendix-final
-$ git checkout v2.0-beta-0.1
-Previous HEAD position was 99ada87... Merge pull request #89 from schacon/appendix-final
-HEAD is now at df3f601... Add atlas.json and cover image</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In “detached HEAD” state, if you make changes and then create a commit, the tag will stay the same, but your new commit won’t belong to any branch and will be unreachable, except by the exact commit hash.
-Thus, if you need to make changes — say you’re fixing a bug on an older version, for instance — you will generally want to create a branch:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-console" data-lang="console">$ git checkout -b version2 v2.0.0
-Switched to a new branch 'version2'</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you do this and make a commit, your <code>version2</code> branch will be slightly different than your <code>v2.0.0</code> tag since it will move forward with your new changes, so do be careful.</p>
-</div>
-</div>
-<div id="nav"><a href="ch00/_remote_repos.html">prev</a> | <a href="ch00/_git_aliases.html">next</a></div></div>
-</div>
-        </div>
-      </div>
-      <footer>
-  <div class="site-source">
-    <a href="https://git-scm.com/site">About this site</a><br>
-    Patches, suggestions, and comments are welcome.
-  </div>
-  <div class="sfc-member">
-    Git is a member of <a href="https://git-scm.com/sfc">Software Freedom Conservancy</a>
-  </div>
-</footer>
-<a href="ch00/_annotated_tags.html#top" class="no-js scrollToTop" id="scrollToTop" data-label="Scroll to top">
-  <img src="../../../images/icons/chevron-up@2x.png" width="20" height="20" alt="scroll-to-top"/>
-</a>
-<script src="../../../assets/application-38b0d42ff05ffea45841edebbd14b75b89585646153808e82907c2c5c11f324b.js"></script>
-    </div>
-</body>
-</html>