Git

NOM

git-patch-id - Calcule un ID unique pour une rustine

SYNOPSIS

git patch-id [--stable | --unstable | --verbatim]

DESCRIPTION

Lire une rustine à partir de l’entrée standard et calculer son identifiant de rustine.

Un "ID de rustine" n’est rien d’autre qu’une empreinte SHA-1 des diffs de fichiers associés à une rustine, avec les numéros de ligne ignorés. En tant que tel, il est « raisonnablement stable », mais en même temps aussi raisonnablement unique, c’est-à-dire deux rustines qui ont le même « ID de rustine » sont presque garantis d’être la même chose.

Le principal cas d’utilisation de cette commande est de rechercher des commits en double.

Pour traiter la sortie de git diff-tree, on tire avantage du fait que la rustine est préfixée par le nom d’objet du commit, et deux chaînes de 40 octets, de caractères hexadécimaux sont générées. La première chaîne est l’ID de rustine, tandis que la seconde est l’ID de commit. Cela peut être utilisé pour établir une correspondance entre ID de rustine et ID de commit.

OPTIONS

--verbatim

Calculer l’id-rustine de l’entrée standard telle qu’elle est fournie, sans retirer les espaces blancs.

C'est le comportement par défaut si patchid.verbatim est vrai.
--stable

Utiliser une somme "stable" de hachages comme ID de rustine. Avec cette option :

  • Réordonner les fichiers diffs qui composent une rustine n’affecte pas l’ID. En particulier, deux rustines produites en comparant les mêmes deux arbres avec deux réglages différents pour "-O<order-de-fichier>" résultent en la même signature d’identification de le rustine, permettant ainsi au résultat calculé d’être utilisé comme clé pour indexer quelques méta-information sur les modifications entre les deux arbres ;

  • Le résultat est différent de la valeur produite par git 1.9 et antérieur, ou produite quand une fonction d’empreint "instable" (voir --unstable ci-dessous) est utilisée - même sur la sortie d’un diff pris sans utiliser "-O<ordre-de-fichier>", rendant ainsi inutilisables les bases de données existantes qui stockent de tels id de rustine historiques ou instables.

  • Tous les espaces blancs dans la rustine sont ignorés et n’affectent pas l’id.

    C'est le comportement par défaut si patchid.stable est fixé à true.
--unstable

Use an "unstable" hash as the patch ID. With this option, the result produced is compatible with the patch-id value produced by git 1.9 and older and whitespace is ignored. Users with pre-existing databases storing patch-ids produced by git 1.9 and older (who do not deal with reordered patches) may want to use this option.

C'est l'option par défaut.

GIT

Fait partie de la suite git[1]

TRADUCTION

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 .

scroll-to-top