guide/LDP_man-pages_update.rst

   1 .. _ldp_original_update:
   2
   3 ========================
   4 LDP man-pages 管理ガイド
   5 ========================
   6
   7 準備
   8 ====
   9
  10 :ref:`ldp_preparation` を参照してください。
  11
  12 原文の更新方法
  13 ==============
  14
  15 Git Repo 以下はきれいな状態にした状態で始めること。
  16
  17 作業手順は以下の通り。
  18
  19 1. perkamon の更新
  20 2. 原文の更新作業
  21 3. 単純な fuzzy の更新
  22
  23 1. perkamon の更新
  24 ------------------
  25
  26 .. code-block:: console
  27
  28    cd perkamon
  29    git remote add upstream git://gitorious.org/perkamon/man-pages.git
  30    git remote update
  31    git checkout master
  32    git merge upstream/master
  33    git push origin
  34    cd -
  35
  36 現状 JM 用の perkamon は amotoki が管理する GitHub Repository
  37 https://github.com/amotoki/perkamon.git にあります。
  38 Commit 権が必要であれば Collaborator に登録しますので、連絡下さい。
  39
  40 オリジナルが更新されていない場合は自分で更新する
  41
  42 .. code-block:: console
  43
  44    cd perkamon
  45    vi Makefile
  46    (Update the version number at the top)
  47    rm -f stamp-*
  48    make setup
  49    (build 以下が更新される)
  50    make print-new-files
  51    (何か表示されたら、po4a/*/*.cfg に追加)
  52    make disable-removed
  53    (何かないか確認)
  54    git status
  55    (更新があれば git commit & git push origin)
  56
  57 2. 原文の更新作業
  58 -----------------
  59
  60 perkamon 作業ディレクトリに最新版に対応した展開する
  61
  62 .. code-block:: console
  63
  64    make upgrade
  65
  66 以下の作業が行われる。
  67
  68 * [make jm-setup]
  69
  70   * 最新版の man-pages の tarball が perkamon/ 直下にダウンロードされる。
  71   * tarball が perkamon/man-pages ディレクトリに展開される。
  72   * po4a 作業用の source lang が build/C として用意される。
  73
  74     * 実際にコンテンツがあるファイルが build/C/man? 以下に man-pages 以下から
  75       コピーされる。
  76     * po4a-fixes.patch がある場合には、build/C/ 以下のファイルに適用される。
  77     * リンクファイルは build/C/link に一覧が作成される。
  78
  79 * original 以下にコピーする
  80
  81 * COLOPHON 以下を削除する。
  82
  83   translation\_list を更新する際に、変更点のみを抽出するために行う。
  84   COLOPHON 部分はリリース毎にバージョン番号が更新されてしまうので、
  85   original に登録する際には、この節を削除しておく。
  86
  87 * original 以下を git で stage する。
  88 * translation\_list の更新
  89 * POT の更新
  90 * 翻訳統計情報の更新
  91
  92 * Git commit
  93
  94   .. code-block:: none
  95
  96      git add translation_list
  97      git commit -m "LDP: Update original to LDP v3.XX"
  98      git add po4a/ stats/ untrans.html
  99      git commit -m "LDP: Update POT and ja.po to LDP v3.XX"
 100
 101 3. 単純な fuzzy の更新
 102 ----------------------
 103
 104 COLOPHON が更新されているので、fuzzy が少なくとも一つできる。
 105 ja.po で fuzzy を探してバージョンを更新する。
 106
 107 .. code-block:: console
 108
 109    make
 110    git add -u po4a/ stats/ untrans.html
 111    git commit -m "LDP: Update the version to 3.XX in PO files"
 112
 113    git add draft/
 114    git commit -m "LDP: Update draft pages based on LDP 3.XX release"
 115
 116    make release
 117    git add release/
 118    git add -u translation_list
 119    git commit -m "LDP: Update release pages based on LDP 3.XX release"