Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
Guides
- gitattributes
- Command-line interface conventions
- Everyday Git
- Frequently Asked Questions (FAQ)
- Glossary
- Hooks
- gitignore
- gitmodules
- Revisions
- Submodules
- Tutorial
- Workflows
- All guides...
Administration
Plumbing Commands
- 2.43.1 → 2.47.0 no changes
-
2.43.0
11/20/23
- 2.36.1 → 2.42.3 no changes
-
2.36.0
04/18/22
- 2.25.3 → 2.35.8 no changes
-
2.25.2
03/17/20
- 2.25.1 no changes
-
2.25.0
01/13/20
- 2.18.1 → 2.24.4 no changes
-
2.18.0
06/21/18
- 2.9.5 → 2.17.6 no changes
-
2.8.6
07/30/17
- 2.7.6 no changes
-
2.6.7
05/05/17
- 2.5.6 no changes
-
2.4.12
05/05/17
-
2.3.10
09/28/15
- 2.1.4 → 2.2.3 no changes
-
2.0.5
12/17/14
DESCRIÇÃO
Para cada nome do caminho informado através da linha de comando ou de um arquivo via --stdin, verifique se o arquivo foi excluído por .gitignore (ou outros arquivos de entrada para o mecanismo de exclusão) e mostre o caminho se ele for excluído.
Por padrão, os arquivos rastreados não são exibidos, pois não estão sujeitos a regras de exclusão. mas veja --no-index.
OPÇÕES
- -q, --quieto
-
Não produz nada, apenas define o status de encerramento. Isso só é válido com um único nome de caminho.
- -v, --verbose
-
Em vez de imprimir os caminhos que foram excluídos, para cada caminho que corresponda a um padrão de exclusão, imprima o padrão de exclusão junto com o caminho. (Corresponder a um padrão de exclusão geralmente significa que o caminho está excluído, mas se o padrão começar com "
!", ele será um padrão negado e corresponder a ele significa que o caminho NÃO está excluído).Para as regras da precedência dentro e entre as fontes eliminadas, consulte gitignore[5].
- --stdin
-
Leia os nomes do caminho na entrada padrão, um por linha, em vez da linha de comando.
- -z
-
O formato de saída é modificado para ser analisável por máquina (veja abaixo). Se a opção
--stdintambém for usada, os caminhos da entrada serão separados por um caractere NUL em vez de um caractere de alimentação de linha. - -n, --non-matching
-
Mostra os caminhos fornecidos que não correspondem a nenhum padrão. Só faz sentido quando a opção
--verboseestiver ativa, caso contrário não seria possível distinguir entre os caminhos que correspondem a um padrão e os que não correspondem. - --no-index
-
Não procure no índice ao realizar as verificações. Pode ser utilizado para depurar o motivo de um caminho ter sido rastreado por ex.
git add .e não foi ignorado pelas regras conforme o esperado pelo usuário ou ao desenvolver padrões incluindo a negação da coincidência a um caminho adicionado anteriormente com o comandogit add -f.
SAÍDA
É predefinido que será gerado qualquer um dos nomes informados de caminho que corresponda a um padrão de ignorar, um por linha. Se nenhum padrão corresponder a um determinado caminho, nada será gerado para esse caminho; isso significa que esse caminho não será ignorado.
Caso a opção --verbose seja utilizada, a saída será uma série de linhas desta forma:
<fonte> <COLON> <linenum> <COLON> <padrão> <HT> <pathname>
<pathname> é o caminho de um arquivo que está sendo consultado, <padrão> é o padrão correspondente, <pattern> é o arquivo de origem do padrão e <linenum> é o número da linha do padrão dentro dessa origem. Se houver um prefixo "!" no padrão ou um sufixo "/", ele será preservado na saída. <origem> será um caminho absoluto quando se referir ao arquivo configurado por core.excludesFile, ou relativo à raiz do repositório quando se referir a .git/info/exclude ou a um arquivo de exclusão por diretório.
Caso -z seja utilizado, os nomes do caminho gerado são delimitados pelo caractere nulo; caso --verbose também seja utilizado, então os caracteres nulos também serão utilizados em vez das vírgulas e das guias rígidas:
<fonte> <NULL> <linenum> <NULL> <padrão> <NULL> <pathname> <NULL>
Se a opção -n ou --non-matching forem usados, os nomes de caminho não correspondentes também serão gerados, e nesse caso, todos os campos em cada registro de saída, exceto o <nome-do-caminho>, estarão vazios. Isso pode ser útil quando executado de forma não interativa, de modo que os arquivos possam ser transmitidos de maneira incremental para o STDIN de um processo de verificação de ignorar de longa duração, assim como, para cada um desses arquivos, o STDOUT indicará se o arquivo correspondeu a um padrão ou não. (Sem esta opção, seria impossível saber se a ausência da saída para um determinado arquivo significasse que ele não correspondia a nenhum padrão ou que a saída ainda não teria sido gerada).
O armazenamento em buffer ocorre conforme documentado na opção GIT_FLUSH do comando git[1]. Aquele que invoca é o responsável por evitar impasses causados pelo preenchimento excessivo de um buffer de entrada ou pela leitura de um buffer vazio na saída.
GIT
Parte do conjunto git[1]
