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.

É predefinido que o comando exiba todos as referências que coincidam com <padrão>. Esta opção define um limite de quantidade para parar após a exibição de <count> referências.

A field name to sort on. O prefixo - é utilizado para classificar em ordem decrescente. When unspecified, refname is used. Você pode utilizar a opção --sort=<chave> mais de uma vez; nesse caso, a última chave se torna a chave primária.

Uma cadeia de caracteres que interpola %(fieldname) vindo de uma referência sendo exibida e o objeto para o qual aponta. Caso fieldname seja prefixada com um asterisco (*) e a referência aponte para um objeto tag, utilize o valor do campo no objeto ao qual o objeto tag se refere (em vez do campo no objeto tag). Quando não especificado, o <formato> retorna para a predefinição %(objectname) SPC %(objecttype) TAB %(refname). Também interpola %% para % e % xx onde xx são dígitos hexadecimais interpolados com caracteres que tenha um código hexadecimal xx; % 00 interpola para \0 (NUL) por exemplo, %09 para \t (TAB) e %0a para \n (LF).

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

Se informado, as strings que substituem os espaços reservados % (fieldname) são citadas como literais de strings adequadas para o idioma do host especificado. Isso tem a intenção de 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). A opção é incompatível com --no-merged.

Liste apenas as referências cujas dicas não podem ser acessadas a partir do commit especificado (ou HEAD caso nenhum seja especificado). A opção é incompatível com --merged.

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.

O nome da referência "ref" (a parte após $GIT_DIR/). Para um nome abreviado não ambíguo do ref, acrescente : short. A opção core.warnAmbiguousRefs é utilizada para selecionar o modo estrito de abreviação. Caso lstrip=<N> (rstrip=<N>) for anexado, retira <N> dos componentes de caminho separados por barra da frente (traseira) do refname (%(refname:lstrip=2) por exemplo, transforma refs/tags/foo em foo e`%(refname:rstrip=2)` transforma refs/tags/foo em refs). Caso <N> seja um número negativo, retire quantos componentes do caminho forem necessários do final especificado, deixando os componentes do caminho -<N>, por exemplo (%(refname:lstrip=-2) transforma refs/tags/foo em tags/foo e %(refname:rstrip=-1) transforma refs/tags/foo em refs). Quando uma ref não possui componentes suficientes, o resultado se torna uma cadeia de caracteres vazia caso seja removida com <N> positivo, ou se torna o refname completo caso seja removida com um <N> negativo. Nenhum dos dois é um erro.

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

É o tamanho do objeto (o mesmo que relatórios git cat-file -s) Acrescente : disk para saber o quanto o objeto ocupa no disco, em bytes. Consulte a nota sobre os tamanhos do disco na seção RESSALVAS abaixo.

O nome do objeto (também informado como SHA-1) Para uma abreviação não ambígua do nome do objeto, adicione : short. Para uma abreviação do nome do objeto com o comprimento desejado, inclua :short=<comprimento>, onde o comprimento mínimo é MINIMUM_ABBREV. O comprimento pode ser excedido para garantir que os nomes dos objetos sejam únicos.

Isso se expande para o nome do objeto da base delta para o objeto especificado, caso ele esteja armazenado como um delta. Caso contrário, o objeto se expandirá para um nome nulo (todo zerado).

É o nome de uma "ref" local que pode ser considerada “upstream” da "ref" que está sendo exibida. Respeita :short, :lstrip e :rstrip da mesma maneira que o refname acima. Além disso, respeita também :track para exibir "[à frente N, atrás M]"e :trackshort para exibir a versão concisa: ">" (à frente), "<" (atrás), "<>" (à frente e atrás) ou "=" (em sincronia). :track também imprime "[gone]" sempre que uma "ref" "upstream" desconhecida seja encontrada. Acrescente :track,nobracket para exibir as informações de rastreamento sem colchetes (ou seja, "à frente de N, atrás de 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 ' '.

Muda a cor de 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 o conteúdo à esquerda (Left-), ao meio (Middle-) ou à direita entre %(align:…​) e %(end). O "align:" é seguido por width=<largura> e position=<posição> em qualquer ordem separado por vírgula, onde a <posição> é esquerda, direita ou meio, a predefinição retorna para esquerda e <largura> é o comprimento total do conteúdo com alinhamento. Por questões de brevidade, os prefixos "width=" ou "position=" podem ser omitidos, podendo ser utilizados <largura> e <posição> apenas. Por exemplo, %(align:<largura>,<posição>). Caso o comprimento do conteúdo seja maior que a largura, nenhum alinhamento será realizado. Se utilizado com --quote, tudo entre %(align:…​) e %(end) será citado, porém se aninhado, a citação ocorrerá apenas no nível mais alto.

Utilizado como %(if)…​%(then)…​%(end) ou %(if)…​%(then)…​%(else)…​%(end). Caso haja um átomo com um valor ou uma cadeia de caracteres literal após o %(if), tudo após o %(then) será impresso; caso contrário, caso o átomo em %(else) seja utilizado, tudo será impresso após o %(else). Ignoramos o espaço ao avaliar uma cadeia de caracteres antes de %(then), isso é útil quando usamos o átomo %(HEAD) que imprime "*" ou " " e queremos aplicar a condição if apenas no ref HEAD. Anexar ":equals=<texto>" ou ":notequals=<texto>" para comparar o valor entre os átomos de %(if:…​) e %(then) com a sequência especificada.

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.

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.