A documentação dos git-commit-treeestados diz o seguinte:
A commit encapsulates:
all parent object ids
author name, email and date
committer name and email and the commit time.
Entretanto, a presença do -Ssinalizador e os commits observados na natureza incluem um gpgsigcabeçalho, que não é mencionado na lista acima.
Além disso, a documentação indica que os commits também podem incluir um encodingcabeçalho, embora eu ainda não tenha visto nenhum por aí.
Objetos de commit criados com a configuração acima registram o valor de i18n.commitEncoding em seu cabeçalho de codificação. Isso é para ajudar outras pessoas que os vejam mais tarde. A falta desse cabeçalho implica que a mensagem de log de commit é codificada em UTF-8.
A documentação do Pretty Formats lista informações que podem ser extraídas de um commit, mas não faz nenhuma afirmação sobre se essas informações são exaustivas.
A lista completa de cabeçalhos possíveis e valores válidos está documentada em algum lugar?
Ou não é seguro escrever código que faça suposições sobre o conjunto de cabeçalhos possíveis?
Essa será a fonte.
commit.cmostra que "gpgsig-sha256" e "mergetag" são possibilidades adicionais; vi mergetag em, acho que eram commits do Linux.É definitivamente muito inseguro escrever código que pensa que conhece todas as entradas de cabeçalho possíveis. Novas podem ser adicionadas conforme as necessidades surgirem, que obtiveram as três mencionadas acima, esqueci quando, mas não faz tanto tempo assim.
O formato do cabeçalho segue uma convenção consagrada: ele termina com um par de novas linhas; cada entrada começa com um caractere que não seja um espaço em branco, a primeira palavra é o nome da entrada, quaisquer linhas adicionais com espaços em branco iniciais são concatenadas como se tivessem sido quebradas (o que aconteceu) e o resultado é o valor da entrada.
Tudo que segue o par de nova linha é a mensagem em si. É seguro esperar que novas entradas de cabeçalho sigam essa convenção. Eu me sentiria confiante o suficiente para codificar uma expectativa desse formato e que as primeiras entradas sempre serão tree, any parents, author, committer, nessa ordem.