Русский ▾ Topics ▾ Latest version ▾ git-mailinfo last updated in 2.43.0

НАЗВАНИЕ

git-mailinfo — Извлекает патч и авторство из одного сообщения электронной почты

ОБЗОР

git mailinfo [-k|-b] [-u | --encoding=<кодировка> | -n]
	       [--[no-]scissors] [--quoted-cr=<действие>]
	       <сообщение> <патч>

ОПИСАНИЕ

Читает одно сообщение электронной почты из стандартного ввода и записывает сообщение журнала коммита в файл <сообщение>, а патчи — в файл <патч>. Имя автора, адрес электронной почты и тема электронной почты выводятся в стандартный вывод для использования 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=<кодировка>

Аналогично -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]:

Warning

Missing ru/config/mailinfo.adoc

See original version for this content.

GIT

Является частью пакета git[1]