Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
Guides
- gitattributes
- Command-line interface conventions
- Everyday Git
- Frequently Asked Questions (FAQ)
- Glossary
- Hooks
- gitignore
- gitmodules
- Revisions
- Submodules
- Tutorial
- Workflows
- All guides...
Administration
Plumbing Commands
- 2.46.1 → 2.47.0 no changes
- 2.46.0 07/29/24
- 2.45.1 → 2.45.2 no changes
- 2.45.0 04/29/24
- 2.43.1 → 2.44.2 no changes
- 2.43.0 11/20/23
- 2.42.2 → 2.42.3 no changes
- 2.42.1 11/02/23
- 2.41.1 → 2.42.0 no changes
- 2.41.0 06/01/23
- 2.40.1 → 2.40.3 no changes
- 2.40.0 03/12/23
- 2.38.1 → 2.39.5 no changes
- 2.38.0 10/02/22
- 2.35.1 → 2.37.7 no changes
- 2.35.0 01/24/22
- 2.33.2 → 2.34.8 no changes
- 2.33.1 10/12/21
- 2.32.1 → 2.33.0 no changes
- 2.32.0 06/06/21
- 2.31.1 → 2.31.8 no changes
- 2.31.0 03/15/21
- 2.30.1 → 2.30.9 no changes
- 2.30.0 12/27/20
- 2.27.1 → 2.29.3 no changes
- 2.27.0 06/01/20
- 2.26.1 → 2.26.3 no changes
- 2.26.0 03/22/20
- 2.25.1 → 2.25.5 no changes
- 2.25.0 01/13/20
- 2.22.1 → 2.24.4 no changes
- 2.22.0 06/07/19
- 2.17.1 → 2.21.4 no changes
- 2.17.0 04/02/18
- 2.11.4 → 2.16.6 no changes
- 2.10.5 09/22/17
- 2.9.5 07/30/17
- 2.8.6 no changes
- 2.7.6 07/30/17
- 2.6.7 05/05/17
- 2.4.12 → 2.5.6 no changes
- 2.3.10 09/28/15
- 2.2.3 no changes
- 2.1.4 no changes
- 2.0.5 12/17/14
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 configurationam.keepcr
peut ĂȘtre utilisĂ©e pour spĂ©cifier le comportement par dĂ©faut.--no-keep-cr
permet de surchargeram.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âŻ:
- -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 configurationam.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 surchargeram.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 configurationi18n.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 quererere
a fait et de dĂ©tecter des erreurs de fusion potentielles, avant de valider le rĂ©sultat dans l’index avec ungit 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
eterror-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 configurationcommit.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. Siraw
est spĂ©cifiĂ©, afficher le contenu brut du message Ă©lectroniqueâŻ; sidiff
, afficher uniquement la partie diff. La valeur par défaut estraw
. - --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âŻ:
-
sauter la rustine en cours en relançant la commande avec l’option
--skip
. -
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 See original version for this content. |
Warning
|
Missing 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 .