git-pack-refs - Empaquette les têtes et les étiquettes pour un accès efficace au dépôt

Traditionnellement, des sommets de branches et les étiquettes (collectivement appelés réfs) sont stockés un fichier par réf dans un (sous-)répertoire sous le répertoire $GIT_DIR/refs. Bien que de nombreux sommets de branche ont tendance à être mis à jour souvent, la plupart des étiquettes et quelques sommets de branche ne sont jamais mis à jour. Lorsqu’un dépôt a des centaines ou des milliers d’étiquettes, ce format un fichier-par-réf gaspille l’espace de stockage et nuit aux performances.

Cette commande est utilisée pour résoudre le problème de stockage et de performance en stockant les réfs dans un seul fichier, $GIT_DIR/packed-refs. Lorsqu’une réf est absente de la hiérarchie traditionnelle du répertoire $GIT_DIR/refs, elle est recherchée dans ce fichier et utilisée si trouvée.

Les mises à jour ultérieures des branches créent toujours de nouveaux fichiers sous la hiérarchie des répertoires $GIT_DIR/refs.

Une pratique recommandée pour traiter un dépôt avec trop de réfs est d’empaqueter ses réfs avec --all une fois, et exécuter occasionnellement git pack-refs. Les étiquettes sont par définition fixes et ne sont pas censées changer. Les têtes de branche seront empaquetées avec le premier pack-refs --all, mais seules les têtes de branche actuellement actives seront dépaquetées, et les prochains pack-refs (sans -all) les laisseront dépaquetées.

Des documents plus anciens écrits avant l’introduction du mécanisme de références empaquetées peuvent encore dire des choses comme "le fichier .git/refs/heads/<branche> doit exister" alors que cela doit signifier "la branche <branche> existe".

Fait partie de la suite git[1]

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 .