SYNOPSIS

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

DESCRIPTION

標準入力から単一の電子メールメッセージを読み取り、コミットログメッセージを <msg> ファイルに書き込み、パッチを <patch> ファイルに書き込みます。作者名と電子メールアドレスと電子メールの件名は、コミットを作成する git am で使用するために標準出力に書き出されます。通常、このコマンドをユーザーが直接使用する必要はありません。代わりに git-am(1) を参照してください。

OPTIONS

-k

通常、プログラムは、 Subject: ヘッダー行から電子メール特有の断片文字列を取り除き、コミットログメッセージのタイトル行を取り出します。このオプションは、この変更をある程度防ぎ、 git format-patch -k 出力を読み返すために使用する場合に最も役立つようにします。

具体的には、以下のものがなくなるまでは削除を行います:

  • 先頭と末尾の空白(whitespace)を削除。

  • 先頭の Re: や re: や : を削除。

  • 先頭のブラケットで囲まれた文字列( [ 〜 ] 、 通常は [PATCH] ) 。

最後に、空白類(whitespace)は単一のASCIIスペース文字(\x20)に正規化されます。

-b

-k が有効でない場合、 先頭のブラケット [ と ] のペアで囲まれたすべての文字列が削除されます。このオプションは、括弧で囲まれた文字列に PATCH という単語が含まれているペアのみに削除を制限します。

-u

コミットログメッセージ、作者名、作者の電子メールアドレスは電子メールから取得され、MIME転送エンコーディングを最小限にデコードした後、それらを変換することにより、 i18n.commitEncoding (デフォルトはUTF-8) で指定された文字セットに再コーディングされます。これは以前はオプションでしたが、現在はデフォルトです。

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

--encoding=<encoding>

-u に似ています。 ただし、再コーディング時には、 i18n.commitEncoding で指定された文字セットまたはUTF-8の代わりに、ここで指定した文字セットが使用されます。

-n

メタデータのすべての文字セットの再コーディングを無効にします。

-m
--message-id

コミットメッセージの最後にあるMessage-IDヘッダーをコピーします。これは、コミットをメーリングリストのディスカッションに関連付けるのに役立ちます。

--scissors

本文で切り取り線(例えば -- >8 -- )の前にあるすべてを取り除きます。 この線は、はさみ(scissors)とミシン目マークを表しており、その行でメッセージをカットするように読者に要求するために使用されます。パッチの前のメッセージの本文にその行が表示されている場合、このオプションを使用すると、その行の前のすべて(切り取り線の行自体を含む)が無視されます(訳注: >8 や 8< は「ハサミ」を示す絵文字)。

これは、返信するメッセージに関するコメントと提案を含むディスカッションスレッドでメッセージを開始し、パッチの送信でメッセージを終了し、ディスカッションと提案されたコミットログメッセージの開始を切り取り線で区切る場合に役立ちます。

これは、構成オプション mailinfo.scissors を使用してデフォルトで有効にできます。

--no-scissors

切り取り線を無視します。 mailinfo.scissors 設定を上書きするのに便利です。

--quoted-cr=<action>

base64またはquoted-printableエンコーディングで送信された電子メールメッセージを処理し、デコードされた行が単純なLFではなくCRLFで終了する場合の操作(action)を指定。

有効な操作(action)は:

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

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

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

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

<msg>

電子メールから抽出されたコミットログメッセージ。通常、電子メールの件名から抽出したタイトル行は除きます。

<patch>

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

CONFIGURATION

このセクションの以下のすべては、 git-config(1) ドキュメントの抜粋です。 内容は git-config(1) ドキュメント にあるものと同一です:

mailinfo.scissors

trueの場合、 git-mailinfo(1) (それゆえ git-am(1) も)は、コマンドラインで --scissors オプションが指定されているかのようにデフォルトで動作します。この機能がアクティブな場合、メッセージ本文から切り取り線(つまり、主に ">8" や "8<" や "-" で構成される)行とそれより前のすべてを削除します。

GIT

Part of the git(1) suite