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.51.0 no changes
-
2.43.0
2023-11-20
- 2.36.1 → 2.42.4 no changes
-
2.36.0
2022-04-18
- 2.25.3 → 2.35.8 no changes
-
2.25.2
2020-03-17
- 2.25.1 no changes
-
2.25.0
2020-01-13
- 2.18.1 → 2.24.4 no changes
-
2.18.0
2018-06-21
- 2.9.5 → 2.17.6 no changes
-
2.8.6
2017-07-30
- 2.7.6 no changes
-
2.6.7
2017-05-05
- 2.5.6 no changes
-
2.4.12
2017-05-05
-
2.3.10
2015-09-28
- 2.1.4 → 2.2.3 no changes
-
2.0.5
2014-12-17
ОПИС
Для кожного шляху, заданого через командний рядок або з файлу через --stdin
, перевірити, чи файл виключено .gitignore (або іншими вхідними файлами для механізму виключення), та вивести шлях, якщо він виключений.
За замовчуванням відстежувані файли взагалі не відображаються, оскільки вони не підпадають під правила виключення; але див. ‘--no-index’.
ОПЦІЇ
- -q, --quiet
-
Нічого не виводити, просто встановити статус виходу. Це дійсне лише з одним шляхом.
- -v, --verbose
-
Замість того, щоб виводити виключені шляхи, для кожного шляху, який відповідає шаблону виключення, виведіть шаблон виключення разом зі шляхом. (Збіг зі шаблоном виключення зазвичай означає, що шлях виключено, але якщо шаблон починається з "`!", то це заперечений шаблон, і збіг з ним означає, що шлях НЕ виключено.)
Щодо правил пріоритету всередині та між виключеними джерелами, див. gitignore[5].
- --stdin
-
Зчитувати імена шляхів зі стандартного вводу, по одному на рядок, замість того, щоб читати їх з командного рядка.
- -z
-
Формат виводу змінено для машинного аналізу (див. нижче). Якщо також задано
--stdin
, вхідні шляхи розділяються символом NUL замість символу переведення рядка. - -n, --non-matching
-
Показати задані шляхи, які не відповідають жодному шаблону. Це має сенс лише тоді, коли ввімкнено
--verbose
, інакше неможливо було б розрізнити шляхи, що відповідають шаблону, від тих, що ні. - --no-index
-
Не дивіться в індекс під час виконання перевірок. Це можна використовувати для налагодження, чому шлях став відстежуватися, наприклад, за допомогою
git
add
.
, і не був ігнорований правилами, як очікував користувач, або під час розробки шаблонів, що включають заперечення, для відповідності шляху, попередньо доданому за допомогоюgit
add
-f
.
ВИХІД
За замовчуванням буде виведено будь-який із заданих шляхів, що відповідає шаблону ігнорування, по одному на рядок. Якщо жоден шаблон не відповідає заданому шляху, для цього шляху нічого не буде виведено; це означає, що шлях не буде ігноровано.
Якщо вказано --verbose
, вивід буде послідовністю рядків такого вигляду:
<source> <COLON> <linenum> <COLON> <pattern> <HT> <pathname>
<pathname> – це шлях до файлу, до якого запитується запит, <pattern> – це відповідний шаблон, <source> – це вихідний файл шаблону, а <linenum> – це номер рядка шаблону в цьому джерелі. Якщо шаблон містив префікс "!
" або суфікс "/
", він буде збережений у виводі. <source> буде абсолютним шляхом при посиланні на файл, налаштований за допомогою core.excludesFile
, або відносним до кореневого каталогу репозиторію при посиланні на .git/info/exclude
або файл виключень для кожного каталогу.
Якщо вказано -z
, шляхи у виводі розділяються нульовим символом; якщо також вказано --verbose
, то замість двокрапок та жорсткої табуляції також використовуються нульові символи:
<source> <NULL> <linenum> <NULL> <pattern> <NULL> <pathname> <NULL>
Якщо вказано -n
або --non-matching
, також будуть виведені невідповідні шляхи, і в цьому випадку всі поля в кожному вихідному записі, крім <pathname>, будуть порожніми. Це може бути корисним під час неінтерактивного виконання, щоб файли можна було поступово передавати на STDIN тривалого процесу перевірки-ігнорування, і для кожного з цих файлів STDOUT вказуватиме, чи відповідає цей файл шаблону чи ні. (Без цієї опції було б неможливо визначити, чи означає відсутність виводу для даного файлу, що він не відповідає жодному шаблону, чи що вивід ще не був згенерований.)
Буферизація відбувається, як описано в опції GIT_FLUSH
у git[1]. Викликаюча сторона відповідає за уникнення блокувань, спричинених переповненням вхідного буфера або читанням з порожнього вихідного буфера.
GIT
Частина набору git[1]