Descrevendo os nomes dos objetos commit. Caso seja omitido, a predefinição retorna para que HEAD seja utilizado.

Descreve a condição da árvore de trabalho. Quando a árvore de trabalho corresponder a um HEAD, a saída é a mesma que git describe HEAD. Caso a árvore de trabalho tenha sido modificada localmente, um "-dirty" será anexado a ela. Caso um repositório tenha sido corrompido e o Git não puder determinar se há uma modificação local, o Git exibirá uma mensagem de erro, a menos que a opção --broken seja utilizada.

Em vez de usar apenas as tags anotadas, utilize qualquer "ref" encontrada no espaço de nomes refs/. Essa opção permite fazer com que coincida com qualquer ramificação conhecida, do ramo monitorado remotamente ou de uma tag leve (lightweight).

Em vez de usar apenas as anotações das tags, utilize qualquer tag que for encontrada no namespace refs/tags. Essa opção permite fazer a coincidência com uma tag "leve" (não anotada).

Em vez de encontrar a tag que anteceda um commit, localize a tag que vem após o commit e a contenha. Implica automaticamente no uso da opção --tags.

Em vez de usar os 7 dígitos hexadecimais predefinidos como o nome abreviado do objeto, utilize <n> dígitos ou quantos dígitos forem necessários para formar um nome do objeto que seja único. Um <n> que seja 0, suprime o formato longo exibindo apenas a tag mais próxima.

Em vez de considerar apenas as 10 tags mais recentes como candidatas para descrever o commit de entrada, considere até <n> candidatos. Aumentando <n> para acima de 10 haverá um consumo um pouco maior de tempo, no entanto, poderá produzir um resultado mais preciso. Um <n> que seja 0 fará com que apenas as coincidências exatas sejam exibidas.

Apenas os resultados exatos de saída (uma tag faz referência direta ao commit informado). Este é um sinônimo para --candidates=0.

Exibe de forma detalhada as informações sobre a estratégia de pesquisa que está sendo empregada para o erro predefinido. predefinida. O nome da tag ainda será impresso para a saída.

Sempre imprima o formato longo (a tag, o a quantidade de commits e o nome abreviado do commit), mesmo quando coincidir com uma tag. Isso é útil quando você deseja ver as partes do nome do objeto commit na saída "describe", mesmo quando a confirmação em questão seja uma versão marcada. Em vez de apenas emitir o nome da tag, ele descreverá um commit como v1.2-0-gdeadbee (0º commit desde a tag v1.2 que aponta para o objeto deadbee…​.).

Considere apenas as tags que coincidam ao padrão glob (7), excluindo o prefixo "refs/tags/". Se utilizado com --all, também considera as ramificações locais e as referências do monitoramento remoto que coincidam com o padrão, excluindo respectivamente o prefixo "refs/heads/" e "refs/remotes/"; as referências dos outros tipos nunca são consideradas. Caso seja utilizado várias vezes, uma lista de padrões será acumulada e as tags que coincidam com qualquer um dos padrões serão consideradas. Utilize --no-match para limpar e redefinir a lista dos padrões.

Não considere as tags que coincidam com padrão glob (7), excluindo o prefixo "refs/tags/". Se utilizado com --all, também não considera as ramificações locais e as referências do rastreamento remoto coincidentes ao padrão, excluindo respectivamente o prefixo "refs/heads/" e "refs/remotes/"; as referências de outros tipos nunca são consideradas. Caso seja utilizado várias vezes, uma lista de padrões será acumulada e as tags que coincidam a qualquer um dos padrões serão excluídas. Quando combinada com --match, uma tag será considerada quando coincidir a pelo menos um padrão --match e não corresponder a nenhum dos padrões --exclude. Utilize --no-exclude para limpar e redefinir a lista dos padrões.

Exiba o objeto commit abreviado exclusivamente como "fallback" (retirada).

Siga apenas o primeiro commit da origem ao ver um commit de mesclagem. Isso é útil quando você quer que as tags não coincidam nos ramos mesclados do histórico do commit de destino.