git-commit-tree - Crée un nouvel objet commit

Ce n’est généralement pas ce qu’un utilisateur final veut exécuter directement. Voir git-commit[1] à la place.

Crée un nouvel objet commit basé sur l’objet arbre fourni et émet l’identifiant du nouvel objet commit sur stdout. Le message de journal est lu depuis l’entrée standard, à moins que les options -m ou -F soient données.

Les options -m et -F peuvent être données plus d’une fois, dans n’importe quel ordre. Le message du journal de livraison sera composé dans l’ordre dans lequel les options sont données.

Un objet commit peut avoir un nombre quelconque de parents. Avec exactement un parent, c’est un commit ordinaire. Avoir plus d’un parent fait du commit une fusion entre plusieurs lignes d’historique. Les commits initiaux (racine) n’ont pas de parents.

Alors qu’un arbre représente un état particulier d’un répertoire de travail, un commit représente cet état dans le "temps", et explique comment y arriver.

Normalement, un commit devrait identifier un nouvel état "HEAD", et bien que Git ne se soucie pas de l’endroit où vous enregistrez la note sur cet état, en pratique nous avons tendance à simplement écrire le résultat dans le fichier qui est pointé par .git/HEAD, de sorte que nous pouvons toujours voir quel était le dernier état validé.

Un commit encapsule :

Un commentaire de validation est lu à partir de stdin. Si une entrée de changelog n’est pas fournie via la redirection « < », git commit-tree attendra simplement qu’une entrée soit entrée et terminée par ^D.

Les variables d’environnement GIT_AUTHOR_DATE et GIT_COMMITTER_DATE supportent les formats de date suivants :

Git est dans une certaine mesure agnostique concernant l’encodage des caractères.

Bien que l’usage de UTF-8 dans les messages de validation soit encouragé, le cœur de Git et la porcelaine sont conçus pour ne pas forcer l’usage d’UTF-8 dans les projets. Si tous les participants d’un projet donné trouvent plus simple d’utiliser des encodages anciens, Git ne l’interdit pas. Cependant, il y a quelques détails à garder en tête.

Remarquez qu’il a été délibérément choisi de ne pas ré-encoder le message de validation quand le commit est créé pour forcer l’UTF-8 au niveau de l’objet commit parce que ré-encoder en UTF-8 n’est pas nécessairement une opération réversible.

/etc/mailname

git-write-tree[1] git-commit[1]

Fait partie de la suite git[1]

Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site https://github.com/jnavila/git-manpages-l10n .