投稿された man ページのリポジトリへの登録方法

JM では所定のフォーマット http://linuxjm.sourceforge.jp/guidance/mailformat.html で 翻訳した man ページを ML に投稿してもらうことになっています。

この形式で投稿された man ページを JM の Git Repository に取り込む方法です。

手順

  1. メールを保存します。 投稿されたメールは変換せずに保存して下さい。私は Wanderlust で保存しています。

  2. Git Repository 内に移動します。 Repository 内であればどこでも構いません

  3. 以下のコマンドを実行します。

    cat <saved-mail> | nkf -Lu -w | <repo_top>/admin/ml2cvs

  4. 変更内容を確認します。

  5. コミットします。 コミットメッセージは特に決まりはありませんが、 パッケージ名は先頭に付けるようにしています。 こんな感じで書いていることが多いです。

    <パッケージ名>: Draft <ページ名> [JM:nnnnn]
<パッケージ名>: Release <ページ名> [JM:nnnnn]

    [例]

    sudo: Drafts posted in [JM:00631] to [JM:00635].
procps: release watch.1 [JM:00428]

  6. sourceforge.jp の git repo に push します。ウェブページは cron で更新されます。

実行例

motoki@gemini:~/.../JM/jm.git (master)$ cat ~/tmp/1086.eml | nkf -Lu -w | admin/ml2cvs
UPDATE: admin/../manual/net-tools/translation_list
UPDATE: admin/../manual/net-tools/draft/man8/ifconfig.8
UPDATE: admin/../manual/net-tools/ChangeLog
motoki@gemini:~/.../JM/jm.git (master)$ git status
# On branch master
# Changes not staged for commit:
#   (use "git add <file>..." to update what will be committed)
#   (use "git checkout -- <file>..." to discard changes in working directory)
#
#       modified:   manual/net-tools/ChangeLog
#       modified:   manual/net-tools/draft/man8/ifconfig.8
#       modified:   manual/net-tools/translation_list
#
motoki@gemini:~/.../JM/jm.git (master)$ git diff
motoki@gemini:~/.../JM/jm.git (master)$ git add -u
motoki@gemini:~/.../JM/jm.git (master)$ git commit
[master 5981012] net-tools: Draft ifconfig.8 [JM:00811]
 3 files changed, 7 insertions(+), 2 deletions(-)
motoki@gemini:~/.../JM/jm.git (master)$ git push
Counting objects: 17, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (9/9), done.
Writing objects: 100% (9/9), 1013 bytes, done.
Total 9 (delta 7), reused 0 (delta 0)
To ssh://amotoki@git.sourceforge.jp/gitroot/linuxjm/jm.git
   7616130..5981012  master -> master
motoki@gemini:~/.../JM/jm.git (master)$ git push
Counting objects: 17, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (9/9), done.
Writing objects: 100% (9/9), 1013 bytes, done.
Total 9 (delta 7), reused 0 (delta 0)
To ssh://amotoki@git.sourceforge.jp/gitroot/linuxjm/jm.git
   7616130..5981012  master -> master