guide: Update GNU coreutils guides

diff --git a/guide/GNU_coreutils.rst b/guide/GNU_coreutils.rst
index 45f1810..6bd493a 100644 (file)
--- a/guide/GNU_coreutils.rst
+++ b/guide/GNU_coreutils.rst
@@ -26,23 +26,63 @@ Debian/Ubuntu の場合は ``help2man`` と ``language-pack-ja`` をインスト
 
    apt-get install build-essential
 
-翻訳ã\81®æµ\81ã\82\8c
+翻訳ã\81®æ\89\8bé \86
 ==========
 
-``help2man.ja`` 以下の ``*.x`` を訳す。
-原文は roff の場合と同じく ``.\"O`` で始めるものとする。
+GNU coreutils のマニュアルは ``help2man`` を使って生成しています。
+翻訳は以下の 2 つの組み合わせで生成されています。
 
-* トップディレクトリで ``make all`` を実行すると ``help2man`` が実行され、
-  ``help2man.ja/`` 以下に ``*.1`` が生成される。
+* GNU coreutils のコマンドの ``--help`` の出力
+* ``help2man.ja/*.x`` 以下のファイル
 
-  * 最初は ``coreutils-*.tar.xz`` を取得して、プログラムの生成も行うので、時間がかかる。
-  * ``make clean`` で ``help2man.ja/*.1`` を削除できる。
+翻訳を始める前に
+----------------
 
+``make all`` を実行すると ``GNU coreutils`` のソースが ``source`` 以下に展開され、
+man page の自動生成の環境が整います。
+
+.. code-block:: console
+
+   $ cd <JM repo top>
+   $ cd manual/GNU_coreutils
+   $ make all
+
+補足事項
+
+* 最初は ``coreutils-*.tar.xz`` を取得して、プログラムの生成も行うので、時間がかかります。
+* ``make clean`` で ``help2man.ja/*.1`` を削除できます。
 * トップディレクトリで ``make install`` を実行すると、
   ``help2man.ja/*.1`` が ``draft/man1`` にコピーされる。
 
+coreutils の ja.po
+------------------
+
+コマンドの ``--help`` 出力は GNU coreutils の配布物の ``po/ja.po`` を元に
+作成されており、この ``ja.po`` は
+`Translation Project <http://translationproject.org/team/ja.html>`_ で
+管理されています。
+
+変更が必要な場合は上記で展開された ``source/po/ja.po`` を編集します。
+変更後に上記の ``make all`` を実行すると、
+``help2man.ja/`` 以下に ``*.1`` が生成されます。
+
+変更を行ったものは基本的に
+`Translation Project <http://translationproject.org/team/ja.html>`_
+に反映するのが筋だと思います。
+
+help2man.ja/\*.x
+----------------
+
+``help2man.ja/\*.x`` は help2man が生成する man page に組み込まれます。
+
+``help2man.ja`` の翻訳では、
+原文は roff の場合と同じく ``.\"O`` で始めるものとします。
+
+変更の翻訳への反映方法は ``ja.po`` の場合と同じく
+``make html`` を実行します。
+
 翻訳校正 (暫定ルール)
-------------------------
+=====================
 
 * ``*.x`` を投稿する。
   original の翻訳者が manpage も投稿してもよい。

diff --git a/guide/GNU_coreutils_update.rst b/guide/GNU_coreutils_update.rst
index 2c89e75..870e714 100644 (file)
--- a/guide/GNU_coreutils_update.rst
+++ b/guide/GNU_coreutils_update.rst
@@ -54,3 +54,21 @@ help2man.orig 側でのファイルの add/update/remove を反映する。
 * help message が更新された場合
 
   * ``SOURCE/po/ja.po`` を修正して Translation Project へ。
+
+独自管理パッチ
+==============
+
+GNU coreutils のマニュアルでは、
+coreutils のソースを利用してコンパイルして、
+``ja.po`` を組み込んで man pages を生成しているため、
+場合によっては独自修正を管理する場合がある。
+
+2 つのパッチが Makefile でサポートされています。
+
+* ``patch-$(VERSION).diff`` : coreutils に対するパッチ
+* ``ja.po/ja.po.$(VERSION)`` : 変更後の ja.po ファイル。
+
+  * パッチではない点に注意。
+  * 翻訳内容をローカル修正した場合にはこのファイルに反映を行う。
+  * このファイルが存在する場合は、展開されたソース内の ``source/po/ja.po`` から
+    このファイルへの symlink が作成される。

diff --git a/guide/index.rst b/guide/index.rst
index 8650929..3851ebd 100644 (file)
--- a/guide/index.rst
+++ b/guide/index.rst
@@ -8,7 +8,10 @@ Linux JM プロジェクトガイド
 ===========================
 
 `JM ホームページ <http://linuxjm.osdn.jp/>`__ |
-`Git リポジトリ <https://osdn.jp/projects/linuxjm/scm/git/jm/>`__ |
+Git リポジトリ (`JM <https://osdn.jp/projects/linuxjm/scm/git/jm/>`__,
+`LDP <https://osdn.jp/projects/linuxjm/scm/git/LDP_man-pages/>`__,
+`coreutils <https://osdn.jp/projects/linuxjm/scm/git/coreutils/>`__,
+`iptables <https://osdn.jp/projects/linuxjm/scm/git/iptables/>`__) |
 `メーリングリスト <https://osdn.jp/projects/linuxjm/lists/archive/discuss/>`__ |
 `Wiki <https://osdn.jp/projects/linuxjm/wiki/FrontPage>`__