Git 🌙
Français â–Ÿ Topics â–Ÿ Latest version â–Ÿ gitglossary last updated in 2.46.0

NOM

gitglossary - Un glossaire de Git

SYNOPSIS

*

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Ă©pertoire repository.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.

Comme verbe : le terme "valider" est utilisĂ© en français. L’action de stocker un nouvel instantanĂ© de l’Ă©tat du projet dans l’historique Git, en crĂ©ant un nouveau commit reprĂ©sentant l’Ă©tat actuel de l'index et en avançant la HEAD pour pointer vers le nouveau 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 exemple git 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

Pour fusionner plus de deux branches.

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’attribut ATTR soit dĂ©fini.

  • "-ATTR" exige que l’attribut ATTR soit dĂ©sactivĂ©.

  • "ATTR=VALEUR" exige que l’attribut ATTR soit dĂ©fini comme la chaĂźne de caractĂšres VALEUR.

  • "!ATTR" exige que l’attribut ATTR 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érarchie refs/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 commande commit. 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 .

scroll-to-top