Comments about the purpose of each test.

32 files changed, 66 insertions, 26 deletions

diff --git a/gettext-tools/tests/msgcat-2 b/gettext-tools/tests/msgcat-2
index 527d29b..84af857 100755
--- a/gettext-tools/tests/msgcat-2
+++ b/gettext-tools/tests/msgcat-2
@@ -1,10 +1,10 @@
 #! /bin/sh
 
+# Test handling of input files with different charsets.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
-# input files with different charsets.
-
 tmpfiles="$tmpfiles mcat-test2.in1 mcat-test2.in2"
 cat <<\EOF > mcat-test2.in1
 # German message file for xyz.
diff --git a/gettext-tools/tests/msgcat-3 b/gettext-tools/tests/msgcat-3
index 0f07e52..591b1c7 100755
--- a/gettext-tools/tests/msgcat-3
+++ b/gettext-tools/tests/msgcat-3
@@ -1,11 +1,11 @@
 #! /bin/sh
 
+# Test handling of input files with different charsets.
+# 1. ISO-8859-1, 2. UTF-8; plus --use-first
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
-# input files with different charsets.
-# 1. ISO-8859-1, 2. UTF-8; plus --use-first
-
 tmpfiles="$tmpfiles mcat-test3.in1 mcat-test3.in2"
 cat <<\EOF > mcat-test3.in1
 # German message file for xyz.
diff --git a/gettext-tools/tests/msgcat-4 b/gettext-tools/tests/msgcat-4
index 4cf95a8..9536b28 100755
--- a/gettext-tools/tests/msgcat-4
+++ b/gettext-tools/tests/msgcat-4
@@ -1,11 +1,11 @@
 #! /bin/sh
 
+# Test handling of input files with different charsets:
+# 1. UTF-8, 2. ISO-8859-1; plus --use-first
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
-# input files with different charsets:
-# 1. UTF-8, 2. ISO-8859-1; plus --use-first
-
 tmpfiles="$tmpfiles mcat-test4.in1 mcat-test4.in2"
 cat <<\EOF > mcat-test4.in1
 # German message file for xyz.
diff --git a/gettext-tools/tests/msgcat-5 b/gettext-tools/tests/msgcat-5
index 4676f8a..3432503 100755
--- a/gettext-tools/tests/msgcat-5
+++ b/gettext-tools/tests/msgcat-5
@@ -1,11 +1,11 @@
 #! /bin/sh
 
+# Test handling of input files with different translations:
+# try --use-first
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
-# input files with different translations:
-# try --use-first
-
 tmpfiles="$tmpfiles mcat-test5.in1 mcat-test5.in2"
 cat <<\EOF > mcat-test5.in1
 # German message file for xyz.
diff --git a/gettext-tools/tests/msgcat-6 b/gettext-tools/tests/msgcat-6
index 0720501..06100a6 100755
--- a/gettext-tools/tests/msgcat-6
+++ b/gettext-tools/tests/msgcat-6
@@ -1,11 +1,11 @@
 #! /bin/sh
 
+# Test handling of input files with different translations:
+# preserve all variants, add markers
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
-# input files with different translations:
-# preserve all variants, add markers
-
 tmpfiles="$tmpfiles mcat-test6.in1 mcat-test6.in2"
 cat <<\EOF > mcat-test6.in1
 # German message file for xyz.
diff --git a/gettext-tools/tests/msgcmp-1 b/gettext-tools/tests/msgcmp-1
index 08168b1..dd78137 100755
--- a/gettext-tools/tests/msgcmp-1
+++ b/gettext-tools/tests/msgcmp-1
@@ -1,6 +1,6 @@
 #! /bin/sh
-# One argument is required which is the path to the toplevel directory
-# of the distribution.
+
+# Test a succeeding comparison.
 
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
diff --git a/gettext-tools/tests/msgcmp-2 b/gettext-tools/tests/msgcmp-2
index 2f333f1..e03bf36 100755
--- a/gettext-tools/tests/msgcmp-2
+++ b/gettext-tools/tests/msgcmp-2
@@ -1,6 +1,6 @@
 #! /bin/sh
-# One argument is required which is the path to the toplevel directory
-# of the distribution.
+
+# Test a failing comparison.
 
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
diff --git a/gettext-tools/tests/msgcomm-16 b/gettext-tools/tests/msgcomm-16
index 2cd8ac6..3457e53 100755
--- a/gettext-tools/tests/msgcomm-16
+++ b/gettext-tools/tests/msgcomm-16
@@ -1,10 +1,10 @@
 #! /bin/sh
 
+# Test handling of input files with different charsets.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
-# input files with different charsets.
-
 tmpfiles="$tmpfiles mcomm-test16.in1 mcomm-test16.in2"
 cat <<\EOF > mcomm-test16.in1
 # German message file for xyz.
diff --git a/gettext-tools/tests/msgcomm-22 b/gettext-tools/tests/msgcomm-22
index a2a58c1..5d29600 100755
--- a/gettext-tools/tests/msgcomm-22
+++ b/gettext-tools/tests/msgcomm-22
@@ -1,10 +1,10 @@
 #! /bin/sh
 
+# Verify that the header entry is kept, otherwise the encoding is unknown.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
-# keep header file entry, otherwise the encoding is unknown
-
 tmpfiles="$tmpfiles mcomm-test22.in1 mcomm-test22.in2"
 cat <<\EOF > mcomm-test22.in1
 # German translations for GNU gettext package.
diff --git a/gettext-tools/tests/msgen-1 b/gettext-tools/tests/msgen-1
index acd8f6c..cf4993c 100755
--- a/gettext-tools/tests/msgen-1
+++ b/gettext-tools/tests/msgen-1
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test general operation.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/msgfmt-1 b/gettext-tools/tests/msgfmt-1
index 3b8face..0dc6315 100755
--- a/gettext-tools/tests/msgfmt-1
+++ b/gettext-tools/tests/msgfmt-1
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test basic functionality, duplicate detection, multiple domains.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/msgfmt-2 b/gettext-tools/tests/msgfmt-2
index 5695835..8491178 100755
--- a/gettext-tools/tests/msgfmt-2
+++ b/gettext-tools/tests/msgfmt-2
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test basic functionality, duplicate detection, multiple domains.
+
 if (echo "testing\c"; echo 1,2,3) | grep c >/dev/null; then
   # Stardent Vistra SVR4 grep lacks -e, says ghazi@caip.rutgers.edu.
   if (echo -n testing; echo 1,2,3) | sed s/-n/xn/ | grep xn >/dev/null; then
diff --git a/gettext-tools/tests/msgfmt-3 b/gettext-tools/tests/msgfmt-3
index b0b2ed7..264a4f8 100755
--- a/gettext-tools/tests/msgfmt-3
+++ b/gettext-tools/tests/msgfmt-3
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test than an empty header entry is OK.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/msgfmt-4 b/gettext-tools/tests/msgfmt-4
index d649b5c..f833ed9 100755
--- a/gettext-tools/tests/msgfmt-4
+++ b/gettext-tools/tests/msgfmt-4
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test c-format handling.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/msgmerge-1 b/gettext-tools/tests/msgmerge-1
index d33abbc..66eb374 100755
--- a/gettext-tools/tests/msgmerge-1
+++ b/gettext-tools/tests/msgmerge-1
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test general operation and line wrapping.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/msgmerge-2 b/gettext-tools/tests/msgmerge-2
index 8c880db..9580df5 100755
--- a/gettext-tools/tests/msgmerge-2
+++ b/gettext-tools/tests/msgmerge-2
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test recognition of duplicates.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/msgmerge-3 b/gettext-tools/tests/msgmerge-3
index 6b5b4cc..4ca85c2 100755
--- a/gettext-tools/tests/msgmerge-3
+++ b/gettext-tools/tests/msgmerge-3
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test handling of obsolete/untranslated messages.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/msgmerge-4 b/gettext-tools/tests/msgmerge-4
index 42a046a..d9cc1e8 100755
--- a/gettext-tools/tests/msgmerge-4
+++ b/gettext-tools/tests/msgmerge-4
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test handling of comments.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/msgmerge-5 b/gettext-tools/tests/msgmerge-5
index bc9f931..d7ed4d6 100755
--- a/gettext-tools/tests/msgmerge-5
+++ b/gettext-tools/tests/msgmerge-5
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test handling of header entry.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/msgunfmt-1 b/gettext-tools/tests/msgunfmt-1
index 8ef4b35..a707dd8 100755
--- a/gettext-tools/tests/msgunfmt-1
+++ b/gettext-tools/tests/msgunfmt-1
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test of general operation.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/msguniq-1 b/gettext-tools/tests/msguniq-1
index 17be1a0..4570ce3 100755
--- a/gettext-tools/tests/msguniq-1
+++ b/gettext-tools/tests/msguniq-1
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test general operation.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/msguniq-2 b/gettext-tools/tests/msguniq-2
index 5b4a9cd..b80c988 100755
--- a/gettext-tools/tests/msguniq-2
+++ b/gettext-tools/tests/msguniq-2
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test --unique option.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/msguniq-3 b/gettext-tools/tests/msguniq-3
index 8b4a562..ef6cbb4 100755
--- a/gettext-tools/tests/msguniq-3
+++ b/gettext-tools/tests/msguniq-3
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test --repeated option.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/xgettext-1 b/gettext-tools/tests/xgettext-1
index c071004..a3470db 100755
--- a/gettext-tools/tests/xgettext-1
+++ b/gettext-tools/tests/xgettext-1
@@ -2,8 +2,7 @@
 
 # This test often fails during development. It works after "make dist".
 
-# One argument is required which is the path to the toplevel directory
-# of the distribution.
+# Test C support.
 
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
diff --git a/gettext-tools/tests/xgettext-2 b/gettext-tools/tests/xgettext-2
index b071455..d33f579 100755
--- a/gettext-tools/tests/xgettext-2
+++ b/gettext-tools/tests/xgettext-2
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test C support: comments meant for xgettext, and whitespace.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/xgettext-3 b/gettext-tools/tests/xgettext-3
index 9452151..c468770 100755
--- a/gettext-tools/tests/xgettext-3
+++ b/gettext-tools/tests/xgettext-3
@@ -2,8 +2,7 @@
 
 # This test often fails during development. It works after "make dist".
 
-# One argument is required which is the path to the toplevel directory
-# of the distribution.
+# Test -x option.
 
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
diff --git a/gettext-tools/tests/xgettext-4 b/gettext-tools/tests/xgettext-4
index 166a2de..80cfb2c 100755
--- a/gettext-tools/tests/xgettext-4
+++ b/gettext-tools/tests/xgettext-4
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test C support: recognition of #line.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/xgettext-5 b/gettext-tools/tests/xgettext-5
index 830e9cd..36f6dc6 100755
--- a/gettext-tools/tests/xgettext-5
+++ b/gettext-tools/tests/xgettext-5
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test C support: --trigraphs option.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/xgettext-6 b/gettext-tools/tests/xgettext-6
index 209ab10..16a7a3a 100755
--- a/gettext-tools/tests/xgettext-6
+++ b/gettext-tools/tests/xgettext-6
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test C support: comments.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/xgettext-7 b/gettext-tools/tests/xgettext-7
index a5a5b34..362bf5e 100755
--- a/gettext-tools/tests/xgettext-7
+++ b/gettext-tools/tests/xgettext-7
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test C support: --add-comments option.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/xgettext-8 b/gettext-tools/tests/xgettext-8
index b3e7a7f..837832a 100755
--- a/gettext-tools/tests/xgettext-8
+++ b/gettext-tools/tests/xgettext-8
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test C, C++, PO extractors.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15
 
diff --git a/gettext-tools/tests/xgettext-9 b/gettext-tools/tests/xgettext-9
index 5a23f2e..2f7082b 100755
--- a/gettext-tools/tests/xgettext-9
+++ b/gettext-tools/tests/xgettext-9
@@ -1,5 +1,7 @@
 #! /bin/sh
 
+# Test C support: comments.
+
 tmpfiles=""
 trap 'rm -fr $tmpfiles' 1 2 3 15