guide/jmpost_import.rst

   1 =============================================
   2 投稿された man ページのリポジトリへの登録方法
   3 =============================================
   4
   5 JM では所定のフォーマット http://linuxjm.sourceforge.jp/guidance/mailformat.html で
   6 翻訳した man ページを ML に投稿してもらうことになっています。
   7
   8 この形式で投稿された man ページを JM の Git Repository に取り込む方法です。
   9
  10 手順
  11 ====
  12
  13 #. メールを保存します。
  14    投稿されたメールは変換せずに保存して下さい。私は Wanderlust で保存しています。
  15 #. Git Repository 内に移動します。
  16    Repository 内であればどこでも構いません
  17 #. 以下のコマンドを実行します。
  18
  19    .. code-block:: console
  20
  21       cat <saved-mail> | nkf -Lu -w | <repo_top>/admin/ml2cvs
  22
  23 #. 変更内容を確認します。
  24 #. コミットします。
  25    コミットメッセージは特に決まりはありませんが、
  26    パッケージ名は先頭に付けるようにしています。
  27    こんな感じで書いていることが多いです。
  28
  29    .. code-block:: console
  30
  31       <パッケージ名>: Draft <ページ名> [JM:nnnnn]
  32       <パッケージ名>: Release <ページ名> [JM:nnnnn]
  33
  34    [例]
  35
  36    .. code-block:: console
  37
  38       sudo: Drafts posted in [JM:00631] to [JM:00635].
  39       procps: release watch.1 [JM:00428]
  40
  41 #. sourceforge.jp の git repo に push します。ウェブページは cron で更新されます。
  42
  43 実行例
  44 ======
  45
  46 .. code-block:: console
  47
  48    motoki@gemini:~/.../JM/jm.git (master)$ cat ~/tmp/1086.eml | nkf -Lu -w | admin/ml2cvs
  49    UPDATE: admin/../manual/net-tools/translation_list
  50    UPDATE: admin/../manual/net-tools/draft/man8/ifconfig.8
  51    UPDATE: admin/../manual/net-tools/ChangeLog
  52    motoki@gemini:~/.../JM/jm.git (master)$ git status
  53    # On branch master
  54    # Changes not staged for commit:
  55    #   (use "git add <file>..." to update what will be committed)
  56    #   (use "git checkout -- <file>..." to discard changes in working directory)
  57    #
  58    #       modified:   manual/net-tools/ChangeLog
  59    #       modified:   manual/net-tools/draft/man8/ifconfig.8
  60    #       modified:   manual/net-tools/translation_list
  61    #
  62    motoki@gemini:~/.../JM/jm.git (master)$ git diff
  63    motoki@gemini:~/.../JM/jm.git (master)$ git add -u
  64    motoki@gemini:~/.../JM/jm.git (master)$ git commit
  65    [master 5981012] net-tools: Draft ifconfig.8 [JM:00811]
  66     3 files changed, 7 insertions(+), 2 deletions(-)
  67    motoki@gemini:~/.../JM/jm.git (master)$ git push
  68    Counting objects: 17, done.
  69    Delta compression using up to 2 threads.
  70    Compressing objects: 100% (9/9), done.
  71    Writing objects: 100% (9/9), 1013 bytes, done.
  72    Total 9 (delta 7), reused 0 (delta 0)
  73    To ssh://amotoki@git.sourceforge.jp/gitroot/linuxjm/jm.git
  74       7616130..5981012  master -> master
  75    motoki@gemini:~/.../JM/jm.git (master)$ git push
  76    Counting objects: 17, done.
  77    Delta compression using up to 2 threads.
  78    Compressing objects: 100% (9/9), done.
  79    Writing objects: 100% (9/9), 1013 bytes, done.
  80    Total 9 (delta 7), reused 0 (delta 0)
  81    To ssh://amotoki@git.sourceforge.jp/gitroot/linuxjm/jm.git
  82       7616130..5981012  master -> master