Faire un objet étiquette non signé et annoté

Faites une étiquette signée GPG, en utilisant la clé de l’adresse électronique par défaut. Le comportement par défaut de signature GPG d’étiquette GPG est contrôlé par la variable de configuration tag.gpgSign si elle existe, ou désactivé sinon. Voir git-config[1].

Surcharge tag.gpgSign qui force toutes les étiquettes à être signées.

Faire une étiquette signée par GPG, en utilisant la clé donnée.

Remplacer une étiquette existante par le nom fourni (au lieu d’échouer)

Supprimer les étiquettes existantes avec les noms fournis.

Vérifier la signature GPG des noms d’étiquette donnés.

<num> indique combien de lignes de l’annotation, le cas échéant, sont imprimées lorsque l’on utilise -l. Implique --list.

Lister les étiquettes. Avec l’option <motif>..., par exemple `git tag --list v-* `, ne lister que les étiquettes qui correspondent au(x) motif(s).

Trier en fonction de la clé donnée. Préfixer par - pour trier par ordre décroissant de la valeur. Vous pouvez utiliser l’option --sort=<clé> plusieurs fois, auquel cas la dernière clé devient la clé primaire. Prend également en charge "version:nom-de-réf" ou "v:nom-de-réf" (les noms d’étiquettes sont traités comme des versions). L’ordre de tri de "version:nom-de-réf" peut également être affecté par la variable de configuration "versionsort.suffixe". Les clés supportées sont les mêmes que celles de git for-each-ref. L’ordre de tri est par défaut la valeur configurée pour la variable tag.sort si elle existe, ou l’ordre lexicographique sinon. Voir git-config[1].

Respecter toutes les couleurs spécifiées dans l’option --format. Le champ <quand> doit être un des valeur always, never, ou auto (si <quand> est absent, se comporter comme si always était donné).

Le tri et le filtrage des étiquettes sont non-sensibles à la casse.

Ne pas afficher de nouvelle ligne après les refs formatés lorsque le format se développe en chaîne vide.

Afficher les étiquettes en colonnes. Voir la variable de configuration column.tag pour la syntaxe de l’option. --column et --no-column sans options sont équivalents à always et never respectivement.

Ne répertorier que les étiquettes qui contiennent le commit spécifié (HEAD si non spécifié). Implique --list.

Ne répertorier que les étiquettes qui ne contiennent pas le commit spécifié (HEAD si non spécifié). Implique --list.

Ne lister que les étiquettes dont les commits sont accessibles à partir du commit spécifié (HEAD si non spécifié).

Ne lister que les étiquettes dont les commits ne sont pas accessibles à partir du commit spécifié (HEAD si non spécifié).

Ne répertorier que les étiquettes de l’objet donné (HEAD si non spécifié). Implique --list.

Utiliser le message d’étiquette fourni (au lieu de le demander). Si plusieurs options -m sont fournies, leurs valeurs sont concaténées comme paragraphes séparés. Implique -a si ni -a, ni -s et ni -u <id-clé> n’est fourni.

Prendre le message d’étiquette fourni dans le fichier indiqué. Utiliser - pour lire le message depuis l’entrée standard. Implique -a si ni -a, ni -s et ni -u <id-clé> n’est fourni.

Spécifier une paire (<jeton>, <valeur>) qui doit être appliquée comme une ligne terminale (par exemple, git tag --trailer "Clé-Personnalisée:valeur" ajoutera la ligne terminale "Clé-Personnelle" au message d’étiquette). Les variables de configuration trailer.* (git-interpret-trailers[1]) peuvent être utilisées pour définir si une ligne terminale dupliquée est omise, ou où chaque ligne terminale apparaîtrait dans la série de lignes terminales, et d’autres détails. Les lignes terminales peuvent être extraites dans git tag --list, en utilisant --format="%(trailers)".

Le message tiré d’un fichier avec -F, ou de la ligne de commande avec -m est généralement utilisé sans modification. Cette option permet d’éditer au passage le message tiré de ces sources.

Cette option définit la manière dont le message de l’étiquette est nettoyé. Le <mode> peut être un verbatim, whitespace ou strip. Le mode strip est le mode par défaut. Le mode verbatim ne modifie pas du tout le message, whitespace supprime uniquement les lignes vides de début et de fin et strip supprime à la fois les espaces et les commentaires.

Créer un reflog pour l’étiquette. Pour activer globalement les reflogs pour les étiquettes, voir core.logAllRefUpdates dans git-config[1]. La forme inversée --no-create-reflog ne fait que remplacer une précédente --create-reflog, mais n’annule pas actuellement le paramètre de core.logAllRefUpdates.

Une chaîne qui interpole %(fieldname) à partir d’une référence d’étiquette affichée et de l’objet qu’il pointe. Le format est le même que celui de git-for-each-ref[1]. Lorsqu’elle n’est pas spécifiée, la valeur par défaut est %(refname:strip=2).

Le nom de l’étiquette à créer, supprimer ou décrire. Le nouveau nom de l’étiquette doit passer tous les contrôles définis par git-check-ref-format[1]. Certains de ces contrôles peuvent restreindre les caractères autorisés dans un nom d’étiquette.

L’objet auquel la nouvelle étiquette fera référence, généralement un commit. La valeur par défaut est HEAD.

Il est de la forme <horodatage-unix> <décalage-de-fuseau-horaire>, où <horodatage-unix> est un nombre de secondes depuis l’époque UNIX. <décalage-de-fuseau-horaire> est un décalage positif ou négative par rapport à UTC. Par exemple, CET (qui est en avance d’une heure sur UTC) est +0100.

Le standard de format de date tel que décrit par la RFC 2822, par exemple Thu, 07 Apr 2005 22:13:13 +0200.

Les heures et les dates sont spécifiées par le standard ISO 8601, par exemple 2005-04-07T22:13:13. L’analyseur accepte aussi un espace au lieu du caractère T. Les parties fractionnelles d’une seconde seront ignorées, par exemple, 2005-04-07T22:13:13.019 sera considéré comme étant 2005-04-07T22:13:13.

Ce fichier contient le message de l’étiquette annotée en cours. Si git tag sort à cause d’une erreur avant de créer une étiquette annotée, alors le message de l’étiquette annotée fourni par l’utilisateur dans une session d’éditeur sera disponible dans ce fichier, mais sera écrasé par l’invocation suivante de git tag.