українська мова ▾ Topics ▾ Latest version ▾ git-annotate last updated in 2.53.0

НАЗВА

git-annotate — Додавання анотацій до рядків файлів з інформацією про коміти

СИНОПСИС

git annotate [<опції>] [<опції-ревізії>] [<ревізія>] [--] <файл>

ОПИС

Додає до кожного рядка у вказаному файлі анотацію з інформацією з коміту, в якому цей рядок було додано. За бажанням можна додавати анотації на основі вказаної ревізії.

Єдина різниця між цією командою та git-blame[1] у використанні дещо різних форматів виводу і ця команда існує лише задля підтримки зворотної сумісності зі скриптами, що вже існують, та надання звичнішої назви команди для людей, що приходять з інших систем управління вихідним кодом.

ОПЦІЇ

-b

Показувати порожній SHA-1 для комітів, що є граничними. Цю поведінку також можна налаштувати за допомогою параметра конфігурації blame.blankBoundary.

--root

Не слід розглядати кореневі коміти як межі. Цю поведінку також можна налаштувати за допомогою параметра конфігурації blame.showRoot.

--show-stats

Додати додаткові статистичні дані в кінці виводу команди blame.

-L <початок>,<кінець>
-L :<імʼя-функції>

Анотує лише проміжок рядків, заданий за допомогою <початку>,<кінця> або за регулярним виразом <імʼя-функції> назви функції. Може бути задано декілька разів. Допускається накладання проміжків.

<початок> та <кінець> необовʼязкові. -L <початок> або -L <початок>, охоплює рядки від <початку> до кінця файлу. -L ,<кінець> — від початку файлу до <кінця>.

<start> і <end> може мати одну з цих форм:

  • <number>

    Якщо <start> або <end> є числом, воно визначає абсолютний номер рядка (рядки рахуються від 1).

  • /<regex>/

    Ця форма використовуватиме перший рядок, що відповідає заданому POSIX-виразу <regex>. Якщо <start> є регулярним виразом, пошук розпочнеться з кінця попереднього діапазону -L, якщо такий є, інакше — з початку файлу. Якщо <start> є ^/<regex>/, пошук розпочнеться з початку файлу. Якщо <end> є регулярним виразом, пошук розпочнеться з рядка, вказаного в <start>.

  • +<offset> або -<offset>

    Є дійсним лише для <end> та визначатиме кількість рядків до або після рядка, заданого <start>.

Якщо :<funcname> вказано замість <start> та <end>, це регулярний вираз, який позначає діапазон від першого рядка funcname, що відповідає <funcname>, до наступного рядка funcname. :<funcname> шукає з кінця попереднього діапазону -L, якщо такий є, інакше з початку файлу. ^:<funcname> шукає з початку файлу. Назви функцій визначаються так само як git diff обчислює заголовки латок (див. «Визначення власного заголовка фрагмента» у gitattributes[5]).

-l

Показує повне значення ревізії (Типово: вимкнено).

-t

Показує необроблений відбиток часу (Типово: вимкнено).

-S <файл-ревізій>

Використовує ревізії із вказаного файлу ревізій замість виклику git-rev-list[1].

--reverse <ревізія>..<ревізія>

Рухає історію вперед, а не назад. Замість показу ревізії, у якій рядок зʼявився, показує останню ревізію у якій він існував. Для цього потрібно вказати проміжок ревізій, наприклад, ПОЧАТОК..КІНЕЦЬ, де рядок, який ви шукаєте, повинен існувати у ПОЧАТКУ. git blame --reverse ПОЧАТОК є скороченням для git blame --reverse ПОЧАТОК..HEAD.

--first-parent

Слідує лише за першим батьківським комітом після того, як побачить коміт злиття. Ця опція може бути використана для визначення, коли рядок зʼявився саме у певній гілці, а не коли його в цілому було додано.

-p
--porcelain

Показує у форматі, призначеному для машинного використання.

--line-porcelain

Показувати формат porcelain, але виводити інформацію про коміт для кожного рядка, а не лише при першому згадуванні коміту. Передбачає використання параметра --porcelain.

--incremental

Показує результати покроково у форматі, призначеному для машинного використання.

--encoding=<encoding>

Визначає кодування для виводу імені автора та заголовку коміту. Встановлення значення none призводить до виводу неконвертованих даних. Детальніше дивіться обговорення кодування на сторінці посібника git-log[1].

--contents <файл>

Анотує використовуючи вміст вказаного файлу, починаючи з <ревізії>, якщо її визначено, або ж з HEAD. Ви можете вказати - аби команда зчитувала контент файлу зі стандартного вводу.

--date <формат>

Визначає формат виводу дати. Якщо цей параметр відсутній, буде використано значення параметру конфігурації blame.date. Якщо ж і його немає, то буде використано формат ISO. Задля ознайомлення із підтримуваними значенням дивіться обговорення параметру --date у git-log[1].

--progress
--no-progress

Типово, статус виконання виводиться у стандартному потоці помилок, коли він підключений до терміналу. Цей прапорець дозволяє виводити прогрес навіть коли такий потік не підключено. --progress не може використовуватися разом з --porcelain чи --incremental.

-M[<число>]

Виявляє переміщені чи скопійовані рядки всередині файлу. Коли коміт переміщує чи копіює сукупність рядків (наприклад, коли вихідний файл містить рядок А і потім Б, а коміт переставляє спочатку Б, а тоді А), традиційний алгоритм розпізнає лише половину руху і, зазвичай, приписує рядки, що були переміщені вгору (тобто Б), батьківському коміту, а рядки, що були переміщені вниз (тобто А), — дочірньому. Із цим параметром, обидві групи рядків приписуються батьківському шляхом виконання додаткових перевірок.

<Число> необовʼязкове. Це нижня межа кількості літерно-цифрових символів, які Git має визначити як переміщені/скопійовані всередині файлу, щоб повʼязати ці рядки із батьківським комітом. Типово дорівнює 20.

-C[<число>]

На додачу до -M визначає переміщені або скопійовані рядки з інших файлів, що були змінені у тому самому коміті. Це корисно коли ви реорганізовуєте вашу програму та переміщуєте код між файлами. Коли цей параметр вказано двічі, команда додатково шукає копії з інших файлів у коміті, в якому файл було створено. Якщо ж його вказано тричі, то команда додатково шукає копії з інших файлів у будь-якому коміті.

<Число> необовʼязкове. Це нижня межа кількості літерно-цифрових символів, які Git має визначити як переміщені/скопійовані між файлами, аби повʼязати ці рядки із батьківським комітом. Типово дорівнює 40. Якщо вказано більше одного параметру -C, то буде використано <число> останнього з них.

--ignore-rev <ревізія>

При визначенні відповідальності ігнорувати зміни, внесені цією версією, так ніби ці зміни ніколи не відбувалися. Рядки, які були змінені або додані ігнорованим комітом, будуть приписані попередньому коміту, який змінив цей рядок або сусідні рядки. Цю опцію можна вказати кілька разів, щоб ігнорувати більше ніж одну ревізію. Якщо встановлено опцію конфігурації blame.markIgnoredLines, то рядки, які були змінені ігнорованим комітом і приписані іншому коміту, будуть позначені символом ? у результатах blame. Якщо встановлено опцію конфігурації blame.markUnblamableLines, то ті рядки, яких торкнувся ігнорований комміт, які ми не змогли приписати іншій ревізії, позначаються символом *. У режимах porcelain ми виводимо ignored та unblamable відповідно на новому рядку.

--ignore-revs-file <файл>

Нехтує ревізіями, що перелічені у <файлі>, який має бути в тому ж форматі що й fsck.skipList. Цей параметр може бути вказано декілька разів. Ці файли будуть опрацьовані після усіх файлів, що визначені параметром конфігурації blame.ignoreRevsFile. Порожнє імʼя файлу ("") очищає перелік ревізій з попередніх опрацьованих файлів.

--color-lines

Позначати кольором рядки у стандартному форматі по-різному, якщо вони походять із того самого коміту, що й попередній рядок. Це полегшує розрізнення блоків коду, доданих у різних комітах. Зазвичай використовується блакитний колір, який можна змінити за допомогою параметра конфігурації color.blame.repeatedLines.

--color-by-age

Кольорові позначки рядків залежно від їхнього віку у типовому форматі. Параметр конфігурації color.blame.highlightRecent визначає, який колір використовуватиметься для кожного вікового діапазону.

-h

Показати повідомлення довідки.

ДИВ. ТАКОЖ

git-blame[1]

GIT

Частина набору git[1]