Accueil·Commandes du terminal

git am

git

Syntaxe

git am [-3] <mbox|patch>...

Transforme des correctifs reçus par courriel en commits en conservant auteur et message ; en cas d'échec il s'arrête au milieu de la série, à vous de conclure par --continue, --skip ou --abort.

Options courantes

OptionSignification
-3three-way merge when the patch does not apply cleanly
-sadd a Signed-off-by line
--continuego on after you fixed the conflict
--skipdrop this patch and continue the series
--abortundo the whole series
-kkeep the subject line exactly as it is

Exemples

git am 0001-fix-login.patch

commits the patch, keeping its original author

git am -3 *.patch

applies a whole series, merging where needed

git am --abort

returns to before the series started

Ce qui embrouille, c’est qu’annuler a plusieurs formes : déplacer là où pointe une branche n’est pas ajouter un commit qui l’inverse.

Comment lire

  • Les crochets [ ] marquent une partie facultative.
  • Les points de suspension … signifient qu’on peut en mettre plusieurs.
  • Les options sont sensibles à la casse : sur certaines commandes, -r et -R ne font pas la même chose.

Questions fréquentes

Q. Que fait git am ?

Transforme des correctifs reçus par courriel en commits en conservant auteur et message ; en cas d'échec il s'arrête au milieu de la série, à vous de conclure par --continue, --skip ou --abort.

Q. Comment l’écrire ?

git am [-3] <mbox|patch>... — les crochets marquent ce qui est facultatif.

Q. Combien d’options valent la peine ?

Il y en a 6 ici ; la liste complète est dans man git. Cette commande relève de git.

Commandes liées

page man: man git-am