Sending the Corrected Manual by send-jpman

send-jpmanコマンドを用いた成果物提供

send-jpmanコマンドの入手
send-jpmanコマンドは以下のところから入手できます。
http://home.jp.FreeBSD.org/man-jp/yoyaku/send-jpman
send-jpmanコマンドはユーザ権限で動くshスクリプトです。適当なディレクトリにコピーしておきます。
send-jpmanコマンドの起動
send-jpmanコマンドは一度に一つのマニュアルファイルを処理します。提供する成果物が複数ある場合は、各ファイル毎に処理を繰り返して下さい。
send-jpmanコマンドは環境変数LANGが日本語っぽく設定されていると出力メッセージを日本語EUCにするので、端末が日本語EUCを表示可能なら、環境変数LANGをja_JP.EUC等に設定しておくとよいでしょう。
成果物提供には全文提供と差分提供の2種類の方法があります。 マニュアルファイルがある程度大きく、変更点がわずかな場合は、差分提供を行う方が送信時間が短く経済的です。
- 全文提供の場合
  以下のようにsend-jpmanコマンドを起動します。
```
 % send-jpman CORRECTED_FILE ACCOUNT_ID
	      
```
  CORRECTED_FILEには校正済みファイルのパスを書きます。 CORRECTED_FILEのbasenameは校正したマニュアル名 ("man.1"等)である必要があります。
  ACCOUNT_IDにはマニュアル予約時のアカウントIDを書きます。
```
 (例)
 % send-jpman ~/jpman/man.1 nobody0999
	      
```
- 差分提供の場合
  以下のようにsend-jpmanコマンドを起動します。
```
 % send-jpman ORIGINAL_FILE CORRECTED_FILE ACCOUNT_ID
	      
```
  ORIGINAL_FILEには校正前のファイルのパス、 CORRECTED_FILEには校正済みファイルのパス、 ACCOUNT_IDにはマニュアル予約時のアカウントIDを書きます。
  CORRECTED_FILEのbasenameは校正したマニュアル名 ("man.1"等)である必要があります。
```
 (例)
 % send-jpman ~/jpman/man.1.orig ~/jpman/man.1 nobody0999
	      
```
(注) 現在のシステムでは、 前回リビジョンから全く変更のないものは正しく受理できません。 ベースリリースが変更になったが対応する英語版マニュアルが全く変更されていない場合など、何らかの理由で一切変更のないマニュアルを成果物として提供しなければならない場合は、お手数ですが、改行位置やコメント等をわずかに変更の上、 send-jpmanコマンドで提供して下さい。
send-jpmanコマンド中の操作
send-jpmanコマンドは対話的に処理を進めます。その流れはMHに少し似ています。
send-jpmanコマンドは送信用の原稿を作成してその内容(先頭と末尾の数行ずつ)を表示し、その後の処理を問い合わせてきます。
```
送信するメールは以下のような内容になります:
------------------------------------------------
# account nobody999
begin 644 man.1.gz
    (中略)
------------------------------------------------
46 行, 2094 バイト

どうしますか? (edit[再編集]/send[送信実行]/quit[中止])
       
```
ここで
- e [リターン] とすると、
  この送信原稿をエディタ(環境変数EDITOR参照)で編集できます。
  デフォルトでは入っていませんが、一時的なメールアドレスの変更をここに記述することもできます。詳しいことは成果物提供メール書式を参照して下さい。
  エディタを終了すると、再度上のように問い合わせられます。
- s [リターン] とすると、
  この送信原稿をメールにて送信します。送信先等の必要事項は自動設定されます。
- q [リターン] とすると、
  送信を含め、send-jpmanコマンドを中断します。送信原稿はホームディレクトリのdraft.manjpというファイルに書き込まれます。
- ^C [リターン] とすると、
  強制的に中断します。送信原稿は破棄されます。
send-jpmanコマンドで送信したら
- 成果物は自動的に処理されます。
  所定のメール形式に沿っていれば仮受理されます。
  仮受理中は全景ページに「成果物送付」と表示されます。
- 自動処理の成否は、メールで通知されます。
  普通は数分以内に届くと思います。
- 仮受理がなされた後は、JPMAN管理人が成果物の内容に関して一通り吟味の上、正式受理処理を行います(普通は数日以内)。
  正式受理されると全景ページの表示は「予約待ち」に戻ります。
うまく成果物提供ができなかったら
手動でメールしてみるか、あるいはJPMAN管理人に相談して下さい。