Affiche la liste des objets notes pour un objet donné. Si aucun objet n’est donné, affiche une liste de tous les objets notes et des objets qu’ils annotent (au format "<objet note> <objet annoté>"). Il s’agit de la sous-commande par défaut si aucune sous-commande n’est donnée.

Ajouter des notes pour un objet donné (par défaut HEAD). Abandonner si l’objet a déjà des notes (utilisez -f pour écraser les notes existantes). Cependant, si vous utilisez add de manière interactive (en utilisant un éditeur pour fournir le contenu des notes), alors - au lieu d’abandonner - les notes existantes seront ouvertes dans l’éditeur (comme la sous-commande edit). Si vous spécifiez plusieurs -m et -F, une ligne vierge sera insérée entre les messages. Utilisez l’option --separator pour insérer d’autres délimiteurs.

Copier les notes du premier objet sur le deuxième objet (par défaut HEAD). Abandonner si le second objet a déjà des notes, ou si le premier objet n’en a pas (utilisez -f pour écraser les notes existantes sur le second objet). Cette sous-commande est équivalente à : git notes add [-f] -C $(git notes list <objet-source>) <objet-cible>

<objet-source> ESP <objet-source> [ ESP <reste> ] LF

Appliquer un ou plusieurs nouveaux messages donnés par des options -m ou -F à une note existante, ou les ajouter comme une nouvelle note si aucune n’existe , pour l’objet (par défaut à HEAD). Lorsqu’elle continue une note existante, une ligne vierge est ajoutée avant chaque nouveau message en tant que séparateur inter-paragraphe. Le séparateur peut être personnalisé avec l’option --separator.

Modifier les notes pour un objet donné (par défaut HEAD).

Afficher les notes pour un objet donné (par défaut, HEAD).

Fusionner la référence de notes donnée dans la référence de notes actuelle. Cette commande essaiera de fusionner les modifications apportées par la référence de notes donnée (appelée "remote") depuis la base de fusion (si elle existe) dans la référence de notes actuelle (appelée "local").

Supprimer les notes pour les objets donnés (la valeur par défaut est HEAD). Lorsque l’on donne zéro ou un objet depuis la ligne de commande, cela équivaut à spécifier un message de note vide à la sous-commande edit.

Supprimer toutes les notes relatives aux objets inexistants ou inaccessibles.

Afficher la référence des notes actuelles. Ceci fournit un moyen facile de récupérer la référence des notes actuelles (par exemple, à partir de scripts).

Lors de l’ajout de notes à un objet qui en possède déjà, les notes existantes sont écrasées (au lieu d’être abandonnées).

Utiliser le message de note fourni (au lieu de le demander). Si plusieurs options -m sont fournies, leurs valeurs sont concaténées comme paragraphes séparés. Les lignes commençant par # et les lignes vides sont supprimées si elles ne sont pas uniques entre paragraphes. Si vous souhaitez les garder verbatim, utilisez --no-stripspace.

Prendre le message de note depuis le fichier indiqué. Utilisez - pour lire le message depuis l’entrée standard. Les lignes commençant par # et les lignes vides sont supprimées si elles ne sont pas uniques entre paragraphes. Si vous souhaitez les garder verbatim, utilisez --no-stripspace.

Prendre l’objet blob donné (par exemple, une autre note) comme message de note. (Utilisez git notes copy <objet> au lieu de copier les notes entre les objets). Par défaut, le message sera copié verbatim, mais si vous souhaitez supprimer les lignes commençant par # et les lignes vides autres que les lignes uniques entre les paragraphes, utilisez l’option --stripspace.

Comme -C, mais avec -c, l’éditeur est appelé pour permettre à l’utilisateur de modifier le message de note.

Permettre de stocker un objet note vide. Le comportement par défaut consiste à supprimer automatiquement les notes vides.

Spécifier une chaîne utilisée comme séparateur d’inter-paragraphe personnalisé (une nouvelle ligne est ajoutée à la fin si nécessaire). Si --no-separator , aucun séparateur ne sera ajouté entre les paragraphes. Par défaut, la valeur est une ligne vierge.

Éliminer les espaces précédant et suivant le message de note. Également éliminer les lignes vides autres que les lignes uniques entre les paragraphes. Les lignes commençant par # seront nettoyées dans des cas sans éditeur comme -m, -F et -C, mais pas dans les cas avec éditeur comme git notes edit, -c, etc.

Manipuler l’arbre des notes dans <réf>. Ceci a priorité sur GIT_NOTES_REF et la configuration "core.notesRef". La réf spécifie le nom complet de la réf quand elle commence par refs/notes/ ; quand elle commence par notes/, refs/ ou autre, refs/notes/ est préfixé pour former un nom complet de la réf.

Ne pas considérer comme une erreur de demander la suppression des notes d’un objet qui n’a pas de notes qui lui sont attachées.

Lire également les noms d’objets pour supprimer les notes à partir de l’entrée standard (il n’y a aucune raison pour que vous ne puissiez pas combiner cela avec les noms d’objets à partir de la ligne de commande).

Ne rien supprimer ; signaler simplement les noms des objets dont les notes seraient supprimées.

Lors d’une fusion de notes, résoudre les conflits de notes en utilisant la stratégie donnée. Les stratégies suivantes sont reconnues : "manual" (par défaut), "ours", "theirs", "union" et "cat_sort_uniq". Cette option a priorité sur le paramètre de configuration "notes.mergeStrategy". Voir la section "STRATÉGIES DE FUSION DES NOTES" ci-dessous pour plus d’informations sur chaque stratégie de fusion des notes.

Finaliser une fusion de notes en cours. Utilisez cette option lorsque vous avez résolu les conflits que git notes merge a stockés dans .git/NOTES_MERGE_WORKTREE. Cela modifie le commit de fusion partielle créé par git notes merge (stocké dans .git/NOTES_MERGE_PARTIAL) en ajoutant les notes dans .git/NOTES_MERGE_WORKTREE. La référence des notes stockée dans la réf symbolique .git/NOTES_MERGE_REF est mise à jour avec le commit résultant.

Abandonner/réinitialiser un git notes merge en cours, c’est-à-dire une fusion de notes avec des conflits. Cela supprime simplement tous les fichiers liés à la fusion de notes.

Mode silencieux lors d’une fusion de notes.

Mode verbeux lors d’une fusion de notes. Lors de l’élagage des notes, signaler tous les noms d’objets dont les notes sont supprimées.

Réf. de notes à lire et à manipuler à la place de refs/notes/commits. Doit être un nom de référence non abrégé. Ce paramètre peut être remplacé via l’environnement et la ligne de commande.

La référence dont les notes doivent être manipulées, au lieu de refs/notes/commits. Ceci remplace le paramètre core.notesRef.

Liste de refs ou de globs délimités par des colonnes indiquant les réfs, en plus de la valeur par défaut de core.notesRef ou de GIT_NOTES_REF, à partir desquelles lire les notes lors de l’affichage des messages de validation. Ceci surcharge le paramètre notes.displayRef.

Lors de la copie de notes pendant une réécriture, action à faire si le commit cible a déjà une note. Doit être parmi overwrite, concatenate, cat_sort_uniq, ou ignore. Ceci surcharge le paramètre core.rewriteMode.

Lors de la réécriture de commits, quelles notes copier de l’original vers le commit réécrit. Doit être une liste de refs ou de globs délimitée par deux points.