From 5d2337ab088d5d4422f9074b53068470a42fd57c Mon Sep 17 00:00:00 2001
From: Akihiro MOTOKI <amotoki@gmail.com>
Date: Fri, 16 Aug 2013 18:30:39 +0900
Subject: [PATCH] LDP: (README.JM) Update the procedure of updating to use
 perkamon

---
 manual/LDP_man-pages/README.JM | 65 +++++++++++++++++++++++++++++++-----------
 1 file changed, 49 insertions(+), 16 deletions(-)

diff --git a/manual/LDP_man-pages/README.JM b/manual/LDP_man-pages/README.JM
index 05861fe8..820ebf1f 100644
--- a/manual/LDP_man-pages/README.JM
+++ b/manual/LDP_man-pages/README.JM
@@ -88,23 +88,48 @@ make release を実行すると、ja.po から release ファイルが生成さ
 
 = How to update original =
 
-(1) original を取得する
-  wget http://www.kernel.org/pub/linux/docs/man-pages/man-pages-3.XX.tar.xz
+Git Repo 以下はきれいな状態にした状態で始めること。
 
-(2) 展開する。tmp 以下に展開するものとする。
-  mkdir tmp
-  cd tmp
-  tar xJf man-pages-3.XX.tar.xz
+(1) perkamon を更新する
+
+  cd perkamon
+  git remote add upstream git://gitorious.org/perkamon/man-pages.git
+  git remote update
+  git checkout master
+  git merge upstream/master
+  git push origin
+  cd -
+
+  (*) 現状 JM 用の perkamon は amotoki が管理する GitHub 上にあります。
+      Commit 権が必要であれば Collaborator に登録しますので、連絡下さい。
+      https://github.com/amotoki/perkamon.git
+
+(2) perkamon 作業ディレクトリに最新版に対応した展開する
+
+  (ここで Git Repo 以下はきれいな状態にしておく)
+  make clean-setup
+  make jm-setup
+
+  以下の作業が行われる。
+  * 最新版の man-pages の tarball が perkamon/ 直下にダウンロードされる。
+  * tarball が perkamon/man-pages ディレクトリに展開される。
+  * po4a 作業用の source lang が build/C として用意される。
+    * 実際にコンテンツがあるファイルが build/C/man? 以下に man-pages 以下から
+      コピーされる。
+    * po4a-fixes.patch がある場合には、build/C/ 以下のファイルに適用される。
+    * リンクファイルは build/C/link に一覧が作成される。
 
 (3) original 以下にコピーする
-  cd man-pages-3.XX
+  cd perkamon/man-pages
   ../../../../admin/JM-orig-upd.sh ../../original
   cp README man-pages-* Changes* ../../original
+  cd -
 
 (4) COLOPHON 以下を削除する。
     translation_list を更新するため、変更点のみを抽出するため。
-  cd ../../original
-  sh ../tmp/man-pages-3.XX/scripts/remove_COLOPHON.sh man?/*.[1-8]
+  cd original
+  sed -e 's/\^\\\.SH /^\\.S[Hh] /' ../perkamon/man-pages/scripts/remove_COLOPHON.sh
+  sh ../perkamon/man-pages/scripts/remove_COLOPHON.sh man?/*.[1-8]
 
 (5) original 以下を git で stage する。
   (original 以下で作業する。基本的に original 以下の変更は全部取り込む)
@@ -121,12 +146,9 @@ make release を実行すると、ja.po から release ファイルが生成さ
 
 (7) Git commit
   git add translation_list
-  git commit -m "LDP: Update original to LDP v3.XX."
+  git commit -m "LDP: Update original to LDP v3.XX"
 
 (8) POT の更新
-  (ここで Git Repo 以下はきれいな状態にしておく)
-  make clean-setup
-  make jm-setup
   cd perkamon
   make print-new-files
   (何か表示されたら、po4a/*/*.cfg に追加)
@@ -140,11 +162,22 @@ make release を実行すると、ja.po から release ファイルが生成さ
   (これで POT と ja.po が更新される。
    タイムスタンプを気にしなくてよいので --force を付けた方がよい。)
   git add -u po4a/
-  git commit -m "LDP: Update POT and ja.po to LDP v3.XX."
+  git commit -m "LDP: Update POT and ja.po to LDP v3.XX"
+
+  この時点で draft, stats, untrans.html release も更新されている。
 
 (9) 単純な fuzzy の更新
-  COLOPHON が更新されているので、fuzzy が少なくとも一つできるので、
-  ja.po を更新する。
+  COLOPHON が更新されているので、fuzzy が少なくとも一つできる。
+  ja.po で fuzzy を探してバージョンを更新する。
 
   make
+  git add -u po4a/ stats/ untrans.html
+  git commit -m "LDP: Update the version to 3.XX in PO files"
+
+  git add draft/
+  git commit -m "LDP: Update draft pages based on LDP 3.XX release"
 
+  make release
+  git add release/
+  git add -u translation_list
+  git commit -m "LDP: Update release pages based on LDP 3.XX release"
-- 
2.11.0