git-pack-refs - Embale os cabeçalhos e a tags do pacote para acesso eficiente ao repositório

Tradicionalmente, as dicas das ramificações e as etiquetas (conhecidas coletivamente como "refs") eram armazenadas num arquivo por ref num (sub)diretório do diretório $GIT_DIR/refs. Embora muitas dicas dos ramos tendam a ser atualizadas com frequência, a maioria das etiquetas e algumas dicas dos ramos nunca são atualizadas. Quando um repositório tem centenas ou milhares de etiquetas, este formato de um arquivo por referência desperdiça armazenamento e prejudica o desempenho.

Este comando é usado para resolver o problema de armazenamento e desempenho, armazenando as referências num único arquivo, $GIT_DIR/packed-refs. Quando uma referência está faltando na hierarquia tradicional do diretório $GIT_DIR/refs, ela é procurada nesse arquivo sendo utilizada caso seja encontrada.

Atualizações subsequentes nos ramos sempre criam novos arquivos na hierarquia de diretórios $GIT_DIR/refs.

Uma prática recomendada para lidar com um repositório com muitas referências é empacotar as suas referências com a opção --all uma vez e, ocasionalmente, executar o comando git pack-refs. É predefinido que as etiquetas sejam estacionárias e não se espera que elas sejam alteradas. Os cabeçalhos da ramificação serão empacotados com o pack-refs --all inicial, mas no momento, apenas os cabeçalhos ativos da ramificação serão desempacotados, e o próximo pack-refs (sem --all) os deixará desempacotados.

A documentação mais antiga escrita antes da introdução do mecanismo "packed-refs" ainda pode dizer coisas como "o arquivo .git/refs/heads/<ramo> existe" quando significa "o ramo <ramo> existe".

Parte do conjunto git[1]