Русский ▾ Topics ▾ Latest version ▾ git-notes last updated in 2.50.0

НАЗВАНИЕ

git-notes — Добавление или просмотр заметок к объектам

ОБЗОР

git notes [list [<объект>]]
git notes add [-f] [--allow-empty] [--[no-]separator | --separator=<разрыв-абзаца>] [--[no-]stripspace] [-F <файл> | -m <сообщение> | (-c | -C) <объект>] [-e] [<объект>]
git notes copy [-f] ( --stdin | <объект-источник> [<объект-назначение>] )
git notes append [--allow-empty] [--[no-]separator | --separator=<разрыв-абзаца>] [--[no-]stripspace] [-F <файл> | -m <сообщение> | (-c | -C) <объект>] [-e] [<объект>]
git notes edit [--allow-empty] [<объект>] [--[no-]stripspace]
git notes show [<объект>]
git notes merge [-v | -q] [-s <стратегия> ] <ссылка-на-заметки>
git notes merge --commit [-v | -q]
git notes merge --abort [-v | -q]
git notes remove [--ignore-missing] [--stdin] [<объект>…​]
git notes prune [-n] [-v]
git notes get-ref

ОПИСАНИЕ

Добавляет, удаляет или читает заметки, прикреплённые к объектам, не касаясь самих объектов.

По умолчанию заметки сохраняются и читаются из refs/notes/commits, но это поведение по умолчанию может быть переопределено. См. разделы ПАРАМЕТРЫ, КОНФИГУРАЦИЯ и ОКРУЖЕНИЕ ниже. Если эта ссылка не существует, она будет незаметно создана при первой необходимости сохранить заметку.

Типичное использование заметок — дополнение сообщения коммита без изменения самого коммита. Заметки могут отображаться git log вместе с исходным сообщением коммита. Чтобы отличить эти заметки от сообщения, хранящегося в объекте-коммите, заметки имеют отступ, как и сообщение, после строки без отступа «Заметки (<имя-ссылки>):» (или «Заметки:» для refs/notes/commits).

Заметки также можно добавлять к патчам, подготовленным с помощью git format-patch, используя опцию --notes. Такие заметки добавляются как комментарий к патчу после строки-разделителя из трёх тире.

Чтобы изменить, какие заметки отображаются git log, см. обсуждение notes.displayRef в КОНФИГУРАЦИЯ.

См. конфигурацию notes.rewrite.<команда> для способа переноса заметок между командами, которые перезаписывают коммиты.

ПОДКОМАНДЫ

list

Вывести объект заметки для заданного объекта. Если объект не задан, показать список всех объектов заметок и объектов, которые они аннотируют (в формате «<объект-заметки> <аннотированный-объект>»). Это подкоманда по умолчанию, если подкоманда не указана.