From 6685a0e47358f5c3e49e5e2724198ccb52645f64 Mon Sep 17 00:00:00 2001 From: Marcello Lamonaca Date: Thu, 15 Feb 2024 09:16:51 +0100 Subject: [PATCH] git: add tag update and signing notes --- docs/misc/git.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/misc/git.md b/docs/misc/git.md index eacc6a9..6e23d47 100644 --- a/docs/misc/git.md +++ b/docs/misc/git.md @@ -199,10 +199,10 @@ def load_reference(name_or_id): Git supports two types of tags: *lightweight* and *annotated*. -A lightweight tag is very much like a branch that doesn't change—it's just a pointer to a specific commit. +A lightweight tag is very much like a branch that doesn't change: it's just a pointer to a specific commit. 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). +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 creating annotated tags so it's possible to have all this information. `git tag`: list existing tags @@ -210,6 +210,8 @@ It's generally recommended creating annotated tags so it's possible to have all `git tag []`: create a *lightweight* tag on the commit `git tag -a|--annotate [ -m ]`: create am *annotated* tag on the commit +`git tag -f|--force []`: update a tag if it exists +`git tag -s|--sign []`: sign a tag `git push `: push a tag to the remote `git push --tags`: push commits and their tags (both types) to the remote