git ls-files
git
Uso
git ls-files [-o|-m|-i] [--exclude-standard]Lista caminhos do índice, não do disco, e é por isso a lista confiável para scripts; -i não funciona sozinho e exige -c ou -o mais --exclude-standard.
Opções comuns
| Opção | Significado |
|---|---|
| -c | files in the index; the default |
| -m | tracked files modified on disk |
| -d | tracked files that are missing |
| -o | files git does not track |
| -i | ignored files; must come with -o or -c and --exclude-standard |
| --exclude-standard | apply .gitignore and friends |
| -s | show mode and object id of each entry |
| -z | separate paths with NUL for xargs -0 |
Exemplos
git ls-filesevery tracked path, straight from the index
git ls-files -o --exclude-standarduntracked files only, respecting .gitignore
git ls-files -i -c --exclude-standardtracked files that .gitignore says should be ignored
O confuso é que desfazer tem várias formas: mover para onde um branch aponta não é o mesmo que criar um commit que reverte.
Como ler
- Os colchetes [ ] marcam uma parte que você pode omitir.
- As reticências … indicam que você pode listar vários.
- As opções diferenciam maiúsculas: em alguns comandos -r e -R fazem coisas diferentes.
Perguntas
Q. O que git ls-files faz?
Lista caminhos do índice, não do disco, e é por isso a lista confiável para scripts; -i não funciona sozinho e exige -c ou -o mais --exclude-standard.
Q. Como se digita?
git ls-files [-o|-m|-i] [--exclude-standard] — os colchetes marcam o que você pode omitir.
Q. Quantas opções vale a pena saber?
Aqui estão 8; a lista completa está em man git. Este comando fica em git.
Comandos relacionados
página man: man git-ls-files