@@ -1 +1,42 @@
+AdminGuide
+
+= JM Repository でのオリジナル更新方法 =
+
+JM Repository の構成は http://linuxjm.sourceforge.jp/guidance/repository.html#structure に書かれている通りです。
+
+JM の翻訳の管理方法は
+
+ * roff を直接翻訳
+ * po4a を使って翻訳
+
+の2つの方法が混在しています。
+
+オリジナルの更新方法もどちらの管理方法をとっているかによって異なります。
+
+po4a を使用している場合には、各パッケージのディレクトリに po4a というフォルダが存在します。
+存在しない場合は、roff を直接編集して翻訳しています。
+
+== roff を直接翻訳 ==
+
+後できちんと書きたいと思います。
+
+関連するコマンド群は以下 (だったと思う)
+
+ * admin/JM-orig-upd.sh
+ * admin/git2upd
+ * admin/upd_tl.perl
+
+== po4a を使って翻訳 ==
+
+(to be written)
+
+== LDP man-pages ==
+
+http://sourceforge.jp/projects/linuxjm/scm/git/jm/blobs/master/manual/LDP_man-pages/README.JM の
+'''How to update original''' のところを参照して下さい。
+
+== GNU coreutils ==
+
+(to be written)
+
 

@@ -3,7 +3,8 @@
 JM Repository での作業方法に関するメモをまとめていきます。
+括弧が付いている項目はまだドキュメントがありません。
 
  * AdminJmPostImport : ML に投稿された翻訳を JM Repository に取り込む方法
  * AdminTranslationUpdate : JM Repository での翻訳の手動更新方法
  * AdminUpstreamUpdate : JM Repository での Upstream 更新の反映方法
- * AdminPo4a
+ * AdminPo4a (po4a の使い方やノウハウが書いていきたいです)
 

@@ -55,8 +55,15 @@
  1. make または make translate で ja.po の内容を draft 以下に反映します。
  1. (参考 make stat で ja.po の翻訳状況を表示できます)
  1. release に反映する必要がある場合は、「roff を直接翻訳」の場合と同様に JM-release.sh を使用して、release フォルダ以下に反映して下さい。
  1. git commit で更新を登録して、git push で sf.jp に送信して下さい
+
+=== po4a 移行後の課題 ===
+
+ * レビューをどのようにして行うか?
+   * ja.po を投稿してもレビューできない。 できあがった draft でレビューする必要がある。
+ * translation-list の更新が手動になっている
+ * 複数のファイルが一つの ja.po の変更で更新されることがあり、管理が面倒
 
 == LDP man-pages ==
 
 以下を参照して下さい。
@@ -67,5 +74,4 @@
 '''[未整理]'''
 
 help2man の出力と、追加ファイル *.x の翻訳を合わせて、日本語マニュアルを生成しています。
 そのため、管理が他のものと異なっています。
-

@@ -40,9 +40,9 @@
 }}}
 
 == po4a を使って翻訳 ==
 
-'''LDP_man-pages と GNU_coreutils は管理方法が特殊なので、別途整理します'''
+'''LDP_man-pages と GNU_coreutils は管理方法が少し複雑です。詳細は下の方にありますので参照して下さい。'''
 
 翻訳は po4a ディレクトリ以下の ja.po ファイルで管理しています。
 ja.po ファイルは po4a/ja.po の場合と、po4a//ja.po にある場合があります。
 
@@ -55,5 +55,17 @@
  1. make または make translate で ja.po の内容を draft 以下に反映します。
  1. (参考 make stat で ja.po の翻訳状況を表示できます)
  1. release に反映する必要がある場合は、「roff を直接翻訳」の場合と同様に JM-release.sh を使用して、release フォルダ以下に反映して下さい。
  1. git commit で更新を登録して、git push で sf.jp に送信して下さい
+
+== LDP man-pages ==
+
+以下を参照して下さい。
+http://sourceforge.jp/projects/linuxjm/scm/git/jm/blobs/master/manual/LDP_man-pages/README.JM
+
+== GNU_coreutils ==
+
+'''[未整理]'''
+
+help2man の出力と、追加ファイル *.x の翻訳を合わせて、日本語マニュアルを生成しています。
+そのため、管理が他のものと異なっています。
 

@@ -14,9 +14,9 @@
  * [wiki:PackageStatus] : 現在の配布物一覧とそのステータス
 
 == 管理者向け情報
 
-AdminGuide
+ * AdminGuide
 
 == JM 活動立て直しに向けて ==
 
  * 長年続いている活動を何とか活性化していきたいと考えています。

@@ -1,4 +1,6 @@
+AdminGuide
+
 = JM Repository での翻訳更新方法 =
 
 JM Repository の構成は http://linuxjm.sourceforge.jp/guidance/repository.html#structure に書かれている通りです。
 

@@ -1,4 +1,6 @@
+AdminGuide
+
 = 投稿された man ページのレポジトリへの登録方法
 
 JM では所定のフォーマット http://linuxjm.sourceforge.jp/guidance/mailformat.html で
 翻訳した man ページを ML に投稿してもらうことになっています。

@@ -37,5 +37,21 @@
 (git commit -> git push)
 }}}
 
 == po4a を使って翻訳 ==
+
+'''LDP_man-pages と GNU_coreutils は管理方法が特殊なので、別途整理します'''
+
+翻訳は po4a ディレクトリ以下の ja.po ファイルで管理しています。
+ja.po ファイルは po4a/ja.po の場合と、po4a//ja.po にある場合があります。
+
+ 1. man ページに対応する ja.po がどれかは po4a/**/*.cfg を見て判断します。
+   更新したいファイルが分かっている場合は以下のように grep して下さい。
+{{{
+$ grep iptables-save.8 po4a/**/*.cfg
+}}}
+ 1. ja.po を編集します。編集にあたっては Emacs の po-mode, poedit などが利用できます。
+ 1. make または make translate で ja.po の内容を draft 以下に反映します。
+ 1. (参考 make stat で ja.po の翻訳状況を表示できます)
+ 1. release に反映する必要がある場合は、「roff を直接翻訳」の場合と同様に JM-release.sh を使用して、release フォルダ以下に反映して下さい。
+ 1. git commit で更新を登録して、git push で sf.jp に送信して下さい
 

@@ -1 +1,41 @@
+= JM Repository での翻訳更新方法 =
+
+JM Repository の構成は http://linuxjm.sourceforge.jp/guidance/repository.html#structure に書かれている通りです。
+
+JM の翻訳の管理方法は
+
+ * roff を直接翻訳
+ * po4a を使って翻訳
+
+の2つの方法が混在しています。
+
+po4a を使用している場合には、各パッケージのディレクトリに po4a というフォルダが存在します。
+存在しない場合は、roff を直接編集して翻訳しています。
+
+== roff を直接翻訳 ==
+
+release 版を編集する場合は、必ず draft を編集してから、 release に反映して下さい。
+draft 側には、原文がコメントとして入っていますが、release には翻訳済みの文章のみが含まれます。
+
+'''以下の説明は、各パッケージのディレクトリ (manual/fetchmail など) で作業することを前提に説明します。'''
+
+ 1. draft を更新します
+ 1. draft の更新が終わったら、release に反映します。
+   対象ファイルを draft 以下から release 以下にコピーするだけですが、 JM-release.sh コマンドを利用するのが楽です。
+{{{
+$ ../../admin/JM-release.sh -f -g draft/man1/fetchmail.1 release
+draft/man1/fetchmail.1 -> release/man1/fetchmail.1
+}}}
+ 1. Git でコミットして、sourceforge.jp に push します。
+
+draft 以下の全ファイルを release に反映する場合は、JM-release-all.sh コマンドを実行します。
+draft の全ファイルがリリース済みの場合に release への反映もれがないかを確認する際などに使います。
+{{{
+$ cd manual/fetchmail
+$ ../../admin/JM-release-all.sh
+(git status や git diff で変更内容を確認)
+(git commit -> git push)
+}}}
+
+== po4a を使って翻訳 ==
 

@@ -1,5 +1,9 @@
 == JM 管理者向け情報 ==
 
- * AdminJmPostImport : ML に投稿された翻訳を JM Repository に取り込む方法
+JM Repository での作業方法に関するメモをまとめていきます。
 
+ * AdminJmPostImport : ML に投稿された翻訳を JM Repository に取り込む方法
+ * AdminTranslationUpdate : JM Repository での翻訳の手動更新方法
+ * AdminUpstreamUpdate : JM Repository での Upstream 更新の反映方法
+ * AdminPo4a