[rt46602] Fix various typos, formatting issues and stylistic nits

bin/tests/system/Makefile.in

@@ -50,7 +50,7 @@ PARALLEL = allow_query catz rpzrecurse serve-stale
 
 # Produce intermediate makefile that assigns unique port numbers to each
 # parallel test.  The start port number of 5,000 is arbitrary - it must just
-# be greated that the highest privileged port, 1024.
+# be greater than the highest privileged port, 1024.
 
 parallel.mk:
 	@echo ".PHONY: $(PARALLEL)" > $@ ; \

bin/tests/system/README

@@ -103,7 +103,7 @@ Optional flags are:
 
     -r              The "runall" flag.  This is related to cleaning up after
                     the tests (see "Maintenance Notes" below).  If specified,
-                    if prevents a copy of the test's output listing from being
+                    it prevents a copy of the test's output listing from being
                     deleted when the directory is cleaned up after the test
                     completes.  (The test's output listing comprises messages
                     produced by the test during its execution; it does not
@@ -257,11 +257,11 @@ Deletion of files produced by an individual test can be done with the command:
 
     sh clean.sh [-r] <test-name>
 
-The optional flag is"
+The optional flag is:
 
     -r              The "runall" flag.  This is related to cleaning up after
                     the tests (see "Maintenance Notes" below).  If specified,
-                    if prevents a copy of the test's output listing from being
+                    it prevents a copy of the test's output listing from being
                     deleted when the directory is cleaned after the test
                     completes.
 
@@ -303,16 +303,16 @@ tests.sh    Runs the actual tests.  This file is mandatory.
 
 clean.sh    Run at the end to clean up temporary files, but only if the test
             was completed successfully and its running was not inhibited by the
-            "-n" switch being passed to "run.sh". Otherwise the temporary files
+	    "-n" switch being passed to "run.sh".  Otherwise the temporary
-            are left in place for inspection.
+	    files are left in place for inspection.
 
 ns<N>       These subdirectories contain test name servers that can be queried
-            or can interact with each other. the value of N indicates the
+	    or can interact with each other.  The value of N indicates the
 	    address the server listens on: for example, ns2 listens on
 	    10.53.0.2, and ns4 on 10.53.0.4.  All test servers use an
-            unprivileged port, so they don't need to run as root. These servers
+	    unprivileged port, so they don't need to run as root.  These
-            log at the highest debug level and the log is captured in the file
+	    servers log at the highest debug level and the log is captured in
-            "named.run".
+	    the file "named.run".
 
 ans<N>      Like ns[X], but these are simple mock name servers implemented in
             Perl or Python.  They are generally programmed to misbehave in ways
@@ -328,7 +328,7 @@ environment variables that the scripts listed above can reference.
 
 The convention used in the system tests is that the number passed is the start
 of a range of 100 ports.  The test is free to use the ports as required,
-although the first ten ports in the block named and generally tests use the
+although the first ten ports in the block are named and generally tests use the
 named ports for their intended purpose.  The names of the environment variables
 are:
 
@@ -383,7 +383,7 @@ name of the test is passed to each script.  For example, the command:
 
 ... will run "mytest" with a port range of 12300 to 12399.  Each of the
 framework scripts provided by the test will be invoked using the remaining
-arguments, e.g.
+arguments, e.g.:
 
    (cd mytest ; sh prereq.sh -D xyz)
    (cd mytest ; sh setup.sh -D xyz)
@@ -432,9 +432,9 @@ port numbers.
 
 To do this, configuration files should be supplied in the form of templates
 containing tokens identifying ports.  The tokens have the same name as the
-shell variables listed above, but in upper-case and prefixed and suffixed by
+environment variables listed above, but are prefixed and suffixed by the "@"
-the "@" symbol.  For example, a fragment of a configuration file template might
+symbol.  For example, a fragment of a configuration file template might look
-look like:
+like:
 
     controls {
         inet 10.53.0.1 port @CONTROLPORT@ allow { any; } keys { rndc_key; };
@@ -454,8 +454,9 @@ setup.sh should copy the template to the desired filename using the
     copy_setports ns1/named.conf.in ns1/named.conf
 
 This replaces the tokens @PORT@, @CONTROLPORT@, @EXTRAPORT1@ through
-@EXTRAPORT8@ with the contents of the shell variables listed above.  setup.sh
+@EXTRAPORT8@ with the contents of the environment variables listed above.
-should do this for all configuration files required when the test starts.
+setup.sh should do this for all configuration files required when the test
+starts.
 
 ("setup.sh" should also use this method for replacing the tokens in any Perl or
 Python name servers used in the test.)
@@ -470,7 +471,7 @@ similar to the following for each sub-test:
     1. n=`expr $n + 1`
     2. echo_i "prime cache nodata.example ($n)"
     3. ret=0
-    4. $DIG -p $PORT @10.53.0.1 nodata.example TXT > dig.out.test$n
+    4. $DIG -p ${PORT} @10.53.0.1 nodata.example TXT > dig.out.test$n
     5. grep "status: NOERROR" dig.out.test$n > /dev/null || ret=1
     6. grep "ANSWER: 0," dig.out.test$n > /dev/null || ret=1
     7. if [ $ret != 0 ]; then echo_i "failed"; fi
@@ -482,14 +483,14 @@ similar to the following for each sub-test:
 2.  Indicate that the sub-test is about to begin.  Note that "echo_i" instead
     of "echo" is used.  echo_i is a function defined in "conf.sh" which will
     prefix the message with "I:<testname>:", so allowing the output from each
-    test to be identified within the output. The test number is included in the
+    test to be identified within the output.  The test number is included in
-    message in order to tie the sub-test with its output.
+    the message in order to tie the sub-test with its output.
 
 3. Initialize return status.
 
 4 - 6. Carry out the sub-test.  In this case, a nameserver is queried (note
     that the port used is given by the PORT environment variable, which was set
-    by the inclusion the file "conf.sh" at the start of the script).  The
+    by the inclusion of the file "conf.sh" at the start of the script).  The
     output is routed to a file whose suffix includes the test number.  The
     response from the server is examined and, in this case, if the required
     string is not found, an error is indicated by setting "ret" to 1.
@@ -538,9 +539,9 @@ For the former, the version of "named" being run is that in the "bin/named"
 directory in the tree holding the tests (i.e. if "make test" is being run
 immediately after "make", the version of "named" used is that just built).  The
 configuration files, zone files etc. for these servers are located in
-subdirectories named of the test directory "nsN", where N is a small integer.
+subdirectories of the test directory named "nsN", where N is a small integer.
 The latter are special nameservers, mostly used for generating deliberately bad
-responses, are located in subdirectories named "ansN" (again, N is an integer).
+responses, located in subdirectories named "ansN" (again, N is an integer).
 In addition to configuration files, these directories should hold the
 appropriate script files as well.
 
@@ -549,10 +550,10 @@ there is an "ns2" directory, there cannot be an "ans2" directory as well.
 Ideally, the directory numbers should start at 1 and work upwards.
 
 When running a test, the servers are started using "start.sh" (which is nothing
-more than a wrapper for start.pl.)  The options for "start.pl" are documented
+more than a wrapper for start.pl).  The options for "start.pl" are documented
 in the header for that file, so will not be repeated here.  In summary, when
 invoked by "run.sh", start.pl looks for directories named "nsN" or "ansN" in
-the test directory and starts the server it finds there.
+the test directory and starts the servers it finds there.
 
 
 "named" Command-Line Options
@@ -583,13 +584,13 @@ By default, start.pl starts a "named" server with the following options:
 
 In addition, start.pl also sets the following undocumented flag:
 
-    -T clientest    Makes clients single-shot with their own memory context.
+    -T clienttest   Makes clients single-shot with their own memory context.
 
-All output is sent to a file called "named.run" in the namserver
+All output is sent to a file called "named.run" in the nameserver directory.
-directory.
 
 The options used to start named can be altered.  There are three ways of doing
-this.  "start.pl" checks the methods in a specific order: if a check succeeds, the options are set and any other specification is ignored.  In order these
+this.  "start.pl" checks the methods in a specific order: if a check succeeds,
+the options are set and any other specification is ignored.  In order, these
 are:
 
 1. Specifying options to "start.sh"/"start.pl" after the name of the test
@@ -599,35 +600,35 @@ directory, e.g.
 
 (This is only really useful when running tests interactively.)
 
-2. Including a file called "named.args" in the "nsN" directory. If present, the
+2. Including a file called "named.args" in the "nsN" directory.  If present,
-contents of the first line of the file are used as the named command-line
+the contents of the first non-commented, non-blank line of the file are used as
-arguments.  The rest of the file is ignored.
+the named command-line arguments.  The rest of the file is ignored.
 
 3. Tweaking the default command line arguments with "-T" options.  This flag is
 used to alter the behavior of BIND for testing and is not documented in the
-ARM.  The "clientest" option has already been mentioned, but the presence of
+ARM.  The "clienttest" option has already been mentioned, but the presence of
 certain files in the "nsN" directory adds flags to the default command line
 (the content of the files is irrelevant - it is only the presence that counts):
 
-    named.noaa      Appends "-T noaa", which causes "named" to never set the AA
+    named.noaa       Appends "-T noaa" to the command line, which causes
-                    bit in an answer.
+                     "named" to never set the AA bit in an answer.
 
     named.dropedns   Adds "-T dropedns" to the command line, which causes
                      "named" to recognise EDNS options in messages, but drop
                      messages containing them.
 
     named.maxudp1460 Adds "-T maxudp1460" to the command line, setting the
-                     maxium UDP size handled by named to 1460.
+                     maximum UDP size handled by named to 1460.
 
     named.maxudp512  Adds "-T maxudp512" to the command line, setting the
-                    maxium UDP size handled by named to 512.
+                     maximum UDP size handled by named to 512.
 
-    named.noedns    Appends "-T noedns", which disables recognition of EDNS
+    named.noedns     Appends "-T noedns" to the command line, which disables
-                    options in messages.
+                     recognition of EDNS options in messages.
 
     named.notcp      Adds "-T notcp", which disables TCP in "named".
 
-    named.soa       Appends "-T nosoa" to the command line.  This disables
+    named.soa        Appends "-T nosoa" to the command line, which disables
                      the addition of SOA records to negative responses (or to
                      the additional section if the response is triggered by RPZ
                      rewriting).
@@ -642,8 +643,8 @@ else.
 
 (This is not strictly true: Python servers are provided with the number of the
 query port to use.  Altering the port used by Perl servers currently requires
-creating a template file containing the "@PORT@" construct, and having
+creating a template file containing the "@PORT@" token, and having "setup.sh"
-"setup.sh" substitute the actual port being used before the test starts.)
+substitute the actual port being used before the test starts.)
 
 
 Stopping Nameservers
@@ -748,7 +749,7 @@ this reason, "clean.sh" cannot delete "test.output" as, if the test is
 being run as part of a test suite, the file must be retained.
 
 2. If the deletion of "test.output" were to be solely the responsibility of
-"testsummnary.sh", should a test suite terminate abnormally, cleaning up a test
+"testsummary.sh", should a test suite terminate abnormally, cleaning up a test
 directory with "sh clean.sh <test-directory>" would leave the file present.
 
 3. An additional step could be added to "cleanall.sh" (which calls the
@@ -762,5 +763,5 @@ To get round this, the system's "clean.sh" script takes an optional flag, "-r"
 is passed the runall flag.  In turn, "run.sh" passes the flag to "clean.sh",
 which causes that script not to delete the "tests.output" file.  In other
 words, when the system's "clean.sh" is invoked standalone on a test directory
-(or as past of a run of "cleanall.sh"), it will delete the "test.output" if it
+(or as part of a run of "cleanall.sh"), it will delete the "test.output" if it
 is present.  When invoked during a run of the entire test suite, it won't.

bin/tests/system/conf.sh.in

@@ -239,7 +239,7 @@ nextpart () {
 
 # copy_setports - Copy Configuration File and Replace Ports
 #
-# Convenience function to copy a configuration file, replacing the symbols
+# Convenience function to copy a configuration file, replacing the tokens
 # QUERYPORT, CONTROLPORT and EXTRAPORT[1-8] with the values of the equivalent
 # environment variables. (These values are set by "run.sh", which calls the
 # scripts invoking this function.)

bin/tests/system/runall.sh

@@ -14,7 +14,7 @@
 #   -n          Noclean.  Keep all output files produced by all tests.  These
 #               can later be removed by running "cleanall.sh".
 #
-#   numprocess  Number of simultaneous processes to use when running the tests.
+#   numprocess  Number of concurrent processes to use when running the tests.
 #               The default is one, which causes the tests to run sequentially.
 
 SYSTEMTESTTOP=.
@@ -32,7 +32,7 @@ shift `expr $OPTIND - 1`
 if [ $# -eq 0 ]; then
     numproc=1
 elif [ $# -eq 1 ]; then
-    test "$1" -eq "$1" > /dev/null 2>& 1
+    test "$1" -eq "$1" > /dev/null 2>&1
     if [ $? -ne 0 ]; then
         # Value passed is not numeric
         echo "$usage" >&2

bin/tests/system/stop.pl

@@ -18,7 +18,7 @@ use Cwd 'abs_path';
 use Getopt::Long;
 
 # Usage:
-#   perl stop.pl [-use-rndc [--port port]] test [server]
+#   perl stop.pl [--use-rndc [--port port]] test [server]
 #
 #   --use-rndc      Attempt to stop the server via the "rndc stop" command.
 #