From 8d59a9baeeb6cbce7d5b7f6b0915327cec903788 Mon Sep 17 00:00:00 2001
From: Akihiro Motoki <amotoki@gmail.com>
Date: Thu, 25 Mar 2021 10:26:31 +0900
Subject: [PATCH] iptables: Update README

Also ensure to show translation stats ("make stats")
in the alphabetical order.
---
 manual/iptables/Makefile   |  2 +-
 manual/iptables/README.JM  | 36 --------------------
 manual/iptables/README.rst | 82 ++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 83 insertions(+), 37 deletions(-)
 delete mode 100644 manual/iptables/README.JM
 create mode 100644 manual/iptables/README.rst

diff --git a/manual/iptables/Makefile b/manual/iptables/Makefile
index 5ca83e38..bbb6eac2 100644
--- a/manual/iptables/Makefile
+++ b/manual/iptables/Makefile
@@ -6,7 +6,7 @@ MASTER_CMD = $(wildcard original/man[^23]/*.[1-8])
 MASTER_LIB = $(wildcard original/man[23]/*.[1-8])
 MASTER_ROFFS = $(MASTER_CMD) $(MASTER_LIB)
 TRANS_ROFFS = $(patsubst original/%,draft/%,$(MASTER_ROFFS))
-POFILES = $(wildcard po4a/*/*.ja.po)
+POFILES = $(sort $(wildcard po4a/*/*.ja.po))
 POTFILES = $(wildcard po4a/*/*.pot)
 MSGMERGE_OPTS = --no-wrap --no-location
 
diff --git a/manual/iptables/README.JM b/manual/iptables/README.JM
deleted file mode 100644
index 88b8a139..00000000
--- a/manual/iptables/README.JM
+++ /dev/null
@@ -1,36 +0,0 @@
-= Notes when updating the original =
-
-Netfilter project
-http://www.netfilter.org/projects/iptables/index.html
-http://www.netfilter.org/projects/iptables/downloads.html
-
-tar xvf iptables-1.4.18.tar.bz2
-cd iptables-1.4.18/
-./configure
-make
-
-ls -1 **/*.[1-8]
-ls -1 **/*.[1-8].in
-
-@ iptables top directory
-
-find original -type f | xargs rm
-
-@ source directory
-
-cp **/*.1 ../../original/man1/
-cp **/*.3 ../../original/man3/
-cp **/*.8 ../../original/man8/
-
-@ iptables top directory
-
-grep -r @PACKAGE_VERSION@ original/
-sed -i -e 's/@PACKAGE_AND_VERSION@/1.4.21/' original/man8/iptables.8
-patch -p3 < patch.original
-
-git add -u
-git add original
-
-git status . | ../../admin/git2upd > upd.txt
-sed -i -e 's|0000/00/00|2013/03/03|' upd.txt
-../../admin/upd_tl.perl translation_list upd.txt 1.4.18
diff --git a/manual/iptables/README.rst b/manual/iptables/README.rst
new file mode 100644
index 00000000..b9bff001
--- /dev/null
+++ b/manual/iptables/README.rst
@@ -0,0 +1,82 @@
+# Netfilter project
+
+* http://www.netfilter.org/projects/iptables/index.html
+* http://www.netfilter.org/projects/iptables/downloads.html
+
+# original 更新時のメモ
+
+## man pages の生成
+
+configure や make の中で man が準備されるので make まで行う。
+configure のオプションで man の内容が変化するかは確認していないが、
+念のため configure の出力で "Iptables Configuration" で
+全部が "yes" になるようにしている。
+
+::
+
+  tar xf iptables-1.8.4.tar.bz2
+  cd iptables-1.8.4
+  ./configure --enable-bpf-compiler --enable-libipq --enable-nfsynproxy
+  make
+
+生成された man の確認。
+
+::
+
+  ls -1 **/*.[1-8]
+
+## original の更新
+
+ここからは iptables のトップディレクトリに移動して作業する。
+やっていることとしては、 original 以下のファイルを全部削除してから、
+新しいバージョンの man をコピーする。
+iptables-1.8.4 時点では man1/man3/man8 だけだが、
+他のセクションも追加されていれば、適宜コピーする。
+
+::
+
+  cd ..
+  find original -type f | xargs rm
+  cp iptables-1.8.4/**/*.1 original/man1
+  cp iptables-1.8.4/**/*.3 original/man3
+  cp iptables-1.8.4/**/*.8 original/man8
+
+変更内容を git で stage しておく。
+
+::
+
+   git add original
+
+ここで po4a 変換の動作確認を行っておく。
+
+::
+
+   make updatepo
+
+エラーが出た場合は、エラー箇所を確認し、
+必要に応じて original 以下の該当ファイルを変更する、
+po4a のオプションを追加するなどの対応を行う。
+
+original 以下に変更を行った場合は、
+変更内容を `patch.original` として保存しておく。
+
+::
+
+   git diff -- original > patch.original
+
+## 変更内容の translation\_list への反映
+
+`translation_list` の更新を行う。
+更新があった original 以下の変更を git で stage した上で
+以下のコマンドを実行する。
+最初のコマンドの実行後に `upd.txt` の内容を確認しておくとよい。
+
+::
+
+   git status . | ../../admin/git2upd > upd.txt
+   sed -i -e 's|0000/00/00|2021/03/24|' upd.txt
+   ../../admin/upd_tl.perl translation_list upd.txt 1.8.4
+
+## git への登録
+
+最後に変更内容をすべて git に commit する。
-- 
2.11.0