LDP: Do not execute git2upd in 'make upgrade'

It turns out that git2upd does not work expectedly in the recent
version of git status. As a quick look at git2upd, it needs to be
fixed carefully. As a temporary workaround, git2upd and subsequent
commands in "make upgrade" are not executed automatically. They
need to be run manually.

The JM guide is updated accordingly.

diff --git a/guide/GNU_coreutils_update.rst b/guide/GNU_coreutils_update.rst
index 870e714..b14c14c 100644 (file)
--- a/guide/GNU_coreutils_update.rst
+++ b/guide/GNU_coreutils_update.rst
@@ -43,6 +43,12 @@ git で add/remove を行う。
 
    ../../admin/upd_tl.perl translation_list upd.txt VERSION
 
+.. warning::
+
+   git のバージョンによっては ``git2upd`` が期待通り動作しない場合がある。
+   :doc:`upstream_update` の ``git2upd`` に関する注意を参照し、
+   必要な場合は ``git status`` の出力を加工すること。
+
 (4) help2man.ja の更新
 ----------------------
 

diff --git a/guide/LDP_man-pages_update.rst b/guide/LDP_man-pages_update.rst
index b06fc14..f6b4522 100644 (file)
--- a/guide/LDP_man-pages_update.rst
+++ b/guide/LDP_man-pages_update.rst
@@ -179,14 +179,16 @@ JM ではコメント行は翻訳していないので、無視してよい。
 
 2. 新しい原文を ``original`` 以下にコピーする。
 
-3. ``original`` 以ä¸\8bã\81®å\8e\9fæ\96\87ã\81\8bã\82\89 COLOPHON 以ä¸\8bã\82\92å\89\8aé\99¤する。
+3. ``original`` 以ä¸\8bã\82\92 git ã\81§ stage する。
 
-   ``translation_list`` を更新する際に、変更点のみを抽出するために行う。
-   COLOPHON 部分はリリース毎にバージョン番号が更新されてしまうので、
-   ``original`` に登録する際には、この節を削除しておく。
+.. warning::
 
-4. ``original`` 以下を git で stage する。
-5. ``translation_list`` の更新
+   git のバージョンによっては ``git2upd`` が期待通り動作しない場合があるため、
+   以下の 4. 以降は現在 Makefile でコメントアウトしている。
+   :doc:`upstream_update` の ``git2upd`` に関する注意を考慮した上で、
+   以下を手動で実行すること。
+
+4. ``translation_list`` の更新
 
    LDP man-pages の翻訳は、翻訳が完了していない状態でも英語混じりで公開する
    ことにしていて、かつ翻訳の進捗状況は ``untrans.html`` で確認できるので、
@@ -194,14 +196,14 @@ JM ではコメント行は翻訳していないので、無視してよい。
    更新するだけになっている。バージョン番号はページ公開時に参照されるので
    更新が必要。この点は他のマニュアルと異なるので注意。
 
-6. POT/PO の更新
+5. POT/PO の更新
 
    ``po4a/<category>/po/`` 以下の ``<category>.pot`` (POT ファイル) と
    ``ja.po`` が更新される。
 
-7. 翻訳統計情報の更新
+6. 翻訳統計情報の更新
 
-8. Git commit
+7. Git commit
 
    この段階のコミットにより、とりあえず原文更新直後の状態が
    一度コミットされることになる。

diff --git a/guide/upstream_update.rst b/guide/upstream_update.rst
index f627300..6080507 100644 (file)
--- a/guide/upstream_update.rst
+++ b/guide/upstream_update.rst
@@ -27,6 +27,36 @@ roff を直接翻訳
 * admin/git2upd
 * admin/upd_tl.perl
 
+.. warning::
+
+   ``git2upd`` コマンドは新しい git status の出力に対応していないので注意。
+
+   ``git2upd`` コマンドは、 ``git add`` コマンドで staged された原文を
+   ``git status`` コマンドの出力に基づいて ``upd_tl.perl`` に渡すファイルを
+   作成するが、以下のように staged されたファイルリストの前に空行があることを
+   期待している。しかし、新しめの git ではこの空行が出力されないため、
+   ``git2upd`` コマンドが期待通り動作しない。本来は ``git2upd`` コマンドを修正
+   すべきだが、とりあえずの対処としては ``git status original`` の出力を保存
+   した上で、必要な空行を挿入して対処する。
+   (少なくとも git 2.25.1 では空行が出力されないことを確認している。)
+
+   .. code-block:: console
+
+      HEAD detached at 015f61e7
+      Changes to be committed:
+       (use "git restore --staged <file>..." to unstage)
+
+             modified:   original/Changes
+             modified:   original/Changes.old
+             modified:   original/README
+             renamed:    original/man-pages-3.79.Announce -> original/man-pages-5.10.Announce
+             renamed:    original/man-pages-3.79.lsm -> original/man-pages-5.10.lsm
+             modified:   original/man1/getent.1
+             modified:   original/man1/iconv.1
+             ...
+
+
+
 po4a を使って翻訳
 =================
 

diff --git a/manual/LDP_man-pages/Makefile b/manual/LDP_man-pages/Makefile
index d242991..7bd282c 100644 (file)
--- a/manual/LDP_man-pages/Makefile
+++ b/manual/LDP_man-pages/Makefile
@@ -159,19 +159,16 @@ upgrade:
        cd man-pages \
          && ../../../admin/JM-orig-upd.sh ../original \
          && cp README man-pages-* Changes* ../original
-       cd original \
-         sed -e 's/\^\\\.SH /^\\.S[Hh] /' ../man-pages/scripts/remove_COLOPHON.sh \
-         sh ../man-pages/scripts/remove_COLOPHON.sh man?/*.[1-8]
        git add --all original/
-       git status original | ../../admin/git2upd > upd.txt
-       ../../admin/upd_tl.perl translation_list upd.txt $(V)
-       mv translation_list.* translation_list
-       $(MAKE) FLAGS="--no-translations -v --force" translate-pages
-       $(MAKE) update-stats
-       git add translation_list
-       git commit -m "LDP: Update original to LDP v$(V)" original/ translation_list
-       git add po4a/ stats/ untrans.html
-       git commit -m "LDP: Update POT and ja.po to LDP v$(V)" po4a/ stats/ untrans.html
+       #git status original | ../../admin/git2upd > upd.txt
+       #../../admin/upd_tl.perl translation_list upd.txt $(V)
+       #mv translation_list.* translation_list
+       #$(MAKE) FLAGS="--no-translations -v --force" translate-pages
+       #$(MAKE) update-stats
+       #git add translation_list
+       #git commit -m "LDP: Update original to LDP v$(V)" original/ translation_list
+       #git add po4a/ stats/ untrans.html
+       #git commit -m "LDP: Update POT and ja.po to LDP v$(V)" po4a/ stats/ untrans.html
 
 disable-removed:
        @set -e; for f in po4a/*/*.cfg; do \