Français ▾ Topics ▾ Latest version ▾ git-symbolic-ref last updated in 2.48.0

NOM

git-symbolic-ref - Lire, modifier et supprimer les références symboliques

SYNOPSIS

git symbolic-ref [-m <raison>] <nom> <réf>
git symbolic-ref [-q] [--short] [--no-recurse] <nom>
git symbolic-ref --delete [-q] <nom>

DESCRIPTION

Avec un argument, lit vers quelle tête de branche la référence symbolique donnée fait référence et affiche son chemin, relatif au répertoire .git/. Typiquement, vous donneriez HEAD comme argument <nom> pour voir sur quelle branche se trouve votre arbre de travail.

Avec deux arguments, crée ou met à jour une référence symbolique <nom> pour qu’elle pointe vers la branche <réf> donnée.

Avec --delete et un argument supplémentaire, supprime la référence symbolique donnée.

Une référence symbolique est un fichier régulier qui stocke une chaîne commençant par ref: refs/. Par exemple, votre .git/HEAD est un fichier régulier dont le contenu est ref:refs/heads/master.

OPTIONS

-d
--delete

Supprime la référence symbolique <nom>.

-q
--quiet

N’émet pas de message d’erreur si <nom> n’est pas une référence symbolique mais une HEAD détachée ; à la place, se termine silencieusement avec un statut non nul.

--short

Lors de l’affichage de la valeur de <nom> comme référence symbolique, essayer de raccourcir la valeur, par ex. de refs/heads/master à master.

--recurse
--no-recurse

Lors de l’affichage de la valeur de <nom> comme référence symbolique, si <nom> fait référence à une autre référence symbolique, suivre cette chaîne de références symboliques jusqu’à ce que le résultat ne pointe plus vers une référence symbolique (--recurse, qui est le comportement par défaut). --no-recurse s’arrête après avoir déréférencé un seul niveau de référence symbolique.

-m

Met à jour le reflog pour <nom> avec <raison>. Ceci n’est valide que lors de la création ou de la mise à jour d’une référence symbolique.

NOTES

Dans le passé, .git/HEAD était un lien symbolique pointant vers refs/heads/master. Lorsque nous voulions basculer vers une autre branche, nous faisions ln -sf refs/heads/newbranch .git/HEAD, et lorsque nous voulions découvrir sur quelle branche nous étions, nous faisions readlink .git/HEAD. Mais les liens symboliques ne sont pas entièrement portables, ils sont donc désormais dépréciés et les références symboliques (comme décrit ci-dessus) sont utilisées par défaut.

git symbolic-ref se terminera avec le statut 0 si le contenu de la référence symbolique a été affiché correctement, avec le statut 1 si le nom demandé n’est pas une référence symbolique, ou 128 si une autre erreur se produit.

VOIR AUSSI

git-update-ref[1]

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 .