Caso uma ou mais padrões sejam utilizados, serão exibidos apenas as referências que coincidam com um dos padrões apresentados utilizando fnmatch(3) ou literal, neste último caso, apenas caso coincida completamente seja desde o início ou até uma barra.

Caso a opção --stdin seja usada, então a lista de padrões é lida a partir de entrada predefinida em vez da lista de argumentos.

É predefinido que o comando mostre todas as referências que correspondem ao <padrão>. Esta opção faz com que ele pare após mostrar esta quantidade de árbitros.

Um nome de campo para classificação. Prefixo - para classificar em ordem decrescente do valor. Quando não especificado, o refname é usado. É possível usar a opção --sort=<chave> diversas vezes e, neste caso, a última chave se torna a chave primária.

Uma string que interpola %(fieldname) de uma referência que está sendo mostrada e o objeto para o qual ela aponta. Além disso, o literal de cadeia %% é renderizado como % e %xx - onde xx são dígitos hexadecimais - é renderizado como o caractere com código hexadecimal xx. Por exemplo, %00 interpola para \0 (NUL), %09 para \t (TAB) e %0a para \n (LF).

Respeite todas as cores usadas com a opção --format. O campo <quando> deve ser always, never ou auto (comporte-se como always caso <quando> esteja ausente).

Quando usadas, as strings que substituem os espaços reservados %(fieldname) são citadas como literais da string adequados para o idioma específico do host. O objetivo é produzir um scriptlet que possa ser diretamente avaliado.

Listar apenas as referências que apontem para o objeto especificado.

Liste apenas as referências cujas dicas são acessíveis a partir do commit especificado (ou HEAD caso nenhum seja especificado).

Liste apenas as referências cujas dicas não podem ser acessadas a partir do commit especificado (ou HEAD caso nenhum seja especificado).

Liste apenas as referências que contenham os commits especificados (ou HEAD caso nenhum seja especificado).

Listar apenas as referências que não contenham os commits especificados (ou HEAD caso nenhum seja especificado).

As referências de classificação e filtragem não diferenciam as maiúsculas de minúsculas.

Não imprima uma nova linha após a formatação das referências onde o formato se expande para a string vazia.

Caso um ou mais padrões sejam fornecidos, somente as referências que não corresponderem a nenhum padrão que tenha sido excluído serão mostradas. A correspondência é feita usando as mesmas regras do <padrão> acima.

List root refs (HEAD and pseudorefs) apart from regular refs.

O nome da referência (a parte após $GIT_DIR/). Para um nome curto não ambíguo da referência, acrescente :short. A opção core.warnAmbiguousRefs é usada para selecionar o modo de abreviação estrita. Se lstrip=<N> (rstrip=<N>) for anexado, remove <N> componentes do caminho separados por barra da frente (atrás) do refname (por exemplo, %(refname:lstrip=2) transforma refs/tags/foo em foo e %(refname:rstrip=2) transforma refs/tags/foo em refs). Se <N> for um número negativo, remova quantos componentes do caminho forem necessários da extremidade especificada para deixar -<N> componentes do caminho (por exemplo, %(refname:lstrip=-2) transforma refs/tags/foo em tags/foo e %(refname:rstrip=-1) transforma refs/tags/foo em refs). Quando a referência de nome não possuir componentes suficientes, o resultado se torna uma cadeia de caracteres vazia se a remoção for feita com <N> positivo, ou se torna o nome completo da referência se a remoção for feita com <N> negativo. Nenhum deles é um erro.

O tipo do objeto (blob, tree, commit, tag).

O tamanho do objeto (o mesmo que o relatório git cat-file -s). Acrescente :disk para obter o tamanho, em bytes, que o objeto ocupa no disco. Consulte a observação sobre tamanhos no disco na seção RESSALVAS abaixo.

O nome do objeto (também conhecido como SHA-1). Para uma abreviação não ambígua do nome do objeto, acrescente :short. Para obter uma abreviação do nome do objeto com o comprimento desejado, acrescente :short=<comprimento>, onde o comprimento mínimo é MINIMUM_ABBREV. O comprimento pode ser excedido para garantir nomes de objetos exclusivos.

Isso se expande para o nome do objeto da base delta do objeto fornecido, se ele estiver armazenado como um delta. Caso contrário, ele se expande para o nome do objeto nulo (todos os zeros).

O nome de uma referência local que pode ser considerada "upstream" da referência exibida. Respeita :short, :lstrip e :rstrip da mesma maneira que o refname acima. Além disso, respeite :track para mostrar "[ahead N, behind M]" e :trackshort para mostrar a versão resumida: ">" (à frente), "<" (atrás), "<>" (à frente e atrás) ou "=" (em sincronia). O :track também imprime "[gone]" sempre que uma referência desconhecida do upstream é encontrada. Acrescente :track,nobracket para mostrar informações de rastreamento sem colchetes (ou seja, "ahead N, behind M").

O nome de uma "ref" local que representa a localização @{push} para uma ref que está sendo exibido. Respeita as opções :short, :lstrip, :rstrip, :track, :trackshort, :remotename, e :remoteref; assim como a opção upstream. Produz uma cadeia de caracteres vazia caso nenhum @{push} "ref" esteja configurada.

* caso HEAD corresponda à ref atual (a ramificação que foi verificada), caso contrário ' '.

Altera a cor da saída. Seguido por :<colorname>, onde os nomes das cores são descritos em valores na seção "ARQUIVO DE CONFIGURAÇÃO" do git-config[1]. Por exemplo, %(color:bold red).

Alinhe à esquerda, ao meio ou à direita o conteúdo entre %(align:...) e %(end). O "align:" é seguido por width=<largura> e position=<posição> em qualquer ordem, separados por vírgula, onde <posição> é esquerda, direita ou centro, sendo o padrão a esquerda, e <largura> é o comprimento total do conteúdo com alinhamento. Para fins de brevidade, os prefixos "width=" e/ou "position=" podem ser omitidos e, em seu lugar, podem ser usados os prefixos <largura> e <posição>. Por exemplo, %(align:<largura>,<posição>). Se o comprimento do conteúdo for maior que a largura, nenhum alinhamento será realizado. Se usado com --quote, tudo o que estiver entre %(align:...) e %(end) será citado, mas, se estiver aninhado, somente o nível mais alto executará a citação.

Usado como %(if)…​%(then)…​%(end) ou %(if)…​%(then)…​%(else)…​%(end). Se houver um átomo com valor ou uma string literal após o %(if), tudo o que estiver após o %(then) será impresso; caso contrário, se o elemento %(else) for usado, tudo o que estiver após o %(else) será impresso. Ignoramos o espaço ao avaliar a cadeia de caracteres antes de %(then), o que é útil quando usamos o elemento %(HEAD) que imprime "*" ou " " e queremos aplicar a condição if somente na referência HEAD. Acrescente ":equals=<string>" ou ":notequals=<string>" para comparar o valor entre os elementos %(if:…​) e %(then) com a string fornecida.

O ref ao qual determinado ref simbólico se refere. Caso não seja um ref simbólico, nada será impresso. Respeita as opções :short, :lstrip e :rstrip da mesma maneira que o refname acima.

A assinatura GPG de um commit.

Mostra "G" para uma assinatura boa (válida), "B" para uma assinatura ruim, "U" para uma assinatura boa com validade desconhecida, "X" para uma assinatura boa que expirou, "Y" para uma assinatura boa feita por uma chave expirada, "R" para uma assinatura boa feita por uma chave revogada, "E" caso a assinatura não possa ser verificada (por exemplo, pela falta da chave) e "N" para nenhuma assinatura.

O signatário de uma assinatura GPG de um commit.

A chave de uma assinatura GPG de um commit.

A impressão digital de uma assinatura GPG de um commit.

A impressão digital da chave primária da assinatura GPG de um commit.

O nível de confiança de uma assinatura GPG de um commit. Os possíveis resultados são ultimate, fully, marginal, never e undefined.

O caminho absoluto para a árvore de trabalho onde a "ref" foi averiguada, caso estiveja em qualquer árvore de trabalho vinculada. Caso contrário, uma sequência vazia.

Dois números inteiros, separados por um espaço, demonstrando a quantidade de commits a frente e atrás, respectivamente, ao comparar a ref gerada com o <committish> no formato especificado.

In at most one row, (<committish>) will appear to indicate the ref that is most likely the ref used as a starting point for the branch that produced <committish>. This choice is made using a heuristic: choose the ref that minimizes the number of commits in the first-parent history of <committish> and not in the first-parent history of the ref.

*--*--*--*--*--* refs/heads/A
\
 \
  *--*--*--* refs/heads/B
   \     \
    \     \
     *     * refs/heads/C
      \
       \
	*--* refs/heads/D

refs/heads/A:
refs/heads/B:(D)
refs/heads/C:

Um nome legível para humanos, como git-describe[1]; uma string vazia para commits indescritíveis. A string describe pode ser seguida por dois-pontos e uma ou mais opções separadas por vírgulas.

O tamanho dos dados brutos do objeto.

O tamanho em bytes da mensagem do commit ou da tag.

O primeiro parágrafo da mensagem, que normalmente é uma única linha, é considerado o "assunto" do commit ou da etiqueta da mensagem. Em vez de contents:subject, o campo subject também pode ser usado para obter os mesmos resultados. O :sanitize pode ser anexado a subject para obter uma linha de assunto adequada ao nome do arquivo.

O restante do commit ou a etiqueta da mensagem que segue o "assunto".

A assinatura GPG opcional da tag.

As primeiras N linhas da mensagem.