Git 🌙
Français â–Ÿ Topics â–Ÿ Latest version â–Ÿ git-am last updated in 2.46.0

NOM

git-am - Appliquer une série de rustines depuis des fichiers mailbox

SYNOPSIS

git am [--signoff] [--keep] [--[no-]keep-cr] [--[no-]utf8]] [--no-verify]
	 [--[no-]3way] [--interactive] [--committer-date-is-author-date]
	 [--ignore-date] [--ignore-space-change | --ignore-whitespace]
	 [--whitespace=<action>] [-C<n>] [-p<n>] [--directory=<répertoire>]
	 [--exclude=<path>] [--include=<path>] [--reject] [-q | --quiet]
	 [--[no-]scissors] [-S[<idclé>]] [--patch-format=<format>]
	 [--quoted-cr=<action>]
	 [--empty=(stop|drop|keep)]
	 [(<mbox> | <Maildir>)…​]
git am (--continue | --skip | --abort | --quit | | --retry | --show-current-patch[=(diff|raw)] | --allow-empty)

DESCRIPTION

Découpe des messages courriel dans une boßte aux lettres en message, auteur, information et rustine de commits, et les applique sur la branche en cours. Vous pouvez considérer cela comme une opération inverse de git-format-patch[1] exécutée sur une branche avec un historique direct sans fusions.

OPTIONS

(<mbox>|<Maildir>)…​

La liste de fichiers de boĂźte aux lettres desquelles on lit les rustines. Si vous ne fournissez pas cet argument, la commande lit depuis l’entrĂ©e standard. Si vous fournissez des rĂ©pertoires, ils sont lus comme des Maildirs.

-s
--signoff

Ajouter une ligne terminale Signed-off-by au message de commit, en utilisant votre identitĂ© pour validateur. RĂ©fĂ©rez-vous Ă  l’option de contre-signature dans git-commit[1] pour plus d’information.

-k
--keep

Passer l’option -k Ă  git mailinfo (voir git-mailinfo[1]).

--keep-non-patch

Passer l’option -b Ă  git mailinfo (voir git-mailinfo[1]).

--[no-]keep-cr

Avec --keep-cr, appeler git mailsplit (voir git-mailsplit[1]) avec la mĂȘme option, pour l’empĂȘcher de supprimer les CR en fin de ligne. La variable de configuration am.keepcr peut ĂȘtre utilisĂ©e pour spĂ©cifier le comportement par dĂ©faut. --no-keep-cr permet de surcharger am.keepcr.

-c
--scissors

Retirer tout du corps du message avant la ligne de ciseaux (voir git-mailinfo[1]). Peut ĂȘtre activĂ© par dĂ©faut en utilisant la variable de configuration mailinfo.scissors.

--no-scissors

Ignorer les lignes ciseaux (voir git-mailinfo[1]).

--quoted-cr=<action>

Ce drapeau sera transmis Ă  git mailinfo (voir git-mailinfo[1]).

--empty=(drop|keep|stop)

Comment gĂ©rer un message courriel sans rustine :

drop

Le message courriel sera ignoré.

keep

Un commit vide sera créé avec le contenu du message électronique comme message de validation.

stop

La commande Ă©chouera, en s’arrĂȘtant au milieu de la session am actuelle. C’est le comportement par dĂ©faut.

-m
--message-id

Passer le drapeau -m Ă  git mailinfo (voir git-mailinfo[1]), de sorte que l’en-tĂȘte Message-ID soit ajoutĂ© au message de validation. La variable de configuration am.messageid peut ĂȘtre utilisĂ©e pour spĂ©cifier le comportement par dĂ©faut.

--no-message-id

Ne pas ajouter l’entĂȘte Message-ID au message de validation. no-message-id est utile pour surcharger am.messageid.

-q
--quiet

Mode silencieux. N’afficher que les messages d’erreur.

-u
--utf8

Passer l’option -u Ă  git mailinfo (voir git-mailinfo[1]). Le message de validation proposĂ© extrait depuis le courriel est re-codĂ© en UTF-8 (la variable de configuration i18n.commitEncoding peut spĂ©cifier le codage prĂ©fĂ©rĂ© du projet s’il est diffĂ©rent d’UTF-8).

C’Ă©tait optionnel dans les versions prĂ©cĂ©dentes de git, mais c’est Ă  prĂ©sent par dĂ©faut. Vous pouvez utiliser --no-utf8 pour surcharger.

--no-utf8

Passer l’option -n Ă  git mailinfo (voir git-mailinfo[1]).

-3
--3way
--no-3way

Quand la rustine ne s’applique pas correctement, revenir Ă  une fusion Ă  3 points si la rustine contient l’identitĂ© des blobs auxquels elle est supposĂ©e s’appliquer et que ces blobs sont disponibles localement. --no-3way permet de surcharger la variable de configuration am.threeWay. Pour plus d’information, rĂ©fĂ©rez-vous Ă  am.threeWay dans git-config[1].

--rerere-autoupdate
--no-rerere-autoupdate

AprĂšs que le mĂ©canisme rerere rĂ©utilise une rĂ©solution enregistrĂ©e sur le conflit actuel pour mettre Ă  jour les fichiers dans l’arbre de travail, lui permettre de mettre Ă©galement Ă  jour l’index avec le rĂ©sultat de la rĂ©solution. --no-rerere-autoupdate est un bon moyen de revĂ©rifier ce que rerere a fait et de dĂ©tecter des erreurs de fusion potentielles, avant de valider le rĂ©sultat dans l’index avec un git add sĂ©parĂ©.

--ignore-space-change
--ignore-whitespace
--whitespace=<action>
-C<n>
-p<n>
--directory=<rép.>
--exclude=<chemin>
--include=<chemin>
--reject

Ces drapeaux sont transmis au programme git apply (voir git-apply[1]) qui applique le patch.

Les <action> valides pour l’option --whitespace sont : nowarn , warn , fix , error et error-all.

--patch-format

Par dĂ©faut, la commande tentera de dĂ©tecter automatiquement le format de la rustine. Cette option permet Ă  l’utilisateur de contourner la dĂ©tection automatique et de spĂ©cifier le format de rustine comme lequel la(les) rustine(s) doit/doivent ĂȘtre interprĂ©tĂ©e(s). Les formats valides sont mbox, mboxrd, stgit, stgit-series et hg.

-i
--interactive

Lancer de maniĂšre interactive.

-n
--no-verify

Par dĂ©faut, les crochets pre-applypatch et applypatch-msg sont exĂ©cutĂ©s. Lorsque l’une des options --no-verify ou -n est donnĂ©e, ils sont contournĂ©s. Voir aussi githooks[5].

--committer-date-is-author-date

Par dĂ©faut, la commande enregistre la date du message Ă©lectronique comme date de l’auteur du commit, et utilise l’heure de crĂ©ation du commit comme date du validateur. Cela permet Ă  l’utilisateur de mentir sur la date du validateur en utilisant la mĂȘme valeur que la date de l’auteur.

--ignore-date

Par dĂ©faut, la commande enregistre la date du message Ă©lectronique comme date de l’auteur du commit, et utilise l’heure de crĂ©ation du commit comme date du committeur. Cela permet Ă  l’utilisateur de mentir sur la date de l’auteur en utilisant la mĂȘme valeur que la date du validateur.

--skip

Sauter la rustine actuelle. Cela n’a de sens que si l’on redĂ©marre une rustine avortĂ©e.

-S[<idclé>]
--gpg-sign[=<idclé>]
--no-gpg-sign

Signer les commits avec GPG. L’argument idclĂ© est optionnel avec par dĂ©faut l’identitĂ© du validateur ; si spĂ©cifiĂ©e, elle doit ĂȘtre collĂ©e Ă  l’option sans aucun espace. --no-gpg-sign est utile pour annuler l’effet de la variable de configuration commit.gpgSign ainsi que tout --gpg-sign prĂ©cĂ©dent.

--continue
-r
--resolved

AprĂšs l’Ă©chec d’une rustine (par exemple, en cas de tentative d’application d’une rustine conflictuelle), l’utilisateur l’a appliquĂ©e Ă  la main et le fichier d’index stocke le rĂ©sultat de l’application. Faire un commit en utilisant le journal des auteurs et du commit extrait du message Ă©lectronique et du fichier d’index actuel, et continuer.

--resolvemsg=<msg>

En cas de dĂ©faillance d’un patch, <msg> sera imprimĂ© Ă  l’Ă©cran avant de sortir. Ceci remplace le message standard vous informant d’utiliser --continue ou --skip pour gĂ©rer l’Ă©chec. Ceci est uniquement pour un usage interne entre git rebase et git am.

--abort

Restaurer la branche originale et abandonner les opĂ©rations de rustinage. RĂ©tablir le contenu des fichiers impliquĂ©s dans l’opĂ©ration am Ă  leur Ă©tat prĂ©-am.

--quit

Abandonner l’opĂ©ration de rustinage mais garder HEAD et l’index intacts.

--retry

Essaie d’appliquer Ă  nouveau la derniĂšre rustine en conflit. Ceci n’est gĂ©nĂ©ralement utile que pour passer des options supplĂ©mentaires lors de la tentative de rĂ©-essai (p. ex. --3way), puisque sinon vous verrez la mĂȘme erreur Ă  nouveau.

--show-current-patch[=(diff|raw)]

Montrer le message auquel git am s’est arrĂȘtĂ© en raison de conflits. Si raw est spĂ©cifiĂ©, afficher le contenu brut du message Ă©lectronique ; si diff, afficher uniquement la partie diff. La valeur par dĂ©faut est raw.

--allow-empty

AprĂšs l’Ă©chec de rustinage sur un message Ă©lectronique d’entrĂ©e dĂ©pourvu de rustine, crĂ©er un commit vide avec le contenu du message Ă©lectronique comme message de validation.

DISCUSSION

Le nom de l’auteur du commit est tirĂ© du "From: "et la date de l’auteur du commit est tirĂ©e de la ligne "Date:" du message. Le "Subject:" est utilisĂ© comme titre du commit, aprĂšs avoir supprimĂ© le prĂ©fixe commun "[PATCH <quelque chose>]". La ligne "Subject:"est censĂ©e dĂ©crire de maniĂšre concise l’objet du commit en une seule ligne de texte.

Les lignes «From:», «Date:» et «Subject:» commençant le corps remplacent le nom de l’auteur de la validation et les valeurs de titre respectives tirĂ©es des en-tĂȘtes.

Le message de validation est formĂ© par le titre tirĂ© du "Subject:", une ligne vide et le corps du message jusqu’au dĂ©but du patch. Les espaces en excĂšs Ă  la fin de chaque ligne sont automatiquement supprimĂ©s.

La rustine devrait ĂȘtre incluse, Ă  la suite immĂ©diate du message. Toute ligne qui est de la forme :

  • trois tirets et fin de ligne, ou

  • une ligne qui commence par "diff -", ou

  • une ligne qui commence par "Index : "

est pris comme le dĂ©but d’une rustine, et le message de journal de validation est terminĂ© avant la premiĂšre occurrence d’une telle ligne.

Lorsque vous invoquez initialement git am, vous lui donnez les noms des boĂźtes aux lettres Ă  traiter. Il s’interrompt dĂšs le premier patch qui ne s’applique pas. Vous pouvez revenir Ă  un Ă©tat stable de deux façons :

  1. sauter la rustine en cours en relançant la commande avec l’option --skip.

  2. rĂ©soudre manuellement le conflit dans le rĂ©pertoire de travail, et mettre Ă  jour le fichier d’index pour le mettre dans un Ă©tat que la rustine aurait dĂ» produire. Ensuite, lancer la commande avec l’option --continue.

La commande refuse de traiter de nouvelles boĂźtes aux lettres tant que l’opĂ©ration en cours n’est pas terminĂ©e, donc si vous dĂ©cidez de repartir de zĂ©ro, lancez git am --abort avant d’exĂ©cuter la commande avec les noms des boĂźtes aux lettres.

Avant l’application de tout correctif, ORIG_HEAD est placĂ© au sommet de la branche en cours. C’est utile si vous avez des problĂšmes avec plusieurs commits, par exemple si vous lancez git am sur la mauvaise branche ou si une erreur dans les commits est plus facilement corrigĂ©e en changeant de boĂźte aux lettres (par exemple des erreurs dans les lignes "From :").

CROCHETS

Cette commande peut lancer les crochets applypatch-msg, pre-applypatch et post-applypatch. Voir githooks[5] pour de plus amples informations.

CONFIGURATION

Warning

Missing fr/includes/cmd-config-section-all.txt

See original version for this content.

Warning

Missing fr/config/am.txt

See original version for this content.

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