|
| 1 | +git-annotate(1) |
| 2 | +=============== |
| 3 | + |
| 4 | +НАЗВА |
| 5 | +----- |
| 6 | +git-annotate - Анотує рядки файлу інформацією про коміт |
| 7 | + |
| 8 | +СИНОПСИС |
| 9 | +-------- |
| 10 | +[verse] |
| 11 | +'git annotate' [<опції>] [<опції-ревізії>] [<ревізія>] [--] <файл> |
| 12 | + |
| 13 | +ОПИС |
| 14 | +---- |
| 15 | +Анотує кожен рядок у вказаному файлі інформацією про коміт, у якому рядок було додано. За бажанням, анотує з вказаної ревізії. |
| 16 | + |
| 17 | +Єдина різниця між цією командою та linkgit:git-blame[1] у використанні дещо різних форматів виводу і ця команда існує лише задля підтримки зворотньої сумісності зі скриптами, що вже існують, та надання звичнішої назви команди для людей, що приходять з інших систем управління вихідним кодом. |
| 18 | + |
| 19 | +ОПЦІЇ |
| 20 | +----- |
| 21 | +-b:: |
| 22 | + Показує порожній SHA-1 для граничних комітів. Поведінка також може бути задана за допомогою параметра конфігурації `blame.blankBoundary`. |
| 23 | + |
| 24 | +--root:: |
| 25 | + Не розглядає кореневі коміти як межі. Поведінка також може бути задана за допомогою параметра конфігурації `blame.showRoot`. |
| 26 | + |
| 27 | +--show-stats:: |
| 28 | + Подає додаткову статистику наприкінці інформації про авторство. |
| 29 | + |
| 30 | +-L <початок>,<кінець>:: |
| 31 | +-L :<ім'я_функції>:: |
| 32 | + Анотує лише проміжок рядків, заданий за допомогою '<початку>,<кінця>' або за регулярним виразом '<ім'я_функції>' назви функції. Може бути задано декілька разів. Допускається накладання проміжків. |
| 33 | ++ |
| 34 | +'<початок>' та '<кінець>' необов'язкові. `-L <початок>` або `-L <початок>,` охоплює рядки від '<початку>' до кінця файлу. `-L ,<кінець>` - від початку файлу до '<кінця>'. |
| 35 | ++ |
| 36 | +_<start>_ і _<end>_ може мати одну з цих форм: |
| 37 | + |
| 38 | +- _<number>_ |
| 39 | ++ |
| 40 | +Якщо _<start>_ або _<end>_ є числом, воно визначає абсолютний номер рядка (рядки рахуються від 1). |
| 41 | ++ |
| 42 | + |
| 43 | +- `/<regex>/` |
| 44 | ++ |
| 45 | +Ця форма використовуватиме перший рядок, що відповідає заданому POSIX _<regex>_. Якщо _<start>_ є регулярним виразом, пошук буде розпочато з кінця попереднього діапазону `-L`, якщо такий є, інакше з початку файлу. Якщо _<start>_ є `^/<regex>/`, пошук буде розпочато з початку файлу. Якщо _<end>_ є регулярним виразом, пошук буде розпочато з рядка, заданого _<start>_. |
| 46 | ++ |
| 47 | + |
| 48 | +- `+<offset>` або `-<offset>` |
| 49 | ++ |
| 50 | +Це дійсне лише для _<end>_ та визначатиме кількість рядків до або після рядка, заданого _<start>_. |
| 51 | + |
| 52 | ++ |
| 53 | +Якщо `:<funcname>` вказано замість _<start>_ та _<end>_, це регулярний вираз, який позначає діапазон від першого рядка funcname, що відповідає _<funcname>_, до наступного рядка funcname. `:<funcname>` шукає з кінця попереднього діапазону `-L`, якщо такий є, інакше з початку файлу. `^:<funcname>` шукає з початку файлу. Назви функцій визначаються так само, як `git diff` обчислює заголовки патчів (див. «Визначення власного заголовка hunk» у linkgit:gitattributes[5]). |
| 54 | +[] |
| 55 | + |
| 56 | +-l:: |
| 57 | + Показує повне значення ревізії (Типово: вимкнено). |
| 58 | + |
| 59 | +-t:: |
| 60 | + Показує необроблену мітку часу (Типово: вимкнено). |
| 61 | + |
| 62 | +-S <файл_ревізій>:: |
| 63 | + Використовує ревізії із вказаного файлу ревізій замість виклику linkgit:git-rev-list[1]. |
| 64 | + |
| 65 | +--reverse <ревізія>..<ревізія>:: |
| 66 | + Рухає історію вперед, а не назад. Замість відображення ревізії, у якій рядок з'явився, відображає останню ревізію у якій він існував. Для цього потрібно вказати проміжок ревізій, наприклад, ПОЧАТОК..КІНЕЦЬ, де рядок, який ви шукаєте, повинен існувати у ПОЧАТКУ. `git blame --reverse ПОЧАТОК` є скороченням для `git blame --reverse ПОЧАТОК..HEAD`. |
| 67 | + |
| 68 | +--first-parent:: |
| 69 | + Слідує лише за першим батьківським комітом після того, як побачить коміт злиття. Ця опція може бути використана для визначення, коли рядок з'явився саме у певній гілці, а не коли його в цілому було додано. |
| 70 | + |
| 71 | +-p:: |
| 72 | +--porcelain:: |
| 73 | + Показує у форматі, призначеному для машинного використання. |
| 74 | + |
| 75 | +--line-porcelain:: |
| 76 | + Показує у "порцеляновому" форматі (як за використання `--porcelain`), але виводить інформацію про коміт для кожного рядка, а не лише за першої згадки про коміт. |
| 77 | + |
| 78 | +--incremental:: |
| 79 | + Показує результати покроково у форматі, призначеному для машинного використання. |
| 80 | + |
| 81 | +--encoding=<кодування>:: |
| 82 | + Визначає кодування для виводу імені автора та заголовку коміту. Встановлення значення `none` призводить до виводу неконвертованих даних. Детальніше дивіться обговорення кодування на сторінці посібника linkgit:git-log[1]. |
| 83 | + |
| 84 | +--contents <файл>:: |
| 85 | + Анотує використовуючи вміст вказаного файлу, починаючи з '<ревізії>', якщо її визначено, або ж з HEAD. Ви можете вказати `-` аби команда зчитувала контент файлу зі стандартного вводу. |
| 86 | + |
| 87 | +--date <формат>:: |
| 88 | + Визначає формат виводу дати. Якщо цей параметр відсутній, буде використано значення параметру конфігурації `blame.date`. Якщо ж і його немає, то буде використано формат ISO. Задля ознайомлення із підтримуваними значенням дивіться обговорення параметру `--date` у linkgit:git-log[1]. |
| 89 | + |
| 90 | +--progress:: |
| 91 | +--no-progress:: |
| 92 | + Типово, статус виконання виводиться у стандартному потоці помилок, коли він підключений до терміналу. Цей прапорець дозволяє виводити прогрес навіть коли такий потік не підключено. `--progress` не може використовуватися разом з `--porcelain` чи `--incremental`. |
| 93 | + |
| 94 | +-M[<число>]:: |
| 95 | + Виявляє переміщені чи скопійовані рядки всередині файлу. Коли коміт переміщує чи копіює сукупність рядків (наприклад, коли вихідний файл містить рядок А і потім Б, а коміт переставляє спочатку Б, а тоді А), традиційний алгоритм розпізнає лише половину руху і, зазвичай, приписує рядки, що були переміщені вгору (тобто Б), батьківському коміту, а рядки, що були переміщені вниз (тобто А), - дочірньому. Із цим параметром, обидві групи рядків приписуються батьківському шляхом виконання додаткових перевірок. |
| 96 | ++ |
| 97 | +'<число>' необов'язкове. Це нижня межа кількості буквено-цифрових символів, які Git має визначити як переміщені/скопійовані всередині файлу, щоб пов'язати ці рядки із батьківським комітом. Типово дорівнює 20. |
| 98 | + |
| 99 | +-C[<число>]:: |
| 100 | + На додачу до `-M` визначає переміщені або скопійовані рядки з інших файлів, що були змінені у тому самому коміті. Це корисно коли ви реорганізовуєте вашу програму та переміщуєте код між файлами. Коли цей параметр вказано двічі, команда додатково шукає копії з інших файлів у коміті, в якому файл було створено. Якщо ж його вказано тричі, то команда додатково шукає копії з інших файлів у будь-якому коміті. |
| 101 | ++ |
| 102 | +'<число>' необов'язкове. Це нижня межа кількості буквено-цифрових символів, які Git має визначити як переміщені/скопійовані між файлами, аби пов'язати ці рядки із батьківським комітом. Типово дорівнює 40. Якщо вказано більше одного параметру `-C`, то буде використано '<число>' останнього з них. |
| 103 | + |
| 104 | +--ignore-rev <ревізія>:: |
| 105 | + Ігнорувати зміни, внесені ревізією, під час призначення звинувачення, ніби змін ніколи не було. Рядки, які були змінені або додані ігнорованим комітом, будуть звинувачені в попередньому коміті, який змінив цей рядок або сусідні рядки. Цей параметр можна вказати кілька разів, щоб ігнорувати більше однієї ревізії. Якщо встановлено параметр конфігурації `blame.markIgnoredLines`, то рядки, які були змінені ігнорованим комітом і віднесені до іншого коміту, будуть позначені символом `?` у виводі звинувачення. Якщо встановлено параметр конфігурації `blame.markUnblamableLines`, то ті рядки, яких торкнувся ігнорований коміт, які ми не змогли віднести до іншої ревізії, позначені символом '*'. У режимах porcelain ми друкуємо 'ignored' та 'unblamable' на новому рядку відповідно. |
| 106 | + |
| 107 | +--ignore-revs-file <файл>:: |
| 108 | + Нехтує ревізіями, що перелічені у '<файлі>', який має бути в тому ж форматі що й `fsck.skipList`. Цей параметр може бути вказано декілька разів. Ці файли будуть опрацьовані після усіх файлів, що визначені параметром конфігурації `blame.ignoreRevsFile`. Порожнє ім'я файлу (`""`) очищає перелік ревізій з попередніх опрацьованих файлів. |
| 109 | + |
| 110 | +--color-lines:: |
| 111 | + Забарвлює анотації до рядків у типовому форматі в інший колір, якщо зміни походять від того самого коміту, що й попередній рядок. Це полегшує розрізнення блоків коду внесених різними комітами. Типовим кольором є ціановий, який може бути налаштований параметром конфігурації `color.blame.repeatedLines`. |
| 112 | + |
| 113 | +--color-by-age:: |
| 114 | + Забарвлює анотації до рядків у типовому форматі залежно від віку рядка. Параметр конфігурації `color.blame.highlightRecent` визначає який колір застосовувати для кожного вікового проміжку. |
| 115 | + |
| 116 | +-h:: |
| 117 | + Показує підказку. |
| 118 | +[] |
| 119 | + |
| 120 | +ДИВ. ТАКОЖ |
| 121 | +---------- |
| 122 | +linkgit:git-blame[1] |
| 123 | + |
| 124 | +GIT |
| 125 | +--- |
| 126 | +Частина набору linkgit:git[1] |
0 commit comments