OSDN Git Service

LDP: (README.JM) Update the procedure of updating to use perkamon
authorAkihiro MOTOKI <amotoki@gmail.com>
Fri, 16 Aug 2013 09:30:39 +0000 (18:30 +0900)
committerAkihiro MOTOKI <amotoki@gmail.com>
Fri, 16 Aug 2013 09:30:39 +0000 (18:30 +0900)
manual/LDP_man-pages/README.JM

index 05861fe..820ebf1 100644 (file)
@@ -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 ã\81\8cæ\9b´æ\96°ã\81\95ã\82\8cã\81¦ã\81\84ã\82\8bã\81®ã\81§ã\80\81fuzzy ã\81\8cå°\91ã\81ªã\81\8fã\81¨ã\82\82ä¸\80ã\81¤ã\81§ã\81\8dã\82\8bã\81®ã\81§ã\80\81
-  ja.po を更新する。
+  COLOPHON ã\81\8cæ\9b´æ\96°ã\81\95ã\82\8cã\81¦ã\81\84ã\82\8bã\81®ã\81§ã\80\81fuzzy ã\81\8cå°\91ã\81ªã\81\8fã\81¨ã\82\82ä¸\80ã\81¤ã\81§ã\81\8dã\82\8bã\80\82
+  ja.po ã\81§ fuzzy ã\82\92æ\8e¢ã\81\97ã\81¦ã\83\90ã\83¼ã\82¸ã\83§ã\83³ã\82\92æ\9b´æ\96°ã\81\99ã\82\8bã\80\82
 
   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"