Rearranged leading comments. Added explicit references to original report messages wherever available.

tests/append.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Append was just not working.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Problem: Append was just not working.
+
 . ./preset
 . $srcdir/before
 

tests/delete01.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Deleting a member after a big one was destroying the archive.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Deleting a member after a big one was destroying the archive.
+
 . ./preset
 . $srcdir/before
 

tests/delete02.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Deleting a member with the archive from stdin was not working correctly.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Deleting a member with the archive from stdin was not working correctly.
+
 . ./preset
 . $srcdir/before
 

tests/delete03.sh

@@ -1,6 +1,4 @@
 #! /bin/sh
-# Deleting members with long file names.
-
 # Copyright (C) 2001 Free Software Foundation, Inc.
 #
 # This program is free software; you can redistribute it and/or modify

tests/delete04.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Deleting a large last member was destroying earlier members.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Deleting a large last member was destroying earlier members.
+
 . ./preset
 . $srcdir/before
 

tests/extrac01.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# There was a diagnostic when directory already exists.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# There was a diagnostic when directory already exists.
+
 . ./preset
 . $srcdir/before
 

tests/extrac02.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Could not extract symlinks over an existing file.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Could not extract symlinks over an existing file.
+
 . ./preset
 . $srcdir/before
 

tests/extrac03.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Paths going up and down were inducing extraction loops.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Paths going up and down were inducing extraction loops.
+
 . ./preset
 . $srcdir/before
 

tests/extrac04.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Check for fnmatch problems in glibc 2.1.95.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Check for fnmatch problems in glibc 2.1.95.
+
 . ./preset
 . $srcdir/before
 

tests/gzip.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# tar should detect that its gzip child failed.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# tar should detect that its gzip child failed.
+
 . ./preset
 TAR_ARCHIVE_FORMATS=auto
 . $srcdir/before

tests/ignfail.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Unreadable directories yielded error despite --ignore-failed-read.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Unreadable directories yielded error despite --ignore-failed-read.
+
 . ./preset
 . $srcdir/before
 

tests/incremen.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# A directory older than the listed entry was skipped completely.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# A directory older than the listed entry was skipped completely.
+
 . ./preset
 TAR_ARCHIVE_FORMATS="gnu oldgnu"
 . $srcdir/before

tests/link01.sh

@@ -17,14 +17,17 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
-# If a member with link count > 2 was stored in the archive twice,
+# Problem: If a member with link count > 2 was stored in the archive twice,
 # previous versions of tar were not able to extract it, since they
 # were trying to link the file to itself, which always failed and
 # lead to removing the already extracted copy. This script tests
 # the workaround by Paul Eggert that leaves the extracted copy
 # untouched.
-
-# The script is based on the report by Toby Peterson <toby@apple.com>
+#
+# Reported by: Toby Peterson <toby@apple.com>
+#
+# References: <2330D503-D20A-11D8-A0CF-00039391EECE@apple.com>
+# http://lists.gnu.org/archive/html/bug-tar/2004-07/msg00009.html
 
 . ./preset
 . $srcdir/before
@@ -48,4 +51,4 @@ out="test.txt
 
 . $srcdir/after
 
-# End of link01.sh
+# End of link01.sh

tests/listed01.sh

@@ -1,8 +1,4 @@
 #! /bin/sh
-
-# Check if listed-incremental backups work for individual files.
-# Script proposed by Andreas Schuldei <andreas@schuldei.org>
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -21,6 +17,11 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Check if listed-incremental backups work for individual files.
+# Script proposed by Andreas Schuldei <andreas@schuldei.org>
+# References: <20040215014223.GA9699@lukas.schuldei.com>
+# http://lists.gnu.org/archive/html/bug-tar/2004-02/msg00011.html
+
 . ./preset
 TAR_ARCHIVE_FORMATS="gnu oldgnu" 
 . $srcdir/before

tests/longv7.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-# Old format (V7) archives should not accept file names longer than
-# 99 characters
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,9 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Old format (V7) archives should not accept file names longer than
+# 99 characters
+
 . ./preset
 TAR_ARCHIVE_FORMATS="v7" 
 . $srcdir/before

tests/multiv01.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Test multivolume dumps from pipes.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Test multivolume dumps from pipes.
+
 . ./preset
 TAR_ARCHIVE_FORMATS="gnu oldgnu"
 . $srcdir/before

tests/multiv02.sh

@@ -1,9 +1,4 @@
 #! /bin/sh
-
-# Previous versions of tar were not able to skip a member straddling
-# the multivolume archive boundary. Reported by Mads Martin Joergensen
-# <mmj@suse.de>
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -22,6 +17,13 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Previous versions of tar were not able to skip a member straddling
+# the multivolume archive boundary. Reported by Mads Martin Joergensen
+# <mmj@suse.de>
+# 
+# References: <20040402144254.GC4409@suse.de> 
+# http://lists.gnu.org/archive/html/bug-tar/2004-04/msg00002.html
+
 . ./preset
 TAR_ARCHIVE_FORMATS="gnu oldgnu"
 . $srcdir/before
@@ -40,4 +42,4 @@ separator
 en
 "
 
-. $srcdir/after
+. $srcdir/after

tests/old.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# An old archive was not receiving directories.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# An old archive was not receiving directories.
+
 . ./preset
 TAR_ARCHIVE_FORMATS=auto
 . $srcdir/before

tests/options.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Ensure that TAR_OPTIONS works in conjunction with old-style options.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Ensure that TAR_OPTIONS works in conjunction with old-style options.
+
 . ./preset
 TAR_ARCHIVE_FORMATS=auto
 . $srcdir/before

tests/recurse.sh

@@ -1,5 +1,4 @@
 #! /bin/sh
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #

tests/same-order01.sh

@@ -1,8 +1,4 @@
 #! /bin/sh
-
-# -C dir did not work with --same-order
-# Bug reported by Karl-Michael Schneider <schneide@phil.uni-passau.de>
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -21,6 +17,11 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Problem: -C dir did not work with --same-order
+# Reported by: Karl-Michael Schneider <schneide@phil.uni-passau.de>
+# References: <20040507122613.GB12457@pike.phil.uni-passau.de>
+# http://lists.gnu.org/archive/html/bug-tar/2004-05/msg00008.html
+
 . ./preset
 . $srcdir/before
 

tests/same-order02.sh

@@ -1,9 +1,4 @@
 #! /bin/sh
-
-# In previous versions a single -C option did not work with --same-order
-# (see same-order01.sh). However, multiple -C options worked OK. 
-# Test if we did not break the correct behavior.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -22,6 +17,10 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# In previous versions a single -C option did not work with --same-order
+# (see same-order01.sh). However, multiple -C options worked OK. 
+# Test if we did not break the correct behavior.
+
 . ./preset
 . $srcdir/before
 

tests/sparse01.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Check sparse file handling.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Check sparse file handling.
+
 . ./preset
 TAR_ARCHIVE_FORMATS="gnu oldgnu posix"
 . $srcdir/before

tests/version.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Check if the proper version is being tested.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Check if the proper version is being tested.
+
 . ./preset
 
 if test -n "`$PACKAGE --version | sed -n s/$PACKAGE.*$VERSION/OK/p`"; then

tests/volume.sh

@@ -1,7 +1,4 @@
 #! /bin/sh
-
-# Volume labels are checked on read by fnmatch.
-
 # This file is part of GNU tar testsuite.
 # Copyright (C) 2004 Free Software Foundation, Inc.
 #
@@ -20,6 +17,8 @@
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 # 02111-1307, USA.
 
+# Volume labels are checked on read by fnmatch.
+
 . ./preset
 TAR_ARCHIVE_FORMATS="gnu oldgnu"
 . $srcdir/before