|
| 1 | +git-switch(1) |
| 2 | +============= |
| 3 | + |
| 4 | +NOM |
| 5 | +--- |
| 6 | +git-switch - bascule de branche |
| 7 | + |
| 8 | +SYNOPSIS |
| 9 | +-------- |
| 10 | +[verse] |
| 11 | +'git switch' [<options>] [--no-guess] <branche> |
| 12 | +'git switch' [<options>] --detach [<point-de-départ>] |
| 13 | +'git switch' [<options>] (-c|-C) <nouvelle-branche> [<point-de-départ>] |
| 14 | +'git switch' [<options>] --orphan <nouvelle-branche> |
| 15 | + |
| 16 | +DESCRIPTION |
| 17 | +----------- |
| 18 | +Passe à une branche spécifiée. L'arbre de travail et l'index sont mis à jour pour correspondre à la branche. Tous les nouveaux commits seront ajoutés au sommet de cette branche. |
| 19 | + |
| 20 | +En option, une nouvelle branche peut être créée avec les options `-c`, `-C`, automatiquement à partir d'une branche distante du même nom (voir `--guess`), ou détacher l'arbre de travail de toute branche avec `--detach` en même temps que la commutation. |
| 21 | + |
| 22 | +La commutation de branche ne nécessite pas d'index et d'arbre de travail propres(c.-à-d. aucune différence par rapport à `HEAD`). L'opération est interrompue cependant si l'opération entraîne une perte de modifications locales, sauf indication contraire via `--discard-changes` ou `--merge`. |
| 23 | + |
| 24 | +CETTE COMMANDE EST EXPÉRIMENTALE. LE COMPORTEMENT PEUT CHANGER. |
| 25 | + |
| 26 | +OPTIONS |
| 27 | +------- |
| 28 | +<branche>:: |
| 29 | + Branche sur laquelle commuter. |
| 30 | + |
| 31 | +<nouvelle-branche>:: |
| 32 | + Nom pour une nouvelle branche. |
| 33 | + |
| 34 | +<point_de_départ>:: |
| 35 | + The starting point for the new branch. Specifying a `<start-point>` allows you to create a branch based on some other point in history than where HEAD currently points. (Or, in the case of `--detach`, allows you to inspect and detach from some other point.) |
| 36 | ++ |
| 37 | +Vous pouvez utiliser la syntaxe `@{-N}` pour faire référence à la N-ième dernière branche ou commit sur lesquels on a basculé en utilisant une opération « git switch » ou « git checkout ». Vous pouvez aussi spécifier `-` qui est synonyme de `@{-1}`. C'est souvent utilisé pour basculer rapidement entre deux branches ou pour annuler un basculement par erreur. |
| 38 | ++ |
| 39 | +Autre cas spécial supplémentaire, vous pouvez utiliser `A...B` comme raccourci pour la base de fusion de `A` et `B` s'il y a exactement une seule base de fusion. Vous pouvez ne pas spécifier `A` ou `B`, auquel cas ce sera `HEAD` par défaut. |
| 40 | + |
| 41 | +-c <nouvelle-branche>:: |
| 42 | +--create <nouvelle-branche>:: |
| 43 | + Créer une nouvelle branche nommée `<nouvelle-branche>` commençant à `<point-de-départ>` avant de basculer sur cette branche. C'est l'équivalent transactionnel de |
| 44 | ++ |
| 45 | +------------ |
| 46 | +$ git branch <nouvelle-branche> |
| 47 | +$ git switch <nouvelle-branche> |
| 48 | +------------ |
| 49 | ++ |
| 50 | +that is to say, the branch is not reset/created unless "git switch" is successful (e.g., when the branch is in use in another worktree, not just the current branch stays the same, but the branch is not reset to the start-point, either). |
| 51 | + |
| 52 | +-C <nouvelle-branche>:: |
| 53 | +--force-create <nouvelle-branche>:: |
| 54 | + Similar to `--create` except that if `<new-branch>` already exists, it will be reset to `<start-point>`. This is a convenient shortcut for: |
| 55 | ++ |
| 56 | +------------ |
| 57 | +$ git branch -f <nouvelle-branche> |
| 58 | +$ git switch <nouvelle-branche> |
| 59 | +------------ |
| 60 | + |
| 61 | +-d:: |
| 62 | +--detach:: |
| 63 | + Switch to a commit for inspection and discardable experiments. See the "DETACHED HEAD" section in linkgit:git-checkout[1] for details. |
| 64 | + |
| 65 | +--guess:: |
| 66 | +--no-guess:: |
| 67 | + Si la `<branche>` n'est pas trouvée mais qu'il existe une branche de suivi pour un dépôt distant unique (appelé `<distant>`) avec un nom correspondant, le traiter comme équivalent à |
| 68 | ++ |
| 69 | +------------ |
| 70 | +$ git switch -c <branche> --track <distant>/<branche> |
| 71 | +------------ |
| 72 | ++ |
| 73 | +Si la branche existe dans plus d'un distant et que l'un d'entre eux est la valeur de la variable de configuration `checkout.defaultRemote`, celui-ci sera utilisé pour désambiguïser, même si la <branche> n'est pas unique parmi tous les distants. Réglez la variable `checkout.defaultRemote=origin` par exemple pour extraire toujours les branches distantes depuis celle-ci si <branche> est ambigüe mais existe sur le distant 'origin'. Voir aussi `checkout.defaultRemote` dans linkgit:git-config[1]. |
| 74 | ++ |
| 75 | +`--guess` est le comportement par défaut. Utilisez `--no-guess` pour le désactiver. |
| 76 | ++ |
| 77 | +Le comportement par défaut peut être défini via la variable de configuration `checkout.guess`. |
| 78 | + |
| 79 | +-f:: |
| 80 | +--force:: |
| 81 | + An alias for `--discard-changes`. |
| 82 | + |
| 83 | +--discard-changes:: |
| 84 | + Proceed even if the index or the working tree differs from `HEAD`. Both the index and working tree are restored to match the switching target. If `--recurse-submodules` is specified, submodule content is also restored to match the switching target. This is used to throw away local changes. |
| 85 | + |
| 86 | +-m:: |
| 87 | +--merge:: |
| 88 | + Si vous avez des modifications locales sur un fichier ou plus qui sont différentes entre la branche actuelle et celle sur laquelle vous basculez, la commande refuse le basculement pour préserver vos modifications dans leur contexte. Cependant, avec cette option, une fusion à trois points entre la branche actuelle, le contenu de votre arbre de travail et la nouvelle branche est opérée et vous serez sur la nouvelle branche. |
| 89 | ++ |
| 90 | +Quand un conflit de fusion apparaît, les entrées d'index pour les chemins en conflit sont laissées non-fusionnées et vous devez résoudre les conflits et les marquer résolus pour les chemins concernés avec `git add` (ou `git rm` si la fusion doit aboutir à la suppression du chemin). |
| 91 | + |
| 92 | +--conflict=<style>:: |
| 93 | + Identique à l'option `--merge` ci-dessus, mais la manière dont les sections en conflits sont présentées est modifiée, en surchargeant la variable de configuration `merge.conflictStyle`. Les valeurs possibles sont `merge` (fusion, par défaut), `diff3` et `zdiff3`. |
| 94 | + |
| 95 | +-q:: |
| 96 | +--quiet:: |
| 97 | + Silencieux, supprimer les messages d'état. |
| 98 | + |
| 99 | +--progress:: |
| 100 | +--no-progress:: |
| 101 | + L'état d'avancement est affiché sur la sortie standard d'erreur par défaut quand elle est attachée à un terminal, à moins que `--quiet` ne soit spécifié. Cette bascule active l'état d'avancement même sans être attaché à un terminal, indépendamment de `--quiet`. |
| 102 | + |
| 103 | +-t:: |
| 104 | +--track [direct|inherit]:: |
| 105 | + À la création d'une nouvelle branche, établir la configuration 'upstream' (branche amont). `-c` est implicite. Voir `--track` dans linkgit:git-branch[1] pour plus de détails. |
| 106 | ++ |
| 107 | +Si aucune option `-c` n'est fournie, le nom de la nouvelle branche sera dérivé de la branche de suivi à distance, en regardant la partie locale de la spécification de référence configurée pour le distant correspondant et en enlevant la partie initiale jusqu'au "*". Cela indiquerait d'utiliser le nom `hack` comme branche locale créée à partir de `origin/hack` (ou `remotes/origin/hack`, ou même `refs/remotes/origin/hack`). Si le nom fourni ne contient pas de barre oblique, ou si le résultat de la dérivation est un nom vide, la dérivation échoue. Vous pouvez spécifier explicitement un nom avec `-c` dans ce cas. |
| 108 | + |
| 109 | +--no-track:: |
| 110 | + Ne pas renseigner la configuration « amont », même si la configuration `branch.autoSetupMerge` est true. |
| 111 | + |
| 112 | +--orphan <nouvelle-branche>:: |
| 113 | + Create a new unborn branch, named `<new-branch>`. All tracked files are removed. |
| 114 | + |
| 115 | +--ignore-other-worktrees:: |
| 116 | + `git switch` échoue quand la référence voulue est déjà extraite dans un autre arbre de travail. Cette option force l'extraction. En d'autres termes, la réf peut être tenue par plus d'un arbre de travail. |
| 117 | + |
| 118 | +--recurse-submodules:: |
| 119 | +--no-recurse-submodules:: |
| 120 | + L'utilisation de `--recurse-submodules` permet de mettre à jour le contenu de tous les sous-modules actifs en fonction du commit enregistré dans le super-projet. Si l'option n'est pas spécifiée (ou si `--no-recurse-submodules` est spécifié), les arbres de travail des sous-modules ne sont pas mis à jour. Comme linkgit:git-submodule[1], les `HEAD` des sous-modules seront détachées. |
| 121 | + |
| 122 | +EXEMPLES |
| 123 | +-------- |
| 124 | + |
| 125 | +The following command switches to the "master" branch: |
| 126 | + |
| 127 | +------------ |
| 128 | +$ git switch master |
| 129 | +------------ |
| 130 | + |
| 131 | +Après avoir travaillé dans la mauvaise branche, basculer sur la branche correcte serait réalisé par : |
| 132 | + |
| 133 | +------------ |
| 134 | +$ git switch monsujet |
| 135 | +------------ |
| 136 | + |
| 137 | +Cependant, votre « fausse » branche et votre branche correcte « monsujet » peuvent être différentes par les fichiers que vous avez modifiés localement, auquel cas le basculement ci-dessus échouerait comme ceci : |
| 138 | + |
| 139 | +------------ |
| 140 | +$ git switch monsujet |
| 141 | +error : Vos modifications locales aux fichiers suivants seraient écrasées par l'extraction : |
| 142 | +------------ |
| 143 | + |
| 144 | +Vous pouvez fournir l'option `-m` à la commande, ce qui essaierait une fusion à trois points : |
| 145 | + |
| 146 | +------------ |
| 147 | +$ git switch -m monsujet |
| 148 | +Fusion automatique de frotz |
| 149 | +------------ |
| 150 | + |
| 151 | +Après cette fusion à trois points, les modifications locales ne sont _pas_ enregistrées dans votre index, donc `git diff` vous montrerait ce qui a changé depuis le sommet de la nouvelle branche. |
| 152 | + |
| 153 | +To switch back to the previous branch before we switched to mytopic (i.e. "master" branch): |
| 154 | + |
| 155 | +------------ |
| 156 | +$ git switch - |
| 157 | +------------ |
| 158 | + |
| 159 | +You can grow a new branch from any commit. For example, switch to "HEAD~3" and create branch "fixup": |
| 160 | + |
| 161 | +------------ |
| 162 | +$ git switch -c fixup HEAD~3 |
| 163 | +Switched to a new branch 'fixup' |
| 164 | +------------ |
| 165 | + |
| 166 | +Si vous souhaitez démarrer une branche nouvelle depuis une branche distante du même nom : |
| 167 | + |
| 168 | +------------ |
| 169 | +$ git switch new-topic |
| 170 | +Branch 'new-topic' set up to track remote branch 'new-topic' from 'origin' |
| 171 | +Switched to a new branch 'new-topic' |
| 172 | +------------ |
| 173 | + |
| 174 | +To check out commit `HEAD~3` for temporary inspection or experiment without creating a new branch: |
| 175 | + |
| 176 | +------------ |
| 177 | +$ git switch --detach HEAD~3 |
| 178 | +HEAD is now at 9fc9555312 Merge branch 'cc/shared-index-permbits' |
| 179 | +------------ |
| 180 | + |
| 181 | +If it turns out whatever you have done is worth keeping, you can always create a new name for it (without switching away): |
| 182 | + |
| 183 | +------------ |
| 184 | +$ git switch -c good-surprises |
| 185 | +------------ |
| 186 | + |
| 187 | +CONFIGURATION |
| 188 | +------------- |
| 189 | + |
| 190 | +Tout ce qui se trouve en dessous de cette ligne dans cette section est inclus de manière sélective à partir de la documentation linkgit:git-config[1]. Le contenu est le même que celui qui s'y trouve : |
| 191 | +[] |
| 192 | + |
| 193 | + |
| 194 | + |
| 195 | +[WARNING] |
| 196 | +==== |
| 197 | +Missing `fr/config/checkout.adoc` |
| 198 | + |
| 199 | +See original version for this content. |
| 200 | +==== |
| 201 | + |
| 202 | +[] |
| 203 | + |
| 204 | +VOIR AUSSI |
| 205 | +---------- |
| 206 | +linkgit:git-checkout[1], linkgit:git-branch[1] |
| 207 | + |
| 208 | +GIT |
| 209 | +--- |
| 210 | +Fait partie de la suite linkgit:git[1] |
| 211 | + |
| 212 | +TRADUCTION |
| 213 | +---------- |
| 214 | +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 . |
0 commit comments