.\"	@(MHWARNING)
.\"		written by MH-plus project
.SC FORW 1
.NA
forw \- メッセージを転送する
.SY
forw
\%[+folder] \%[msgs]
\%[\-annotate] \%[\-noannotate]
\%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
\%[\-editor\ editor] \%[\-noedit]
\%[\-filter\ filterfile]
\%[\-form\ formfile]
\%[\-format] \%[\-noformat]
\%[\-inplace] \%[\-noinplace]
@BEGIN: MIME
\%[\-mime] \%[\-nomime]
@END: MIME
\%[\-whatnowproc\ program] \%[\-nowhatnowproc]
\%[\-help]

.ti .5i
forw
\%[+folder] \%[msgs]
\%[\-digest\ list] \%[\-issue\ number] \%[\-volume\ number]
\%[other\ switches\ for\ \fIforw\fR]
\%[\-help]
.DE
\fIforw\fR は、
他のメッセージを含んだメッセージを作るために使われます。
メッセージ・フォーム(\fIcomp\fR 参照)から、
新しいメッセージを作り、
転送されるメッセージをボディ部分に含めます。
\fIcomp\fR 同様にエディタが呼び出され、編集が終わると、メッセージが送られる
前にユーザーに質問をしてきます。

転送されるメッセージを含む場合の、
デフォルトのメッセージ・フォームは次の通りです。

.nf
.in +.5i
.ne 10
.eo
.so @(MHETCPATH)/forwcomps
.ec
.in -.5i
.fi

もし、ユーザーの MH ディレクトリの中に \*(lqforwcomps\*(rq という名前の
ファイルがある場合には、このフォームに代わって、それが使われます。
いずれの場合も、`\-form\ formfile' が指定された場合はそのファイルが使われます。

もし、ドラフトが既に存在する場合、
\fIforw\fR はそのドラフトをどうするのかを聞いて来ます。
\fBquit\fR と答えると、ドラフトをそのまま残して、\fIforw\fR を終了し、
\fBreplace\fR では存在するドラフトを空の雛型で置き換え、
\fBlist\fR ではドラフトを表示します。

もし、`\-annotate' オプションが指定されると、転送されるメッセージには
次に示すような注釈が付けられます。

     Forwarded:\ 日付
     Forwarded:\ アドレス

アドレスリストは要求されるだけ多くの行になり得ます。
この注釈は
メッセージが \fIforw\fR から直接送られた時にだけ付けられます。
もし、メッセージが \fIforw\fR からすぐには送られずに、
後に \*(lqcomp \-use\*(rq などで再編集してから送られた場合、
この注釈付けは行なわれません。
`\-inplace' オプションが指定されると、
注釈が付けられるメッセージのハードリンクを保持するために、
移動・コピー等せずに、そのファイル自身に注釈付けが行なわれます。

`\-editor' や `\-noedit' オプションに関しては
\fIcomp\fR\0(1) を参照して下さい。

\fIforw\fR では、`\-form\ formfile' オプションを、
ドラフトの最初の状態を作るために使いますが、
`\-filter\ filterfile'、`\-format'、そして `\-noformat' オプションは、
ドラフトのボディ部分に含まれる
転送されるそれぞれのメッセージを整形する際に使います。
`\-noformat' オプションが指定されると、
それぞれの転送されるメッセージはまさにそのままボディ部分に出力されます。
もし `\-format' または `\-filter\ filterfile' が指定されると、
転送されるそれぞれのメッセージは、ドラフトのボディへと出力される前に
フィルタ(再整形)にかけられます。
\fIforw\fR は転送されるメッセージを整形する際に \fImhl\fR を呼び出すので、
\fIforw\fR に対するフィルタ・ファイルは \fImhl\fR の標準フォーマットで
あるべきです。
デフォルトのメッセージ・フィルタ(`\-format' 指定時)は次の通りです。

.nf
.in +.5i
.ne 10
.eo
.so @(MHETCPATH)/mhl.forward
.ec
.in -.5i
.fi

もし、ユーザーの MH ディレクトリに \*(lqmhl.forward\*(rq という名前のファイルが
ある場合、このフォームに代わってそれが使われます。
いずれの場合も、`\-filter\ filterfile' が指定された場合はそのファイルが
使われます。
まとめると次のようになります。
`\-noformat' は転送されるそれぞれのメッセージをそのまま使い、
`\-format' は \fImhl\fR と
デフォルトのフィルタ・ファイル、つまり \*(lqmhl.forward\*(rq を使い、
`\-filter\ filterfile' は転送されるそれぞれのメッセージ を
\fImhl\fR で整形する際に指定のフィルタ・ファイルを使います。

転送されるそれぞれのメッセージは、取り込み区切りで分割され、
転送されるメッセージの各行の最初の文字がダッシュ(`\-')である場合、
その前に `\-\ ' が付けられます。
これは受けとった際に、
メッセージを \fIburst\fR\0(1) で分割するのに適しています。
これは RFC\-934 に従った方式です。

\fIprompter\fR\0(1) のユーザーは、
\&.mh\(ruprofile ファイル内で prompter に `-prepend' オプションを指定すると、
任意の注釈テキストを転送されるメッセージの前に挿入出来ます。

@BEGIN: MIME
メッセージの包含に MIME ルールを使う場合には、
`\-mime' オプションを使います。
これにより \fIforw\fR は \fImhn\fR 処理を行なうためのファイルを作ります。
このファイルは送り出す前に \fImhn\fR で処理する必要があります。

\&.mh\(ruprofile に以下の行を追加しない限り、
MH は、自動的には \fImhn\fR は呼び出さない事に注意して下さい。
.sp
.in +.5i
automhnproc: mhn
.in -.5i
.sp
これをしない時は、
ドラフトを送る前に明示的に以下のコマンドを使わなければなりません。
.sp
.in +.5i
What now? edit mhn
.in -.5i
.sp

この幾つかの作業を自動で行なわせるためには、
\fIprompter\fR に対する \fIrapid\fR という名前のリンクを作り、
以下の行を \&.mh\(ruprofile に追加します。
.sp
.in +.5i
.nf
forw: -editor rapid -mime
rapid: -rapid
rapid-next: mhn
.fi
.in -.5i
.sp
この時、単に以下のように出来ます。
.sp
.in +.5i
.nf
\fIforw msgs\fR
To: \fImailbox\fR
cc:
Subject: \fIwhatever\fR

--------Enter initial text

\fIblah, blah, blah.\fR
<CTRL-D>
--------

What now? \fIedit\fR
What now? \fIsend\fR
...
.fi
.in -.5i
.sp
\fIedit\fR コマンドは自動的に \fImhn\fR を呼び出します。

@END: MIME
`\-draftfolder\ +folder' と `\-draftmessage\ msg' オプションは
\fIMH\fR のドラフト・フォルダ機能を呼び出します。
これは進んだ(そして極めて有用な)仕様です。
詳しくは \fImh-profile\fR\0(5) の \fIDraft-Folder\fR 部分などを参照して下さい。

エディタを終了する際、\fIforw\fR は \fIwhatnow\fR プログラムを呼び出します。
使えるオプションに関しては \fIwhatnow\fR\0(1) を見て下さい。
このプログラムを呼び出す事は `\-nowhatnowproc' オプションで抑制出来ます
(本当のことを言うと、
最初の編集を開始するプログラムが \fIwhatnow\fR です。
従って、`\-nowhatnowproc' は全ての編集を抑制します)。

`\-digest\ list'、`\-issue\ number'、そして `\-volume\ number' オプションは、
\fIMH\fR のダイジェスト機能のために設計されています。これにより、
メーリングリスト `list' のダイジェスト(まとめ送り)を作成する事が出来ます。
`\-issue\ number' や `\-volume\ number' オプションが指定されない場合に
関しては \fImh-profile\fR\0(5) も参照して下さい。
これらのオプションを指定すると、以下のエスケープが可能になります。
.sp 1
.nf
.ta \w'コンポーネント  'u +\w'エスケープ  'u +\w'integer  'u
\fIタイプ\fR	\fIエスケープ\fR	\fI戻り値\fR	\fI説明\fR
\fIコンポーネント\fR	\fIdigest\fR	string	`\-digest' への引数
\fI関数\fR	\fIcur\fR	integer	`\-volume' への引数
\fI関数\fR	\fImsg\fR	integer	`\-issue' への引数
.re
.fi

\fIforw\fR は `\-digest\ list' が指定された時は、
デフォルトのメッセージ・フォームは \*(lqforwcomps\*(rq に代わって
\*(lqdigestcomps\*(rq が、
デフォルトのフォーマット・ファイルは \*(lqmhl.forward\*(rq に代わって
\*(lqmhl.digest\*(rq が使われます。
ダイジェスト形式に関しては \fIburst\fR\0(1) も参照して下さい。
.Fi
^@(MHETCPATH)/forwcomps~^メッセージの雛型
^あるいは <mh\-dir>/forwcomps~^が標準の雛型に代わる
^@(MHETCPATH)/digestcomps~^`\-digest' が指定された時のメッセージの雛型
^あるいは <mh\-dir>/digestcomps~^が標準の雛型に代わる
^@(MHETCPATH)/mhl.forward~^メッセージのフィルタ
^あるいは <mh\-dir>/mhl.forward~^が標準のフィルタに代わる
^$HOME/\&.mh\(ruprofile~^ユーザーのプロファイル
^<mh\-dir>/draft~^デフォルトのドラフト・ファイル
.Pr
^Path:~^ユーザーの MH ディレクトリを決める
.Ps
^Current\-Folder:~^デフォルトのカレント・フォルダを示す
.Ps
^Draft\-Folder:~^デフォルトのドラフト・フォルダを示す
.Ps
^Editor:~^デフォルトのエディタを置き換える
.Ps
^Msg\-Protect:~^新しいメッセージ(ドラフト)を作る際に
.br
^~^セットされるモード
.Ps
^fileproc:~^メッセージを refile するプログラム
.Ps
^mhlproc:~^転送されるメッセージにフィルターをかけるプログラム
.Ps
^whatnowproc:~^\*(lqWhat now?\*(rq と聞いてくるプログラム
.Sa
\fIProposed Standard for Message Encapsulation\fR (RFC\-934),
.br
comp(1), dist(1), repl(1), send(1), whatnow(1), mh\-format(5)
.De
`+folder'	デフォルトはカレント・フォルダ
`msgs'	デフォルトは cur
.Ds
`\-noannotate'
.Ds
`\-nodraftfolder'
.Ds
`\-noformat'
.Ds
`\-noinplace'
@BEGIN: MIME
.Ds
`\-nomime'
@END: MIME
.Co
もしフォルダが指定されれば、それがカレント・フォルダになります。
転送された最初のメッセージがカレント・メッセージになります。
.Bu
もし \fIwhatnowproc\fR が \fIwhatnow\fR の場合、
\fIforw\fR は \fIwhatnow\fR プログラムを実際に走らせずに、
内蔵の \fIwhatnow\fR ルーチンを使います。
従って、もし自分で独自の \fIwhatnowproc\fR を設定する場合に、
それに \fIwhatnow\fR という名前をつけてはなりません。
\fIforw\fR はそれを起動しないからです。

\fIforw\fR は、メッセージが転送されたと注釈付けをするよう指示された時に、
そのドラフトが配送に成功するまでは、実際に注釈付けを行ないません。
もし、\fIwhatnowproc\fR から、
\fIsend\fR ではなく \fIpush\fR された場合、
\fIforw\fR はそのメッセージが配送に成功する前に
ファイルの順序が変わったりする(例えば、`folder\0\-pack' する)と、
混乱する可能性があります。
\fIdist\fR や \fIrepl\fR にはこの問題はありません。

転送されるメッセージの行頭のダッシュ(`\-\ ')をつけるのを避けたい場合には、
`\-nodashmunging' オプションがあります。
詳しくは \fIMH Administrator's Guide\fR の \*(lqHidden Features\*(rq の
章を参照して下さい。
.En