英語 ▾ トピック ▾ 最新バージョン ▾ git-mailinfo は 2.43.0 で最終更新されました

名前

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)で指定された文字セットで、翻字(transliterate)によって再エンコードされます。これは以前はオプションでしたが、現在はデフォルトです。

このフラグが指定されていても、パッチは常に文字セット変換なしでそのまま使用されることに注意してください。

--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エンコーディングで送信されたメールメッセージを処理する際に、デコードされた行が単純なLFではなくCRLFで終わる場合の動作です。

有効なアクションは次のとおりです。

  • nowarn: そのようなCRLFが見つかった場合、Gitは何も行いません。

  • warn: そのようなCRLFが見つかった場合、Gitは各メッセージに対して警告を発行します。

  • strip: GitはそれらのCRLFをLFに変換します。

デフォルトのアクションは、設定オプションmailinfo.quotedCRで設定できます。そのような設定オプションが設定されていない場合、warnが使用されます。

<msg>

メールから抽出されたコミットログメッセージ。通常、メールのSubjectから来るタイトル行は除外されます。

<patch>

メールから抽出されたパッチ。

設定

このセクションのこの行より下は、git-config[1]ドキュメントから選択的に含まれています。内容はそちらに記載されているものと同じです。

mailinfo.scissors

trueの場合、git-mailinfo[1](したがってgit-am[1])は、コマンドラインで--scissorsオプションが指定されたかのようにデフォルトで動作します。有効な場合、この機能はハサミ線(主に">8"、"8<"、"-"で構成される)より前のメッセージ本文のすべてを削除します。

GIT

git[1]スイートの一部

scroll-to-top