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.44.1 → 2.45.2 no changes
- 2.44.0 02/23/24
- 2.43.2 → 2.43.5 no changes
- 2.43.1 02/09/24
- 2.43.0 11/20/23
- 2.39.1 → 2.42.3 no changes
- 2.39.0 12/12/22
- 2.36.1 → 2.38.5 no changes
- 2.36.0 04/18/22
- 2.33.1 → 2.35.8 no changes
- 2.33.0 08/16/21
- 2.30.1 → 2.32.7 no changes
- 2.30.0 12/27/20
- 2.23.1 → 2.29.3 no changes
- 2.23.0 08/16/19
- 2.22.1 → 2.22.5 no changes
- 2.22.0 06/07/19
- 2.21.1 → 2.21.4 no changes
- 2.21.0 02/24/19
- 2.19.1 → 2.20.5 no changes
- 2.19.0 09/10/18
- 2.18.1 → 2.18.5 no changes
- 2.18.0 06/21/18
- 2.15.4 → 2.17.6 no changes
- 2.14.6 12/06/19
- 2.13.7 05/22/18
- 2.12.5 09/22/17
- 2.9.5 → 2.11.4 no changes
- 2.8.6 07/30/17
- 2.7.6 07/30/17
- 2.6.7 05/05/17
- 2.5.6 no changes
- 2.4.12 05/05/17
- 2.3.10 no changes
- 2.2.3 09/04/15
- 2.1.4 no changes
- 2.0.5 12/17/14
DESCRIPTION
- base de donnĂ©es d’objets substituts
-
GrĂące au mĂ©canisme des substituts, un dĂ©pĂŽt peut hĂ©riter d’une partie de sa base de donnĂ©es d’objets d’une autre base de donnĂ©es d’objets, qui est appelĂ©e un "substitut".
- dépÎt nu
-
Un dépÎt nu est normalement un répertoire nommé de maniÚre appropriée avec un suffixe
.git
qui n’a pas de copie locale de tous les fichiers sous contrĂŽle de rĂ©vision. C’est-Ă -dire que tous les fichiers d’administration et de contrĂŽle de Git qui seraient normalement prĂ©sents dans le sous-rĂ©pertoire cachĂ©.git
sont directement présents dans le répertoirerepository.git
Ă la place, et aucun autre fichier n’est prĂ©sent et extrait. Habituellement, les Ă©diteurs de dĂ©pĂŽts publics mettent Ă disposition des dĂ©pĂŽts nus. - objet blob
-
Objet non typĂ©, par exemple le contenu d’un fichier.
- branche
-
Une "branche" est une ligne de dĂ©veloppement. Le commit le plus rĂ©cent sur une branche est appelĂ© sommet de cette branche. Le sommet de la branche est rĂ©fĂ©rencĂ© par une tĂȘte de branche, qui avance au fur et Ă mesure que des dĂ©veloppements supplĂ©mentaires sont effectuĂ©s sur la branche. Un seul dĂ©pĂŽt Git peut suivre un nombre arbitraire de branches, mais votre arbre de travail est associĂ© Ă une seule d’entre elles (la branche "actuelle" ou "extraite"), et HEAD pointe vers cette branche.
- cache
-
ObsolĂšte pour : index.
- chaĂźne
-
Une liste d’objets, oĂč chaque objet de la liste contient une rĂ©fĂ©rence Ă son successeur (par exemple, le successeur d’un commit pourrait ĂȘtre un de ses parents).
- ensemble de modifications
-
BitKeeper/cvsps parlent de "commit". Puisque Git ne stocke pas les modifications, mais les Ă©tats, cela n’a pas vraiment de sens d’utiliser le terme "ensemble de modifications" avec Git.
- extraction
-
L’action de mettre Ă jour tout ou partie de l'arbre de travail avec un objet arbre ou un blob de la base de donnĂ©es des objets, et en mettant Ă jour l' index et la HEAD si l’ensemble de l’arbre de travail a Ă©tĂ© dirigĂ© vers une nouvelle branche.
- picorage
-
Dans le jargon SCM, "picorage" signifie choisir un sous-ensemble de modifications dans une sĂ©rie de modifications (gĂ©nĂ©ralement des commits) et les enregistrer comme une nouvelle sĂ©rie de modifications sur une base de code diffĂ©rente. Dans Git, cela est effectuĂ© par la commande "git cherry-pick" pour extraire la modification introduite par un commit existant et pour l’enregistrer en fonction du sommet de la branche actuelle en tant que nouveau commit.
- propre
-
Un arbre de travail est propre, s’il correspond Ă la rĂ©vision rĂ©fĂ©rencĂ©e par la tĂȘte courante. Voir aussi "sale".
- commit
-
En tant que substantifâŻ: Un point unique dans l’historique de GitâŻ; l’historique complet d’un projet est reprĂ©sentĂ© comme un ensemble de commits interconnectĂ©s. Le mot "commit" est souvent utilisĂ© par Git aux mĂȘmes endroits oĂč d’autres systĂšmes de contrĂŽle de rĂ©vision utilisent les mots "revision" ou "version". Ăgalement utilisĂ© comme raccourci pour objet commit.
- concept, représentations et utilisation du graphe de commit
-
Un synonyme de la structure DAG (Directed Acyclic GraphâŻ: graphe dirigĂ© acyclique) formĂ©e par les commits de la base de donnĂ©es des objets, rĂ©fĂ©rencĂ©s par les sommets de branches, en utilisant leur chaĂźne de commits liĂ©s. Cette structure est le graphe de commits dĂ©finitif. Le graphe peut ĂȘtre reprĂ©sentĂ© d’autres façons, par exemple par le fichier "commit-graph".
- fichier de graphe de commit
-
Le fichier "commit-graph" (normalement avec un trait d’union) est une reprĂ©sentation supplĂ©mentaire du graphe de commit qui accĂ©lĂšre les parcours du graphe de commit. Le fichier "commit-graph" est stockĂ© soit dans le rĂ©pertoire .git/objects/info, soit dans le rĂ©pertoire info d’une base de donnĂ©es d’objets alternative.
- objet commit
-
Un objet qui contient les informations sur une révision particuliÚre, telles que ses parents, validateur, auteur, date et le objet arbre qui correspond au répertoire racine de la révision stockée.
- commit-esque (Ă©galement commitesque)
-
Un objet commit ou un objet qui peut ĂȘtre dĂ©rĂ©fĂ©rencĂ© rĂ©cursivement vers un objet commit. Les Ă©lĂ©ments suivants sont tous des objets commitâŻ: un objet commit, un objet Ă©tiquette qui pointe vers un objet commit, un objet Ă©tiquette qui pointe vers un objet Ă©tiquette qui pointe vers un objet commit, etc.
- cĆur Git
-
Structures de donnĂ©es fondamentales et utilitaires de Git. N’expose que des outils limitĂ©s de gestion du code source.
- DAG
-
Graphe acyclique dirigĂ© ('Directed Acyclique Graph"). Les objets commit forment un graphe acyclique dirigĂ©, car ils ont des parents (dirigĂ©s), et le graphe des objets commit est acyclique (il n’y a pas de chaĂźne qui commence et se termine par le mĂȘme objet).
- objet en suspens
-
Un objet inatteignable qui n’est pas joignable mĂȘme Ă partir d’autres objets inatteignables ; un objet en suspens n’a aucune rĂ©fĂ©rence vers lui Ă partir de n’importe quelle rĂ©fĂ©rence ou objet dans le dĂ©pĂŽt.
- déréférence
-
Se rĂ©fĂ©rant Ă une rĂ©fĂ©rence symbolique âŻ: l’action d’accĂ©der Ă la rĂ©fĂ©rence pointĂ©e par une rĂ©f symbolique. Le dĂ©rĂ©fĂ©rencement rĂ©cursif implique de rĂ©pĂ©ter le processus susmentionnĂ© sur la rĂ©f rĂ©sultante jusqu’Ă ce qu’une rĂ©fĂ©rence non symbolique soit trouvĂ©e.
Se rĂ©fĂ©rant Ă un objet Ă©tiquetteâŻ: l’action d’accĂ©der Ă l'objet pointĂ© par une Ă©tiquette. Les Ă©tiquettes sont rĂ©fĂ©rencĂ©es de façon rĂ©cursive en rĂ©pĂ©tant l’opĂ©ration sur l’objet du rĂ©sultat jusqu’Ă ce que le rĂ©sultat ait le type d’objet spĂ©cifiĂ© (le cas Ă©chĂ©ant) ou tout type d’objet non "Ă©tiquette". Un synonyme de "dĂ©rĂ©fĂ©rencer rĂ©cursivement" dans le contexte des Ă©tiquettes est peler".
Se rĂ©fĂ©rant Ă un objet commitâŻ: action d’accĂ©der Ă l’objet arbre du commit. Les commits ne peuvent pas ĂȘtre dĂ©rĂ©fĂ©rĂ©s de façon rĂ©cursive.
Sauf indication contraire, "dĂ©rĂ©fĂ©rencer" tel qu’il est utilisĂ© dans le contexte des commandes ou des protocoles Git est implicitement rĂ©cursif.
- HEAD détachée
-
Normalement, la HEAD stocke le nom d’une branche et les commandes qui opĂšrent sur l’historique que reprĂ©sente le HEAD opĂšrent sur l’historique menant au sommet de la branche vers laquelle pointe la HEAD. Cependant, Git vous permet Ă©galement d' extraire un commit arbitraire qui n’est pas nĂ©cessairement le sommet d’une branche particuliĂšre. La HEAD dans un tel Ă©tat est appelĂ© "dĂ©tachĂ©e".
Notez que les commandes qui opĂšrent sur l’historique de la branche actuelle (par exemple
git commit
pour construire un nouvel historique par dessus) fonctionnent toujours mĂȘme si la HEAD est dĂ©tachĂ©e. Elles mettent Ă jour la HEAD pour pointer Ă l’extrĂ©mitĂ© de l’historique mis Ă jour sans affecter aucune branche. Les commandes qui mettent Ă jour ou demandent des informations sur la branche courante (par exemplegit branch --set-upstream-to
qui dĂ©finit avec quelle branche de suivi Ă distance la branche actuelle s’intĂšgre) ne fonctionnent Ă©videmment pas, car il n’y a pas de branche actuelle (rĂ©elle) Ă demander dans cet Ă©tat. - rĂ©pertoire
-
La liste que vous obtenez avec "ls" :-)
- sale
-
Un arbre de travail est dit "sale" s’il contient des modifications qui n’ont pas Ă©tĂ© validĂ©es dans la branche actuelle.
- fusion maléfique
-
Une fusion malĂ©fique est une fusion qui introduit des modifications qui n’apparaissent dans aucun des parents.
- avance rapide
-
Une avance rapide est un type spĂ©cial de fusion oĂč vous avez une rĂ©vision et vous "fusionnez" les modifications d’une autre branche qui se trouvent ĂȘtre descendantes de ce que vous avez. Dans ce cas, vous ne faites pas un nouveau commit de fusion mais vous mettez simplement Ă jour votre branche pour qu’elle pointe vers la mĂȘme rĂ©vision que la branche que vous fusionnez. Cela se produit frĂ©quemment sur une branche de suivis Ă distance d’un dĂ©pĂŽt distant.
- récupérer
-
RĂ©cupĂ©rer une branche signifie obtenir la rĂ©fĂ©rence head de la branche Ă partir d’un dĂ©pĂŽt distant, pour trouver quels objets manquent dans la base de donnĂ©es d’objets locale, et les obtenir Ă©galement. Voir aussi git-fetch[1].
- systĂšme de fichiers
-
Linus Torvalds a conçu Ă l’origine Git pour ĂȘtre un systĂšme de fichiers en espace utilisateur, c’est-Ă -dire l’infrastructure pour contenir les fichiers et les rĂ©pertoires. Cela garantissait l’efficacitĂ© et la rapiditĂ© de Git.
- Archives Git
-
Synonyme de dĂ©pĂŽt (pour les utilisateurs d’Arch).
- fichier-git
-
Un simple fichier
.git
Ă la racine d’un arbre de travail qui pointe vers le rĂ©pertoire qui est le vrai dĂ©pĂŽt. Pour une utilisation appropriĂ©e voir git-worktree[1] ou git-submodule[1]. Pour la syntaxe voir gitrepository-layout[5]. - greffes
-
Les greffes permettent de relier deux lignes de dĂ©veloppement diffĂ©rentes en enregistrant de fausses informations d’ascendance pour les commits. De cette façon, vous pouvez faire croire Ă Git que l’ensemble des parents d’un commit est diffĂ©rent de ce qui a Ă©tĂ© enregistrĂ© lors de la crĂ©ation du commit. ConfigurĂ© via le fichier
.git/info/grafts
.Notez que le mĂ©canisme de greffes est dĂ©passĂ© et peut conduire Ă des problĂšmes de transfert d’objets entre dĂ©pĂŽts ; voir git-replace[1] pour un systĂšme plus flexible et plus robuste pour faire la mĂȘme chose.
- hachage
-
Dans le contexte de Git, synonyme de nom de l’objet.
- tĂȘte
-
Une rĂ©fĂ©rence nommĂ©e au commit au sommet d’une branche. Les tĂȘtes sont stockĂ©es dans un fichier dans le rĂ©pertoire
$GIT_DIR/refs/heads/
, sauf lors de l’utilisation de refs empaquetĂ©es. (Voir git-pack-refs[1].) - HEAD
-
La branche actuelle. Plus en dĂ©tailâŻ: Votre arbre de travail est normalement dĂ©rivĂ© de l’Ă©tat de l’arbre auquel fait rĂ©fĂ©rence HEAD. HEAD est une rĂ©fĂ©rence Ă l’un des tĂȘtes de votre dĂ©pĂŽt, sauf si vous utilisez une HEAD dĂ©tachĂ©e, auquel cas elle fait directement et librement rĂ©fĂ©rence Ă un commit.
- rĂ©f. tĂȘte
-
Un synonyme de tĂȘte.
- crochet
-
Au cours de l’exĂ©cution normale de plusieurs commandes Git, des appels sont faits Ă des scripts optionnels qui permettent Ă un dĂ©veloppeur d’ajouter des fonctionnalitĂ©s ou des vĂ©rifications. Typiquement, les crochets permettent de prĂ©-vĂ©rifier une commande et de l’interrompre Ă©ventuellement, et permettent une post-notification une fois l’opĂ©ration effectuĂ©e. Les scripts de crochet se trouvent dans le rĂ©pertoire
$GIT_DIR/hooks/
, et sont activés en retirant simplement le suffixe.sample
du nom du fichier. Dans les versions précédentes de Git, vous deviez les rendre exécutables. - index
-
Une collection de fichiers contenant des informations sur les statuts, dont le contenu est stockĂ© sous forme d’objets. L’index est une version stockĂ©e de votre arbre de travail. Ă vrai dire, il peut aussi contenir une deuxiĂšme, voire une troisiĂšme version d’un arbre de travail, qui sont utilisĂ©es lors de fusions.
- entrĂ©e dâindex
-
Les informations concernant un fichier particulier, stockĂ©es dans l'index. Une entrĂ©e d’index peut ĂȘtre non-fusionnĂ©e, si une fusion a Ă©tĂ© lancĂ©e, mais pas encore terminĂ© (c’est-Ă -dire si l’index contient plusieurs versions de ce fichier).
- master
-
La branche de développement par défaut. Chaque fois que vous créez une dépÎt Git, une branche nommée "master" est créée et devient la branche active. Dans la plupart des cas, elle contient le développement local, bien que cela soit purement par convention et ne soit pas nécessaire.
- fusionner
-
Apporter le contenu d’une autre branche (Ă©ventuellement d’un dĂ©pĂŽt externe) dans la branche actuelle. Dans le cas oĂč la branche fusionnĂ©e provient d’un dĂ©pĂŽt diffĂ©rent, cela est fait en commençant par rĂ©cupĂ©rer la branche distante et en fusionnant ensuite le rĂ©sultat dans la branche actuelle. Cette combinaison d’opĂ©rations de rĂ©cupĂ©ration et de fusion est appelĂ©e une tirage. La fusion est effectuĂ©e par un processus automatique qui identifie les modifications apportĂ©es depuis que les branches ont divergĂ©, puis applique toutes ces modifications ensemble. Dans les cas oĂč les modifications entrent en conflit, une intervention manuelle peut ĂȘtre nĂ©cessaire pour effectuer la fusion.
Comme nom (fusion)âŻ: Ă moins qu’il ne s’agisse d’une avance rapide, une fusion rĂ©ussie entraĂźne la crĂ©ation d’un nouveau commit reprĂ©sentant le rĂ©sultat de la fusion, et ayant comme parents les sommets des branches fusionnĂ©es. Ce commit est appelĂ© un "commit de fusion" , ou parfois simplement une "fusion".
- objet
-
L’unitĂ© de stockage dans Git. Il est identifiĂ© de maniĂšre unique par le SHA-1 de son contenu. Par consĂ©quent, un objet ne peut pas ĂȘtre modifiĂ©.
- base de donnĂ©es d’objets
-
Stocke un ensemble d' "objets", et un objet individuel est identifiĂ© par son nom d’objet. Les objets se trouvent gĂ©nĂ©ralement dans
$GIT_DIR/objects/
. - identifiant d’objet (oid)
-
Synonyme de nom d’objet.
- nom d’objet
-
L’identifiant unique d’un objet. Le nom de l’objet est gĂ©nĂ©ralement reprĂ©sentĂ© par une chaĂźne hexadĂ©cimale de 40 caractĂšres. Aussi appelĂ© familiĂšrement SHA-1.
- type d’objet
-
Un identificateur parmi "commit", "arbre (tree)", "Ă©tiquette (tag)" ou "blob" dĂ©crivant le type d’un objet.
- pieuvre
- orphelin
-
L’acte de se mettre sur une branche qui n’existe pas encore (c.-Ă -d. une branche non-nĂ©e). AprĂšs une telle opĂ©ration, le commit crĂ©Ă© devient un commit sans parent, commençant un nouvel historique.
- origine
-
Le dĂ©pĂŽt amont par dĂ©faut. La plupart des projets ont au moins un projet amont qu’ils suivent. Par dĂ©faut, le nom origin est utilisĂ© Ă cette fin. Les nouvelles mises Ă jour amont seront rĂ©cupĂ©rĂ©es dans des branches de suivi Ă distance nommĂ©es origin/nom-de-la-branche-amont, que vous pouvez voir en utilisant
git branch -r
. - superposition
-
Ne fait que mettre Ă jour et ajouter des fichiers dans le rĂ©pertoire de travail, mais ne les supprime pas, de la mĂȘme maniĂšre que cp -R mettrait Ă jour le contenu du rĂ©pertoire de destination. C’est le mode par dĂ©faut de l'extraction lors de l’extraction de fichiers depuis l'index ou un arbresque. En revanche, le mode sans superposition supprime Ă©galement les fichiers suivis qui ne sont pas prĂ©sents dans la source, de maniĂšre similaire Ă rsync --delete.
- paquet
-
Un ensemble d’objets qui ont Ă©tĂ© compressĂ©s en un seul fichier (pour gagner de l’espace ou pour les transmettre efficacement).
- index du paquet
-
La liste des identifiants, et d’autres informations, des objets dans un paquet, pour aider Ă accĂ©der efficacement au contenu d’un paquet.
- spéc-de-chemin
-
Motif utilisé pour limiter les chemins dans les commandes Git.
Les spĂ©cifications de chemin sont utilisĂ©es sur la ligne de commande de "git ls-files", "git ls-tree", "git add", "git grep", "git diff", "git checkout" et de nombreuses autres commandes pour limiter la portĂ©e des opĂ©rations Ă un sous-ensemble de l’arbre ou de l’arbre de travail. Consultez la documentation de chaque commande pour savoir si les chemins sont relatifs au rĂ©pertoire courant ou au premier niveau. La syntaxe de spĂ©cificateurs de chemin est la suivanteâŻ:
-
tout chemin correspond Ă lui-mĂȘme
-
le spĂ©cificateur de chemin jusqu’Ă la derniĂšre barre oblique reprĂ©sente un prĂ©fixe de rĂ©pertoire. La portĂ©e de ce spĂ©cificateur de chemin est limitĂ©e Ă ce sous-arbre.
-
le reste du spĂ©cificateur de chemin est un motif pour le reste du nom de chemin. Les chemins relatifs au prĂ©fixe du rĂ©pertoire seront comparĂ©s Ă ce motif en utilisant fnmatch(3)âŻ; en particulier, * et ? peuvent correspondre aux sĂ©parateurs de rĂ©pertoire.
Par exemple, Documentation/*.jpg correspondra Ă tous les fichiers .jpg du sous-arbre Documentation, y compris Documentation/chapitre_1/figure_1.jpg.
Un spécificateur de chemin qui commence par un deux-points
:
a une signification particuliĂšre. Dans la forme courte, le deux-points de tĂȘte:
sont suivis par zéro ou plusieurs lettres de la "signature magique" (qui se termine éventuellement par un autre deux-points:
), et le reste est le motif Ă faire correspondre au chemin. La "signature magique" est constituĂ©e de symboles ASCII qui ne sont ni des caractĂšres alphanumĂ©riques, ni des glob, ni des caractĂšres spĂ©ciaux de regex, ni des deux-points. Le deux-points facultatif qui termine la "signature magique" peut ĂȘtre omis si le motif commence par un caractĂšre qui n’appartient pas au jeu de symboles de la "signature magique" et qui n’est pas un deux-points.Dans la forme longue, le deux-points de tĂȘte
:
est suivi d’une parenthĂšse ouverte(
, d’une liste de zĂ©ro ou plus de "mots magiques" sĂ©parĂ©e par des virgules, et d’une parenthĂšse fermĂ©e)
, et le reste est le motif Ă comparer au chemin.Un spĂ©cificateur de chemin avec seulement un deux-points signifie "il n’y a pas de spĂ©cificateur de chemin". Cette forme ne doit pas ĂȘtre combinĂ©e avec d’autres spĂ©cificateurs de chemin.
- top
-
Le mot magique
top
(signature magique :/
) fait correspondre le motif Ă partir de la racine de l’arbre de travail, mĂȘme si vous exĂ©cutez la commande depuis un sous-rĂ©pertoire. - literal
-
Les caractÚres génériques dans le motif tels que
*
ou?
sont traités comme des caractÚres littéraux. - icase
-
Correspondance insensible Ă la casse.
- glob
-
Git traite le motif comme un glob shell qui peut ĂȘtre utilisĂ© par fnmatch(3) avec l’option FNM_PATHNAMEâŻ: les caractĂšres gĂ©nĂ©riques du motif ne correspondent pas Ă un / dans le chemin d’accĂšs. Par exemple, "Documentation/*.html"âŻ; correspond Ă "Documentation/git.html"âŻ; mais pas Ă "Documentation/ppc/ppc.html"âŻ; ou Ă "tools/perf/Documentation/perf.html"âŻ;.
Deux astérisques consécutifs ("
**
") dans les motifs comparés au nom de chemin complet peuvent avoir une signification spéciale :-
Un "
**
" suivi d’une barre oblique signifie une correspondance dans tous les rĂ©pertoires. Par exemple, "**/foo
" correspond au fichier ou au répertoire "foo
" n’importe oĂč, comme le motif "foo
". "**/foo/bar
" correspond au fichier ou au répertoire "bar
" n’importe oĂč, directement sous le rĂ©pertoire "foo
". -
Un "
/**
" de queue correspond Ă tout ce qui se trouve Ă l’intĂ©rieur. Par exemple, "abc/**
" correspond Ă tous les fichiers du rĂ©pertoire "abc", relativement Ă l’emplacement du fichier.gitignore
, avec une profondeur infinie. -
Une barre oblique suivie de deux astĂ©risques consĂ©cutifs puis d’une barre oblique correspond Ă zĂ©ro ou plusieurs rĂ©pertoires. Par exemple, "
a/**/b
" correspond Ă "a/b
", "a/x/b
", "a/x/y/b
" et ainsi de suite. -
Les autres astérisques consécutifs sont considérés comme non valides.
La correspondance globale est incompatible avec la correspondance littérale.
-
- attr
-
AprĂšs
attr:
vient une liste, sĂ©parĂ©e par des espaces, d'« exigences d’attribut », qui doivent tous ĂȘtre satisfaits pour que le chemin soit considĂ©rĂ© comme une correspondanceâŻ; ceci est en plus de la correspondance habituelle des motifs non-magiques de spĂ©cificateur de chemin. Voir gitattributes[5].Chacun des attributs requis pour le chemin prend l’une de ces formes :
-
"
ATTR
" exige que l’attributATTR
soit défini. -
"
-ATTR
" exige que l’attributATTR
soit désactivé. -
"
ATTR=VALEUR
" exige que l’attributATTR
soit défini comme la chaßne de caractÚresVALEUR
. -
"
!ATTR
" exige que l’attributATTR
soit non spĂ©cifiĂ©.Notez que lors de la correspondance avec un objet arbre, les attributs sont toujours obtenus Ă partir de l’arbre de travail, et non de l’objet arbre donnĂ©.
-
- exclude
-
AprĂšs qu’un chemin corresponde Ă un spĂ©cificateur de chemin non exclu, il sera parcouru par tous les spĂ©cificateurs de chemin exclus (signature magiqueâŻ:
!
ou son synonyme^
). S’il correspond, le chemin est ignorĂ©. S’il n’y a pas de chemin d’accĂšs non exclu, l’exclusion est appliquĂ©e au rĂ©sultat comme si elle Ă©tait invoquĂ©e sans spĂ©cificateur de chemin.
-
- parent
-
Un objet commit contient une liste (Ă©ventuellement vide) du ou des prĂ©dĂ©cesseurs logiques dans la ligne de dĂ©veloppement, c’est-Ă -dire ses parents.
- peler
-
L’action de rĂ©cursivement dĂ©rĂ©fĂ©rencer un objet Ă©tiquette.
- pioche
-
Le terme pioche fait rĂ©fĂ©rence Ă une option des routines diffcore qui aide Ă sĂ©lectionner les modifications qui ajoutent ou suppriment une chaĂźne de texte donnĂ©e. Avec l’option
--pickaxe-all
, elle peut ĂȘtre utilisĂ©e pour afficher la totalitĂ© des ensembles de modifications qui ont introduit ou supprimĂ©, disons, une ligne de texte particuliĂšre. Voir git-diff[1]. - plomberie
-
Nom mignon pour core Git.
- porcelaine
-
Nom mignon pour les programmes et les suites de programmes dépendant de core Git, présentant une interface de haut niveau au noyau Git. Les porcelaines exposent une interface plus SCM que la la plomberie.
- référence par-arbre-de-travail
-
Les rĂ©fĂ©rences qui sont par-arbre-de-travail, plutĂŽt que globales. Il ne s’agit actuellement que de HEAD et de toutes les rĂ©fĂ©rences qui commencent par
refs/bisect/
, mais pourraient ultĂ©rieurement inclure d’autres rĂ©fĂ©rences inhabituelles. - pseudoref
-
Une rĂ©f qui a une sĂ©mantique diffĂ©rente des rĂ©fs normales. Ces rĂ©fs peuvent ĂȘtre accĂ©dĂ©es par des commandes Git normales mais peuvent pas ĂȘtre Ă©crites par des commandes comme git-update-ref[1].
Les pseudo-rĂ©fs suivantes sont connues de GitâŻ:
-
FETCH_HEAD
est Ă©crite par git-fetch[1] ou git-pull[1]. Elle peut faire rĂ©fĂ©rence Ă plusieurs identifiants d’objets. Chaque identifiant d’objet est annotĂ© avec des mĂ©tadonnĂ©es indiquant l’endroit d’oĂč il a Ă©tĂ© rĂ©cupĂ©rĂ© et son statut de rĂ©cupĂ©ration. -
MERGE_HEAD
est écrit par git-merge[1] lors de la résolution des conflits de fusion. Il contient tous les identifiants de commit qui sont fusionnés.
-
- tirage, tirer
-
Tirer une branche signifie la récupérer et la fusionner. Voir aussi git-pull[1].
- pousser
-
Pousser une branche signifie obtenir la la rĂ©fĂ©rence de tĂȘte Ă partir dâun dâun dĂ©pĂŽt distant, savoir sâil sâagit dâun ancĂȘtre de la rĂ©fĂ©rence de tĂȘte locale de la branche et, dans ce cas, placer tous les objets, qui sont accessibles de la rĂ©fĂ©rence de tĂȘte locale et qui sont manquants dans le dĂ©pĂŽt distant, dans la la base de donnĂ©es dâobjets distante et mettre Ă jour la rĂ©fĂ©rence de tĂȘte distante. Si la la tĂȘte distante nâest pas un ancĂȘtre de la tĂȘte locale, la poussĂ©e Ă©choue.
- accessible
-
Tous les ancĂȘtres dâun commit donnĂ© sont dits « accessibles » Ă partir de ce commit. Plus gĂ©nĂ©ralement, un objet est accessible depuis un autre si nous pouvons atteindre lâun de lâautre par une chaĂźne qui suit les Ă©tiquettes Ă tout ce quâils marquent, les commits Ă leurs parents ou arbres, et les arbres aux arbres ou les blobs quâils contiennent.
- bitmaps d’accessibilitĂ©
-
Les bitmaps d’accessibilitĂ© stockent des informations sur l'accessibilitĂ© d’un ensemble sĂ©lectionnĂ© de commits dans un fichier paquet, ou un index multi-paquet (MIDX), pour accĂ©lĂ©rer la recherche d’objets. Les bitmaps sont stockĂ©s dans un fichier ".bitmap". Un dĂ©pĂŽt peut avoir au maximum un fichier bitmap en cours d’utilisation. Le fichier bitmap peut appartenir soit Ă un paquet, soit Ă l’index multi-paquet du dĂ©pĂŽt (s’il existe).
- rebaser, rebasage
-
RĂ©appliquer une sĂ©rie de modifications dâune branche Ă une autre base et rĂ©initialiser la tĂȘte de cette branche au rĂ©sultat.
- réf, référence
-
Un nom qui pointe vers un nom dâobjet ou une autre rĂ©f (cette derniĂšre est appelĂ©e rĂ©f symbolique). Pour plus de commoditĂ©, une rĂ©f peut parfois ĂȘtre abrĂ©gĂ©e lorsquâelle est utilisĂ©e comme argument pour une commande GitâŻ; voir gitrevisions[7] pour plus de dĂ©tails. Les rĂ©fĂ©rences sont stockĂ©es dans le dĂ©pĂŽt.
L’espace de rĂ©fĂ©rence est hiĂ©rarchique. Les noms rĂ©f doivent soit commencer par
refs/
ou ĂȘtre situĂ©s dans la racine de la hiĂ©rarchie. Pour ce dernier, leur nom doit suivre ces rĂšglesâŻ:-
Le nom se compose uniquement de caractĂšres majuscules ou de soulignements.
-
Le nom se termine par "
_HEAD
" ou est Ă©gal Ă "HEAD
".Il y a quelques rĂ©fs irrĂ©guliĂšres dans la racine de la hiĂ©rarchie qui ne correspondent pas Ă ces rĂšgles. La liste suivante est exhaustive et ne peut ĂȘtre Ă©tendue Ă l’avenirâŻ:
-
AUTO_MERGE
-
BISECT_EXPECTED_REV
-
NOTES_MERGE_PARTIAL
-
NOTES_MERGE_REF
-
MERGE_AUTOSTASH
Différentes sous-hiérarchies sont utilisées à des fins différentes. par exemple, la hiérarchie
refs/heads/
est utilisée pour représenter les branches locales) alors que la hiérarchierefs/tags
est utilisée pour représenter les balises locales.
-
- reflog
-
Un reflog montre l'« historique » local d’une rĂ©fĂ©rence. En d’autres termes, il peut vous dire quelle Ă©tait la 3Ăšme derniĂšre rĂ©vision dans ce dĂ©pĂŽt, et quel Ă©tait l’Ă©tat actuel dans ce dĂ©pĂŽt, hier Ă 21h14. Voir git-reflog[1] pour plus de dĂ©tails.
- refspec
-
Un "refspec" est utilisé par fetch et push pour décrire la correspondance entre le réf distant et le réf local. Voir git-fetch[1] ou git-push[1] pour les détails.
- dépÎt distant
-
Un dĂ©pĂŽt qui est utilisĂ© pour suivre le mĂȘme projet mais qui rĂ©side ailleurs. Pour communiquer avec les distants, voir recupĂ©rer ou poussĂ©e.
- branche de suivi Ă distance
-
Une rĂ©f qui est utilisĂ©e pour suivre les changements d’un autre dĂ©pĂŽt. Elle ressemble typiquement Ă refs/remotes/foo/bar (indiquant qu’elle suit une branche nommĂ©e bar dans un dĂ©pĂŽt distant nommĂ© foo), et correspond au cĂŽtĂ© droit d’un refspec configurĂ©. Une branche de suivi Ă distance ne doit pas contenir de modifications directes ou avoir des commits locaux effectuĂ©s sur elle.
- dépÎt
-
Une collection de refs accompagnĂ©e d’une base de donnĂ©es d’objets contenant tous les objets qui sont joignables Ă partir des refs, Ă©ventuellement accompagnĂ©s de mĂ©tadonnĂ©es provenant d’une ou plusieurs porcelaines. Un dĂ©pĂŽt peut partager une base de donnĂ©es d’objets avec d’autres dĂ©pĂŽts via des mĂ©canismes alternatifs.
- résoudre
-
L’action de rĂ©parer manuellement ce que l’Ă©chec d’une fusion automatique a laissĂ© derriĂšre lui.
- révision
-
Synonyme de commit (le nom).
- rembobiner
-
Jeter une partie du dĂ©veloppement, c’est-Ă -dire affecter la tĂȘte Ă une rĂ©vision antĂ©rieure.
- SCM
-
Gestion du code source (Source Code Management en anglais).
- SHA-1
-
"Secure Hash Algorithm 1" une fonction de hachage cryptographique. Dans le contexte de Git, utilisĂ© comme synonyme de nom d’objet.
- clone superficiel
-
Principalement un synonyme de dĂ©pĂŽt superficiel mais la phrase rend plus explicite qu’il a Ă©tĂ© crĂ©Ă© en exĂ©cutant la commande
git clone --depth=...
. - dépÎt superficiel
-
Un dĂ©pĂŽt superficiel a un historique incomplet dont certains commits ont des parents « cautĂ©risĂ©s » (en d’autres termes, on dit Ă Git de prĂ©tendre que ces commits n’ont pas de parents, mĂȘme s’ils sont enregistrĂ©s dans le l’objet commit). Ceci est parfois utile lorsque vous n’ĂȘtes intĂ©ressĂ© que par l’historique rĂ©cent d’un projet mĂȘme si l’historique rĂ©el enregistrĂ© dans l’amont est beaucoup plus important. Un dĂ©pĂŽt superficiel est crĂ©Ă© en donnant l’option
--depth
Ă git-clone[1], et son historique peut ĂȘtre approfondi plus tard avec git-fetch[1]. - entrĂ©e de remisage
-
Un objet utilisĂ© pour stocker temporairement le contenu d’un rĂ©pertoire de travail sale et l’index pour une rĂ©utilisation future.
- sous-module
-
Un dĂ©pĂŽt qui contient l’historique d’un projet sĂ©parĂ© Ă l’intĂ©rieur d’un autre dĂ©pĂŽt (ce dernier est appelĂ© superprojet).
- superprojet
-
Un dĂ©pĂŽt qui fait rĂ©fĂ©rence aux dĂ©pĂŽts d’autres projets dans son arbre de travail comme sous-modules. Le superprojet connaĂźt les noms des objets commit des sous-modules contenus (mais n’en dĂ©tient pas de copie).
- symref ou référence symbolique
-
RĂ©fĂ©rence symboliqueâŻ: au lieu de contenir l’identifiant SHA-1 lui-mĂȘme, elle est au format ref:refs/quelque/chose et lorsqu’elle est rĂ©fĂ©rencĂ©e, elle dĂ©rĂ©fĂ©rence rĂ©cursivement vers cette rĂ©fĂ©rence. HEAD est un excellent exemple de symref. Les rĂ©fĂ©rences symboliques sont manipulĂ©es avec la commande git-symbolic-ref[1].
- Ă©tiquette
-
Une rĂ©f sous l’espace de noms
refs/tags/
qui pointe vers un objet d’un type arbitraire (typiquement, une Ă©tiquette pointe vers un objet tag ou un objet commit). Contrairement Ă une tĂȘte, une Ă©tiquette n’est pas mise Ă jour par la commandecommit
. Une Ă©tiquette Git n’a rien Ă voir avec un tag Lisp (qui serait appelĂ© un type d’objet dans le contexte de Git). Une Ă©tiquette est le plus souvent utilisĂ©e pour marquer un point particulier dans la chaĂźne d’ascendance de commits. - objet Ă©tiquette
-
Un objet contenant une réf pointant vers un autre objet, qui peut contenir un message tout comme un objet commit. Il peut également contenir une signature (PGP), auquel cas il est appelé un "objet étiquette signé".
- branche thématique
-
Une branche rĂ©guliĂšre de Git qui est utilisĂ©e par un dĂ©veloppeur pour identifier une ligne conceptuelle de dĂ©veloppement. Comme les branches sont trĂšs faciles et peu coĂ»teuses, il est souvent souhaitable d’avoir plusieurs petites branches qui contiennent chacune des concepts trĂšs bien dĂ©finis ou de petits changements incrĂ©mentiels mais liĂ©s.
- arbre
-
Soit un arbre de travail, soit un objet arbre avec les blob et objets arbre dĂ©pendants (c’est-Ă -dire une reprĂ©sentation stockĂ©e d’un arbre de travail).
- objet arbre
-
Un objet contenant une liste de noms et de modes de fichiers ainsi que des références aux objets blob et/ou arbres associés. Un arbre est équivalent à un répertoire.
- arbre-esque (aussi arbresque)
-
Un objet arbre ou un objet qui peut ĂȘtre dĂ©rĂ©fĂ©rencĂ© rĂ©cursivement vers un objet arbre. Le dĂ©rĂ©fĂ©rencement d’un objet commit donne l’objet arbre correspondant au rĂ©pertoire racine de la rĂ©vision. Les Ă©lĂ©ments suivants sont tous des arbres-esquesâŻ: un commit-esque, un objet arbre, un objet Ă©tiquette qui pointe vers un objet arbre, un objet Ă©tiquette qui pointe vers un objet Ă©tiquette qui pointe vers un objet arbre, etc.
- non né
-
L'HEAD peut pointer Ă une branche qui n’existe pas encore et qui n’a pas encore de commit sur elle, et une telle branche est appelĂ©e une branche non-nĂ©e. La façon la plus typique que les utilisateurs rencontrent une branche non-nĂ©e est de crĂ©er un dĂ©pĂŽt nouvellement crĂ©Ă© sans clonage depuis ailleurs. La HEAD pointerait sur la branche main (ou master, selon votre configuration) qui n’est pas encore nĂ©e. En outre, certaines opĂ©rations peuvent vous obtenir sur une branche non-nĂ©e avec leur option orpheline.
- index non fusionné
-
Un index qui contient des entrĂ©es d’index non fusionnĂ©es.
- objet inaccessible
-
Un objet qui n’est pas joignable Ă partir d’une branche, d’une Ă©tiquette, ou de toute autre rĂ©fĂ©rence.
- branche amont
-
La branche par défaut qui est fusionnée dans la branche en question (ou sur laquelle la branche en question est rebasée). Elle est configurée via branch.<nom>.remote et branch.<nom>.merge. Si la branche amont de A est origin/B on dit parfois "A suit origin/B".
- arbre de travail
-
L’arbre des fichiers effectivement extraits. L’arbre de travail contient normalement le contenu de l’arbre du commit HEAD, plus toutes les modifications locales que vous avez faites mais pas encore validĂ©es.
- arbre-de-travail
-
Un dĂ©pĂŽt peut avoir zĂ©ro (c’est-Ă -dire un dĂ©pĂŽt nu) ou un ou plusieurs arbres de travail attachĂ©s Ă lui. Un "arbre-de-travail" consiste en un "arbre de travail" et des mĂ©tadonnĂ©es de dĂ©pĂŽt, dont la plupart sont partagĂ©es entre les autres arbres-de-travail d’un mĂȘme dĂ©pĂŽt, et dont certaines sont maintenues sĂ©parĂ©ment par arbre-de-travail (par exemple l’index, HEAD et les pseudorĂ©fs comme MERGE_HEAD, les rĂ©fs par arbre-de-travail et le fichier de configuration par arbre-de-travail).
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 .