Difference between revisions of "Tagging"

From Geos-chem
Jump to: navigation, search
(Further reading)
(Create a tag using Gitk)
Line 14: Line 14:
 
You may also add a tag via the '''gitk''' viewer utility, as follows:
 
You may also add a tag via the '''gitk''' viewer utility, as follows:
  
1. Start Gitk:
+
(1) '''Start Gitk'''.
  
 
  gitk --all
 
  gitk --all
  
2. Select the commit that you wish to tag by right-clicking on its name with your mouse.  A context menu will appear:
+
(2) '''Select''' the commit that you wish to tag by right-clicking on its name with your mouse.  A context menu will appear:
  
 
[[Image:GitKTagMenu.png]]
 
[[Image:GitKTagMenu.png]]
  
3. Select the '''Create tag''' option.  A dialog box will appear:
+
(3) '''Select''' the '''Create tag''' option.  A dialog box will appear:
  
 
[[Image:GitKCreateTag.png]]
 
[[Image:GitKCreateTag.png]]
  
4. Type the text for your tag the '''Tag name''' box.
+
(4) '''Type the text''' for your tag the '''Tag name''' box.
  
5. Click on '''Create'''.  Your tag should appear as a yellow flag in the Gitk revision history window.
+
(5) '''Click''' on '''Create'''.  Your tag should appear as a yellow flag in the Gitk revision history window.
  
 
=== Create a tag from the command line ===
 
=== Create a tag from the command line ===

Revision as of 16:29, 21 June 2019

Previous | Next | Guide to using Git with GEOS-Chem | Getting Started with GEOS-Chem | GEOS-Chem Main Page

Overview

On this page, we describe how to add tags to individual commits.

Tagging

Git allows you to tag a particular commit with an alphanumeric string for easy reference. This tag can be used with git pull', git checkout, etc. commands in the same way as for branches.

Each commit corresponding to a GEOS-Chem version release is tagged with the version number (e.g. 12.3.2).

Create a tag using Gitk

You may also add a tag via the gitk viewer utility, as follows:

(1) Start Gitk.

gitk --all

(2) Select the commit that you wish to tag by right-clicking on its name with your mouse. A context menu will appear:

GitKTagMenu.png

(3) Select the Create tag option. A dialog box will appear:

GitKCreateTag.png

(4) Type the text for your tag the Tag name box.

(5) Click on Create. Your tag should appear as a yellow flag in the Gitk revision history window.

Create a tag from the command line

You can add a tag via the command line:

    git tag GEOS-Chem TAG_NAME

That command will create a tag at the current commit.

Removing tags

You can remove a tag via the command line:

git tag -d TAG_NAME

Further reading

  1. Git tag (Official Git documentation)
  2. How to become a master of Git tags (DaftBlog)
  3. Create a tag in a Github repository (Stack Overflow)

Previous | Next | Guide to using Git with GEOS-Chem | Getting Started with GEOS-Chem | GEOS-Chem Main Page