guide: Update LDP manpage update

diff --git a/guide/LDP_man-pages_update.rst b/guide/LDP_man-pages_update.rst
index 1508d30..deaa83e 100644 (file)
--- a/guide/LDP_man-pages_update.rst
+++ b/guide/LDP_man-pages_update.rst
@@ -4,13 +4,7 @@
 LDP man-pages 管理ガイド
 ========================
 
-準備
-====
-
-:ref:`ldp_preparation` を参照してください。
-
-原文の更新方法
-==============
+ここでは、原文の更新方法について説明する。
 
 手順は以下の通り。
 
@@ -19,7 +13,9 @@ LDP man-pages 管理ガイド
 3. 単純な fuzzy の更新
 
 0. 事前準備
------------
+===========
+
+:ref:`ldp_preparation` を参照してください。
 
 Git レポジトリの LDP_man-pages 以下はきれいな状態にした状態で始めること。
 
@@ -30,7 +26,7 @@ Git レポジトリの LDP_man-pages 以下はきれいな状態にした状態
    $ git status
 
 1. po4a 環境の更新
-------------------
+==================
 
 このセクションの操作はすべて ``perkamon`` ディレクトリーで行う。
 ここでは、新しいバージョンの LDP man-pages が po4a で正常に行えることの
@@ -96,6 +92,34 @@ po4a による POT/PO ファイルへの変換の準備が行われる。
    $ make translate
 
 po4a が対応している書式が含まれていてエラーが表示される場合がある。
+その場合は :ref:`po4a-error` を参考にして対処する。
+
+上記の作業が一通り終わったら、再度最初に戻して動作確認を行う。
+
+.. code-block:: console
+
+   $ make clean
+   $ make setup
+   $ make print-new-files
+   $ make disable-removed
+   $ make translate
+
+これで po4a 環境の更新は終了です。
+更新があるはずなので、ここで一度コミットしておくとよい。
+
+.. code-block:: console
+
+   $ git status
+   $ git add ....
+   $ git commit
+   $ cd ..
+
+.. _po4a-error:
+
+po4a で変換エラーが出た場合の対処
+---------------------------------
+
+po4a が対応している書式が含まれていてエラーが表示される場合がある。
 その場合は po4a のマニュアル (``man po4a``) や ``Locale::Po4a::Man``
 (``perldoc Locale::Po4a::Man``) を見て対処方法を検討する。
 
@@ -115,7 +139,6 @@ po4a が対応している書式が含まれていてエラーが表示される
        Unknown macro '.q "TZif"'. Remove it from the document, or refer to the Locale::Po4a::Man manpage to see how po4a can handle new macros.
 
 .. code-block:: ini
-   :name: po4a/time/time.cfg
    :caption: po4a/time/time.cfg
    :emphasize-lines: 3
 
@@ -137,28 +160,8 @@ JM ではコメント行は翻訳していないので、無視してよい。
 
    This file contains the line '.\" autogenerated headers with the name "__NR__llseek" (i.e., "_llseek").'. You should translate the source file, but continuing anyway.
 
-上記の作業が一通り終わったら、再度最初に戻して動作確認を行う。
-
-.. code-block:: console
-
-   $ make clean
-   $ make setup
-   $ make print-new-files
-   $ make disable-removed
-   $ make translate
-
-これで po4a 環境の更新は終了です。
-更新があるはずなので、ここで一度コミットしておくとよい。
-
-.. code-block:: console
-
-   $ git status
-   $ git add ....
-   $ git commit
-   $ cd ..
-
 2. 原文の更新作業
------------------
+=================
 
 ``manual/LDP_man-pages`` で以下のコマンドを実行する。
 
@@ -212,9 +215,9 @@ JM ではコメント行は翻訳していないので、無視してよい。
    .. code-block:: none
 
       git add translation_list
-      git commit -m "LDP: Update original to LDP v3.XX"
+      git commit -m "LDP: Update original to LDP N.MM"
       git add po4a/ stats/ untrans.html
-      git commit -m "LDP: Update POT and ja.po to LDP v3.XX"
+      git commit -m "LDP: Update POT and ja.po to LDP N.MM"
 
 上記の処理が ``make upgrade`` の中で行われる。
 
@@ -236,10 +239,10 @@ COLOPHON 以外でも、翻訳に直接関係ないマイナーな更新があ
 
    $ make
    $ git add -u po4a/ stats/ untrans.html
-   $ git commit -m "LDP: Update the version to 3.XX in PO files"
+   $ git commit -m "LDP: Update the version to N.MM in PO files"
 
    $ git add draft/
-   $ git commit -m "LDP: Update draft pages based on LDP 3.XX release"
+   $ git commit -m "LDP: Update draft pages based on LDP N.MM release"
 
 公開用のリリースページも一気に更新してしまう場合は以下も実行する。
 
@@ -248,10 +251,10 @@ COLOPHON 以外でも、翻訳に直接関係ないマイナーな更新があ
    $ make release
    $ git add release/
    $ git add -u translation_list
-   $ git commit -m "LDP: Update release pages based on LDP 3.XX release"
+   $ git commit -m "LDP: Update release pages based on LDP N.MM release"
 
 perkamon について
------------------
+=================
 
 perkamon は LDP man-pages の po4a への変換を支援するスクリプトです。