git-mailinfo

Имя

git-mailinfo — извлекает патчи и информацию об авторе из одного электронного письма

Синтаксис

git mailinfo [-k|-b] [-u | --encoding=<encoding> | -n]
               [--[no-]scissors] [--quoted-cr=<action>]
               <msg> <patch>

Описание

Считывает одно электронное письмо со стандартного ввода и записывает сообщение коммита в файл <msg>, а патчи — в файл <patch>. Имя автора, электронную почту и тему письма записывает в стандартный вывод, чтобы использовать с git am для создания коммита. Обычно использовать эту команду напрямую не нужно. Используйте git-am[1] вместо этого.

Параметры

-k

Обычно программа удаляет мусор из заголовка Subject: для извлечения заголовка сообщения коммита. Этот параметр предотвращает это изменение и наиболее полезен при повторном чтении git format-patch -k вывода.

Конкретно, удаляются следующие элементы, пока они не будут все убраны:

Пробелы в начале и конце.
Ведущие Re:, re:, и :.
Ведущие строковые выражения в квадратных скобках (между [ и ], обычно [PATCH]).

Наконец, последовательности пробелов нормализуются до одного ASCII пробела.

-b

Когда -k не используется, все ведущие строки в квадратных скобках с парами [ и ] удаляются. Этот параметр ограничивает удаление только парами, в которых строка в квадратных скобках содержит слово "PATCH".

-u

Сообщение коммита, имя автора и адрес электронной почты автора берутся из письма и, после минимального декодирования MIME-кодирования передачи, закодируются заново в кодировке символов, указанной в i18n.commitEncoding (по умолчанию UTF-8), путем транслитерации. Раньше это было необязательно, но теперь это значение по умолчанию.

Обратите внимание, что патч всегда используется как есть без преобразования кодировки символов, даже с этим флагом.

--encoding=<encoding>

Аналогично -u. Но при повторном кодировании используется кодировка символов, указанная здесь, вместо кодировки, указанной в i18n.commitEncoding или UTF-8.

-n

Отключить все преобразования кодировки символов метаданных.

-m

--message-id

Копирует заголовок Message-ID в конце сообщения коммита. Это полезно для сопоставления коммитов с обсуждениями на списках рассылки.

--scissors

Удаляет всё в теле перед строкой ножниц (например, "-- >8 --"). Строка представляет собой метку ножниц и перфорацию, и используется для запроса обрезки сообщения на этой строке. Если эта строка появляется в теле сообщения перед патчем, всё перед ней (включая саму строку ножниц) игнорируется при использовании этого параметра.

Это полезно, если вы хотите начать своё сообщение в потоке обсуждения с комментариями и предложениями к сообщению, на которое вы отвечаете, и завершить его отправкой патча, разделяя обсуждение и начало предлагаемого сообщения коммита строкой ножниц.

Это может быть включено по умолчанию с параметром конфигурации mailinfo.scissors.

--no-scissors

Игнорировать строки ножниц. Полезно для переопределения настроек mailinfo.scissors.

--quoted-cr=<action>

Действие при обработке электронных писем, отправленных с использованием кодировки base64 или quoted-printable, и закодированные строки заканчиваются CRLF вместо просто LF.

Допустимые действия:

nowarn: Git ничего не сделает, если такой CRLF будет найден.
warn: Git выведет предупреждение для каждого сообщения, если такой CRLF будет найден.
strip: Git преобразует эти CRLF в LF.

Действие по умолчанию можно задать с помощью параметра конфигурации mailinfo.quotedCR. Если такой параметр конфигурации не задан, используется warn.

<msg>

Сообщение коммита, извлечённое из электронного письма, обычно за исключением заголовка, который берется из темы электронного письма.

<patch>

Патч, извлеченный из электронного письма.

Конфигурация

Всё ниже этой строки в этом разделе включено выборочно из документации git-config[1]. Содержимое такое же, как и там:

mailinfo.scissors: Если значение true, заставляет git-mailinfo[1] (и, следовательно, git-am[1]) действовать по умолчанию так, как будто на командной строке был указан параметр --scissors. При включении эта функция удаляет все из тела сообщения перед строкой ножниц (то есть в основном состоящую из ">8", "8<" и "-").

© 2005–2026 Linus Torvalds and others
Licensed under the GNU General Public License version 2.
https://git-scm.com/docs/git-mailinfo