[svn-r22721] HDFFV-8133: Add usage text to see Reference manual for compact subsetting.

9 files changed, 162 insertions, 153 deletions

diff --git a/tools/h5dump/h5dump.c b/tools/h5dump/h5dump.c
index 23fd1d9..2921fb9 100644
--- a/tools/h5dump/h5dump.c
+++ b/tools/h5dump/h5dump.c
@@ -233,23 +233,23 @@ usage(const char *prog)
     HDfflush(rawoutstream);
     HDfprintf(rawoutstream, "usage: %s [OPTIONS] files\n", prog);
     HDfprintf(rawoutstream, "  OPTIONS\n");
-    HDfprintf(rawoutstream, "     -h, --help           Print a usage message and exit\n");
-    HDfprintf(rawoutstream, "     -n, --contents       Print a list of the file contents and exit\n");
+    HDfprintf(rawoutstream, "     -h,   --help         Print a usage message and exit\n");
+    HDfprintf(rawoutstream, "     -n,   --contents     Print a list of the file contents and exit\n");
     HDfprintf(rawoutstream, "                          Optional value 1 also prints attributes.\n");
-    HDfprintf(rawoutstream, "     -B, --superblock     Print the content of the super block\n");
-    HDfprintf(rawoutstream, "     -H, --header         Print the header only; no data is displayed\n");
-    HDfprintf(rawoutstream, "     -A, --onlyattr       Print the header and value of attributes\n");
-    HDfprintf(rawoutstream, "     -i, --object-ids     Print the object ids\n");
-    HDfprintf(rawoutstream, "     -r, --string         Print 1-byte integer datasets as ASCII\n");
-    HDfprintf(rawoutstream, "     -e, --escape         Escape non printing characters\n");
-    HDfprintf(rawoutstream, "     -V, --version        Print version number and exit\n");
+    HDfprintf(rawoutstream, "     -B,   --superblock   Print the content of the super block\n");
+    HDfprintf(rawoutstream, "     -H,   --header       Print the header only; no data is displayed\n");
+    HDfprintf(rawoutstream, "     -A,   --onlyattr     Print the header and value of attributes\n");
+    HDfprintf(rawoutstream, "     -i,   --object-ids   Print the object ids\n");
+    HDfprintf(rawoutstream, "     -r,   --string       Print 1-byte integer datasets as ASCII\n");
+    HDfprintf(rawoutstream, "     -e,   --escape       Escape non printing characters\n");
+    HDfprintf(rawoutstream, "     -V,   --version      Print version number and exit\n");
     HDfprintf(rawoutstream, "     -a P, --attribute=P  Print the specified attribute\n");
     HDfprintf(rawoutstream, "                          If an attribute name contains a slash (/), escape the\n");
     HDfprintf(rawoutstream, "                          slash with a preceding backslash (\\).\n");
     HDfprintf(rawoutstream, "                          (See example section below.)\n");
     HDfprintf(rawoutstream, "     -d P, --dataset=P    Print the specified dataset\n");
-    HDfprintf(rawoutstream, "     -y, --noindex        Do not print array indices with the data\n");
-    HDfprintf(rawoutstream, "     -p, --properties     Print dataset filters, storage layout and fill value\n");
+    HDfprintf(rawoutstream, "     -y,   --noindex      Do not print array indices with the data\n");
+    HDfprintf(rawoutstream, "     -p,   --properties   Print dataset filters, storage layout and fill value\n");
     HDfprintf(rawoutstream, "     -f D, --filedriver=D Specify which driver to open the file with\n");
     HDfprintf(rawoutstream, "     -g P, --group=P      Print the specified group and all members\n");
     HDfprintf(rawoutstream, "     -l P, --soft-link=P  Print the value(s) of the specified soft link\n");
@@ -270,17 +270,17 @@ usage(const char *prog)
   "                          the data value and length is the number of bits of\n"
   "                          the mask.\n"
   );
-    HDfprintf(rawoutstream, "     -R, --region         Print dataset pointed by region references\n");
-    HDfprintf(rawoutstream, "     -x, --xml            Output in XML using Schema\n");
-    HDfprintf(rawoutstream, "     -u, --use-dtd        Output in XML using DTD\n");
+    HDfprintf(rawoutstream, "     -R,   --region       Print dataset pointed by region references\n");
+    HDfprintf(rawoutstream, "     -x,   --xml          Output in XML using Schema\n");
+    HDfprintf(rawoutstream, "     -u,   --use-dtd      Output in XML using DTD\n");
     HDfprintf(rawoutstream, "     -D U, --xml-dtd=U    Use the DTD or schema at U\n");
-    HDfprintf(rawoutstream, "     -X S, --xml-ns=S      (XML Schema) Use qualified names n the XML\n");
+    HDfprintf(rawoutstream, "     -X S, --xml-ns=S     (XML Schema) Use qualified names n the XML\n");
     HDfprintf(rawoutstream, "                          \":\": no namespace, default: \"hdf5:\"\n");
     HDfprintf(rawoutstream, "                          E.g., to dump a file called `-f', use h5dump -- -f\n");
     HDfprintf(rawoutstream, "     --enable-error-stack Prints messages from the HDF5 error stack as they\n");
     HDfprintf(rawoutstream, "                          occur.\n");
     HDfprintf(rawoutstream, "     --no-compact-subset  Disable compact form of subsetting and allow the use\n");
-    HDfprintf(rawoutstream, "                          of \"[\" in datset names.\n");
+    HDfprintf(rawoutstream, "                          of \"[\" in dataset names.\n");
     HDfprintf(rawoutstream, "\n");
     HDfprintf(rawoutstream, " Subsetting is available by using the following options with a dataset\n");
     HDfprintf(rawoutstream, " attribute. Subsetting is done by selecting a hyperslab from the data.\n");
@@ -294,7 +294,8 @@ usage(const char *prog)
     HDfprintf(rawoutstream, "      -c COUNT,  --count=COUNT    Number of blocks to include in selection\n");
     HDfprintf(rawoutstream, "      -k BLOCK,  --block=BLOCK    Size of block in hyperslab\n");
     HDfprintf(rawoutstream, "  START, COUNT, STRIDE, and BLOCK - is a list of integers the number of which are equal to the\n");
-    HDfprintf(rawoutstream, "        number of dimensions in the dataspace being queried\n");
+    HDfprintf(rawoutstream, "      number of dimensions in the dataspace being queried\n");
+    HDfprintf(rawoutstream, "      (Alternate compact form of subsetting is described in the Reference Manual)\n");
     HDfprintf(rawoutstream, "\n");
     HDfprintf(rawoutstream, "  D - is the file driver to use in opening the file. Acceptable values\n");
     HDfprintf(rawoutstream, "      are \"sec2\", \"family\", \"split\", \"multi\", \"direct\", and \"stream\". Without\n");
diff --git a/tools/testfiles/h5dump-help.txt b/tools/testfiles/h5dump-help.txt
index 5e0a8f1..74fc104 100644
--- a/tools/testfiles/h5dump-help.txt
+++ b/tools/testfiles/h5dump-help.txt
@@ -1,22 +1,22 @@
 usage: h5dump [OPTIONS] files
   OPTIONS
-     -h, --help           Print a usage message and exit
-     -n, --contents       Print a list of the file contents and exit
+     -h,   --help         Print a usage message and exit
+     -n,   --contents     Print a list of the file contents and exit
                           Optional value 1 also prints attributes.
-     -B, --superblock     Print the content of the super block
-     -H, --header         Print the header only; no data is displayed
-     -A, --onlyattr       Print the header and value of attributes
-     -i, --object-ids     Print the object ids
-     -r, --string         Print 1-byte integer datasets as ASCII
-     -e, --escape         Escape non printing characters
-     -V, --version        Print version number and exit
+     -B,   --superblock   Print the content of the super block
+     -H,   --header       Print the header only; no data is displayed
+     -A,   --onlyattr     Print the header and value of attributes
+     -i,   --object-ids   Print the object ids
+     -r,   --string       Print 1-byte integer datasets as ASCII
+     -e,   --escape       Escape non printing characters
+     -V,   --version      Print version number and exit
      -a P, --attribute=P  Print the specified attribute
                           If an attribute name contains a slash (/), escape the
                           slash with a preceding backslash (\).
                           (See example section below.)
      -d P, --dataset=P    Print the specified dataset
-     -y, --noindex        Do not print array indices with the data
-     -p, --properties     Print dataset filters, storage layout and fill value
+     -y,   --noindex      Do not print array indices with the data
+     -p,   --properties   Print dataset filters, storage layout and fill value
      -f D, --filedriver=D Specify which driver to open the file with
      -g P, --group=P      Print the specified group and all members
      -l P, --soft-link=P  Print the value(s) of the specified soft link
@@ -35,17 +35,17 @@ usage: h5dump [OPTIONS] files
                           separated by commas. Offset is the beginning bit in
                           the data value and length is the number of bits of
                           the mask.
-     -R, --region         Print dataset pointed by region references
-     -x, --xml            Output in XML using Schema
-     -u, --use-dtd        Output in XML using DTD
+     -R,   --region       Print dataset pointed by region references
+     -x,   --xml          Output in XML using Schema
+     -u,   --use-dtd      Output in XML using DTD
      -D U, --xml-dtd=U    Use the DTD or schema at U
-     -X S, --xml-ns=S      (XML Schema) Use qualified names n the XML
+     -X S, --xml-ns=S     (XML Schema) Use qualified names n the XML
                           ":": no namespace, default: "hdf5:"
                           E.g., to dump a file called `-f', use h5dump -- -f
      --enable-error-stack Prints messages from the HDF5 error stack as they
                           occur.
      --no-compact-subset  Disable compact form of subsetting and allow the use
-                          of "[" in datset names.
+                          of "[" in dataset names.
 
  Subsetting is available by using the following options with a dataset
  attribute. Subsetting is done by selecting a hyperslab from the data.
@@ -59,7 +59,8 @@ usage: h5dump [OPTIONS] files
       -c COUNT,  --count=COUNT    Number of blocks to include in selection
       -k BLOCK,  --block=BLOCK    Size of block in hyperslab
   START, COUNT, STRIDE, and BLOCK - is a list of integers the number of which are equal to the
-        number of dimensions in the dataspace being queried
+      number of dimensions in the dataspace being queried
+      (Alternate compact form of subsetting is described in the Reference Manual)
 
   D - is the file driver to use in opening the file. Acceptable values
       are "sec2", "family", "split", "multi", "direct", and "stream". Without
diff --git a/tools/testfiles/tnofilename-with-packed-bits.ddl b/tools/testfiles/tnofilename-with-packed-bits.ddl
index a82c94e..5e6f580 100644
--- a/tools/testfiles/tnofilename-with-packed-bits.ddl
+++ b/tools/testfiles/tnofilename-with-packed-bits.ddl
@@ -1,22 +1,22 @@
 usage: h5dump [OPTIONS] files
   OPTIONS
-     -h, --help           Print a usage message and exit
-     -n, --contents       Print a list of the file contents and exit
+     -h,   --help         Print a usage message and exit
+     -n,   --contents     Print a list of the file contents and exit
                           Optional value 1 also prints attributes.
-     -B, --superblock     Print the content of the super block
-     -H, --header         Print the header only; no data is displayed
-     -A, --onlyattr       Print the header and value of attributes
-     -i, --object-ids     Print the object ids
-     -r, --string         Print 1-byte integer datasets as ASCII
-     -e, --escape         Escape non printing characters
-     -V, --version        Print version number and exit
+     -B,   --superblock   Print the content of the super block
+     -H,   --header       Print the header only; no data is displayed
+     -A,   --onlyattr     Print the header and value of attributes
+     -i,   --object-ids   Print the object ids
+     -r,   --string       Print 1-byte integer datasets as ASCII
+     -e,   --escape       Escape non printing characters
+     -V,   --version      Print version number and exit
      -a P, --attribute=P  Print the specified attribute
                           If an attribute name contains a slash (/), escape the
                           slash with a preceding backslash (\).
                           (See example section below.)
      -d P, --dataset=P    Print the specified dataset
-     -y, --noindex        Do not print array indices with the data
-     -p, --properties     Print dataset filters, storage layout and fill value
+     -y,   --noindex      Do not print array indices with the data
+     -p,   --properties   Print dataset filters, storage layout and fill value
      -f D, --filedriver=D Specify which driver to open the file with
      -g P, --group=P      Print the specified group and all members
      -l P, --soft-link=P  Print the value(s) of the specified soft link
@@ -35,17 +35,17 @@ usage: h5dump [OPTIONS] files
                           separated by commas. Offset is the beginning bit in
                           the data value and length is the number of bits of
                           the mask.
-     -R, --region         Print dataset pointed by region references
-     -x, --xml            Output in XML using Schema
-     -u, --use-dtd        Output in XML using DTD
+     -R,   --region       Print dataset pointed by region references
+     -x,   --xml          Output in XML using Schema
+     -u,   --use-dtd      Output in XML using DTD
      -D U, --xml-dtd=U    Use the DTD or schema at U
-     -X S, --xml-ns=S      (XML Schema) Use qualified names n the XML
+     -X S, --xml-ns=S     (XML Schema) Use qualified names n the XML
                           ":": no namespace, default: "hdf5:"
                           E.g., to dump a file called `-f', use h5dump -- -f
      --enable-error-stack Prints messages from the HDF5 error stack as they
                           occur.
      --no-compact-subset  Disable compact form of subsetting and allow the use
-                          of "[" in datset names.
+                          of "[" in dataset names.
 
  Subsetting is available by using the following options with a dataset
  attribute. Subsetting is done by selecting a hyperslab from the data.
@@ -59,7 +59,8 @@ usage: h5dump [OPTIONS] files
       -c COUNT,  --count=COUNT    Number of blocks to include in selection
       -k BLOCK,  --block=BLOCK    Size of block in hyperslab
   START, COUNT, STRIDE, and BLOCK - is a list of integers the number of which are equal to the
-        number of dimensions in the dataspace being queried
+      number of dimensions in the dataspace being queried
+      (Alternate compact form of subsetting is described in the Reference Manual)
 
   D - is the file driver to use in opening the file. Acceptable values
       are "sec2", "family", "split", "multi", "direct", and "stream". Without
diff --git a/tools/testfiles/tpbitsIncomplete.ddl b/tools/testfiles/tpbitsIncomplete.ddl
index 72d54fc..10b5a23 100644
--- a/tools/testfiles/tpbitsIncomplete.ddl
+++ b/tools/testfiles/tpbitsIncomplete.ddl
@@ -1,22 +1,22 @@
 usage: h5dump [OPTIONS] files
   OPTIONS
-     -h, --help           Print a usage message and exit
-     -n, --contents       Print a list of the file contents and exit
+     -h,   --help         Print a usage message and exit
+     -n,   --contents     Print a list of the file contents and exit
                           Optional value 1 also prints attributes.
-     -B, --superblock     Print the content of the super block
-     -H, --header         Print the header only; no data is displayed
-     -A, --onlyattr       Print the header and value of attributes
-     -i, --object-ids     Print the object ids
-     -r, --string         Print 1-byte integer datasets as ASCII
-     -e, --escape         Escape non printing characters
-     -V, --version        Print version number and exit
+     -B,   --superblock   Print the content of the super block
+     -H,   --header       Print the header only; no data is displayed
+     -A,   --onlyattr     Print the header and value of attributes
+     -i,   --object-ids   Print the object ids
+     -r,   --string       Print 1-byte integer datasets as ASCII
+     -e,   --escape       Escape non printing characters
+     -V,   --version      Print version number and exit
      -a P, --attribute=P  Print the specified attribute
                           If an attribute name contains a slash (/), escape the
                           slash with a preceding backslash (\).
                           (See example section below.)
      -d P, --dataset=P    Print the specified dataset
-     -y, --noindex        Do not print array indices with the data
-     -p, --properties     Print dataset filters, storage layout and fill value
+     -y,   --noindex      Do not print array indices with the data
+     -p,   --properties   Print dataset filters, storage layout and fill value
      -f D, --filedriver=D Specify which driver to open the file with
      -g P, --group=P      Print the specified group and all members
      -l P, --soft-link=P  Print the value(s) of the specified soft link
@@ -35,17 +35,17 @@ usage: h5dump [OPTIONS] files
                           separated by commas. Offset is the beginning bit in
                           the data value and length is the number of bits of
                           the mask.
-     -R, --region         Print dataset pointed by region references
-     -x, --xml            Output in XML using Schema
-     -u, --use-dtd        Output in XML using DTD
+     -R,   --region       Print dataset pointed by region references
+     -x,   --xml          Output in XML using Schema
+     -u,   --use-dtd      Output in XML using DTD
      -D U, --xml-dtd=U    Use the DTD or schema at U
-     -X S, --xml-ns=S      (XML Schema) Use qualified names n the XML
+     -X S, --xml-ns=S     (XML Schema) Use qualified names n the XML
                           ":": no namespace, default: "hdf5:"
                           E.g., to dump a file called `-f', use h5dump -- -f
      --enable-error-stack Prints messages from the HDF5 error stack as they
                           occur.
      --no-compact-subset  Disable compact form of subsetting and allow the use
-                          of "[" in datset names.
+                          of "[" in dataset names.
 
  Subsetting is available by using the following options with a dataset
  attribute. Subsetting is done by selecting a hyperslab from the data.
@@ -59,7 +59,8 @@ usage: h5dump [OPTIONS] files
       -c COUNT,  --count=COUNT    Number of blocks to include in selection
       -k BLOCK,  --block=BLOCK    Size of block in hyperslab
   START, COUNT, STRIDE, and BLOCK - is a list of integers the number of which are equal to the
-        number of dimensions in the dataspace being queried
+      number of dimensions in the dataspace being queried
+      (Alternate compact form of subsetting is described in the Reference Manual)
 
   D - is the file driver to use in opening the file. Acceptable values
       are "sec2", "family", "split", "multi", "direct", and "stream". Without
diff --git a/tools/testfiles/tpbitsLengthExceeded.ddl b/tools/testfiles/tpbitsLengthExceeded.ddl
index d8b627c..17dd963 100644
--- a/tools/testfiles/tpbitsLengthExceeded.ddl
+++ b/tools/testfiles/tpbitsLengthExceeded.ddl
@@ -1,22 +1,22 @@
 usage: h5dump [OPTIONS] files
   OPTIONS
-     -h, --help           Print a usage message and exit
-     -n, --contents       Print a list of the file contents and exit
+     -h,   --help         Print a usage message and exit
+     -n,   --contents     Print a list of the file contents and exit
                           Optional value 1 also prints attributes.
-     -B, --superblock     Print the content of the super block
-     -H, --header         Print the header only; no data is displayed
-     -A, --onlyattr       Print the header and value of attributes
-     -i, --object-ids     Print the object ids
-     -r, --string         Print 1-byte integer datasets as ASCII
-     -e, --escape         Escape non printing characters
-     -V, --version        Print version number and exit
+     -B,   --superblock   Print the content of the super block
+     -H,   --header       Print the header only; no data is displayed
+     -A,   --onlyattr     Print the header and value of attributes
+     -i,   --object-ids   Print the object ids
+     -r,   --string       Print 1-byte integer datasets as ASCII
+     -e,   --escape       Escape non printing characters
+     -V,   --version      Print version number and exit
      -a P, --attribute=P  Print the specified attribute
                           If an attribute name contains a slash (/), escape the
                           slash with a preceding backslash (\).
                           (See example section below.)
      -d P, --dataset=P    Print the specified dataset
-     -y, --noindex        Do not print array indices with the data
-     -p, --properties     Print dataset filters, storage layout and fill value
+     -y,   --noindex      Do not print array indices with the data
+     -p,   --properties   Print dataset filters, storage layout and fill value
      -f D, --filedriver=D Specify which driver to open the file with
      -g P, --group=P      Print the specified group and all members
      -l P, --soft-link=P  Print the value(s) of the specified soft link
@@ -35,17 +35,17 @@ usage: h5dump [OPTIONS] files
                           separated by commas. Offset is the beginning bit in
                           the data value and length is the number of bits of
                           the mask.
-     -R, --region         Print dataset pointed by region references
-     -x, --xml            Output in XML using Schema
-     -u, --use-dtd        Output in XML using DTD
+     -R,   --region       Print dataset pointed by region references
+     -x,   --xml          Output in XML using Schema
+     -u,   --use-dtd      Output in XML using DTD
      -D U, --xml-dtd=U    Use the DTD or schema at U
-     -X S, --xml-ns=S      (XML Schema) Use qualified names n the XML
+     -X S, --xml-ns=S     (XML Schema) Use qualified names n the XML
                           ":": no namespace, default: "hdf5:"
                           E.g., to dump a file called `-f', use h5dump -- -f
      --enable-error-stack Prints messages from the HDF5 error stack as they
                           occur.
      --no-compact-subset  Disable compact form of subsetting and allow the use
-                          of "[" in datset names.
+                          of "[" in dataset names.
 
  Subsetting is available by using the following options with a dataset
  attribute. Subsetting is done by selecting a hyperslab from the data.
@@ -59,7 +59,8 @@ usage: h5dump [OPTIONS] files
       -c COUNT,  --count=COUNT    Number of blocks to include in selection
       -k BLOCK,  --block=BLOCK    Size of block in hyperslab
   START, COUNT, STRIDE, and BLOCK - is a list of integers the number of which are equal to the
-        number of dimensions in the dataspace being queried
+      number of dimensions in the dataspace being queried
+      (Alternate compact form of subsetting is described in the Reference Manual)
 
   D - is the file driver to use in opening the file. Acceptable values
       are "sec2", "family", "split", "multi", "direct", and "stream". Without
diff --git a/tools/testfiles/tpbitsLengthPositive.ddl b/tools/testfiles/tpbitsLengthPositive.ddl
index 39cef23..6d05b47 100644
--- a/tools/testfiles/tpbitsLengthPositive.ddl
+++ b/tools/testfiles/tpbitsLengthPositive.ddl
@@ -1,22 +1,22 @@
 usage: h5dump [OPTIONS] files
   OPTIONS
-     -h, --help           Print a usage message and exit
-     -n, --contents       Print a list of the file contents and exit
+     -h,   --help         Print a usage message and exit
+     -n,   --contents     Print a list of the file contents and exit
                           Optional value 1 also prints attributes.
-     -B, --superblock     Print the content of the super block
-     -H, --header         Print the header only; no data is displayed
-     -A, --onlyattr       Print the header and value of attributes
-     -i, --object-ids     Print the object ids
-     -r, --string         Print 1-byte integer datasets as ASCII
-     -e, --escape         Escape non printing characters
-     -V, --version        Print version number and exit
+     -B,   --superblock   Print the content of the super block
+     -H,   --header       Print the header only; no data is displayed
+     -A,   --onlyattr     Print the header and value of attributes
+     -i,   --object-ids   Print the object ids
+     -r,   --string       Print 1-byte integer datasets as ASCII
+     -e,   --escape       Escape non printing characters
+     -V,   --version      Print version number and exit
      -a P, --attribute=P  Print the specified attribute
                           If an attribute name contains a slash (/), escape the
                           slash with a preceding backslash (\).
                           (See example section below.)
      -d P, --dataset=P    Print the specified dataset
-     -y, --noindex        Do not print array indices with the data
-     -p, --properties     Print dataset filters, storage layout and fill value
+     -y,   --noindex      Do not print array indices with the data
+     -p,   --properties   Print dataset filters, storage layout and fill value
      -f D, --filedriver=D Specify which driver to open the file with
      -g P, --group=P      Print the specified group and all members
      -l P, --soft-link=P  Print the value(s) of the specified soft link
@@ -35,17 +35,17 @@ usage: h5dump [OPTIONS] files
                           separated by commas. Offset is the beginning bit in
                           the data value and length is the number of bits of
                           the mask.
-     -R, --region         Print dataset pointed by region references
-     -x, --xml            Output in XML using Schema
-     -u, --use-dtd        Output in XML using DTD
+     -R,   --region       Print dataset pointed by region references
+     -x,   --xml          Output in XML using Schema
+     -u,   --use-dtd      Output in XML using DTD
      -D U, --xml-dtd=U    Use the DTD or schema at U
-     -X S, --xml-ns=S      (XML Schema) Use qualified names n the XML
+     -X S, --xml-ns=S     (XML Schema) Use qualified names n the XML
                           ":": no namespace, default: "hdf5:"
                           E.g., to dump a file called `-f', use h5dump -- -f
      --enable-error-stack Prints messages from the HDF5 error stack as they
                           occur.
      --no-compact-subset  Disable compact form of subsetting and allow the use
-                          of "[" in datset names.
+                          of "[" in dataset names.
 
  Subsetting is available by using the following options with a dataset
  attribute. Subsetting is done by selecting a hyperslab from the data.
@@ -59,7 +59,8 @@ usage: h5dump [OPTIONS] files
       -c COUNT,  --count=COUNT    Number of blocks to include in selection
       -k BLOCK,  --block=BLOCK    Size of block in hyperslab
   START, COUNT, STRIDE, and BLOCK - is a list of integers the number of which are equal to the
-        number of dimensions in the dataspace being queried
+      number of dimensions in the dataspace being queried
+      (Alternate compact form of subsetting is described in the Reference Manual)
 
   D - is the file driver to use in opening the file. Acceptable values
       are "sec2", "family", "split", "multi", "direct", and "stream". Without
diff --git a/tools/testfiles/tpbitsMaxExceeded.ddl b/tools/testfiles/tpbitsMaxExceeded.ddl
index 5f35825..eca1248 100644
--- a/tools/testfiles/tpbitsMaxExceeded.ddl
+++ b/tools/testfiles/tpbitsMaxExceeded.ddl
@@ -1,22 +1,22 @@
 usage: h5dump [OPTIONS] files
   OPTIONS
-     -h, --help           Print a usage message and exit
-     -n, --contents       Print a list of the file contents and exit
+     -h,   --help         Print a usage message and exit
+     -n,   --contents     Print a list of the file contents and exit
                           Optional value 1 also prints attributes.
-     -B, --superblock     Print the content of the super block
-     -H, --header         Print the header only; no data is displayed
-     -A, --onlyattr       Print the header and value of attributes
-     -i, --object-ids     Print the object ids
-     -r, --string         Print 1-byte integer datasets as ASCII
-     -e, --escape         Escape non printing characters
-     -V, --version        Print version number and exit
+     -B,   --superblock   Print the content of the super block
+     -H,   --header       Print the header only; no data is displayed
+     -A,   --onlyattr     Print the header and value of attributes
+     -i,   --object-ids   Print the object ids
+     -r,   --string       Print 1-byte integer datasets as ASCII
+     -e,   --escape       Escape non printing characters
+     -V,   --version      Print version number and exit
      -a P, --attribute=P  Print the specified attribute
                           If an attribute name contains a slash (/), escape the
                           slash with a preceding backslash (\).
                           (See example section below.)
      -d P, --dataset=P    Print the specified dataset
-     -y, --noindex        Do not print array indices with the data
-     -p, --properties     Print dataset filters, storage layout and fill value
+     -y,   --noindex      Do not print array indices with the data
+     -p,   --properties   Print dataset filters, storage layout and fill value
      -f D, --filedriver=D Specify which driver to open the file with
      -g P, --group=P      Print the specified group and all members
      -l P, --soft-link=P  Print the value(s) of the specified soft link
@@ -35,17 +35,17 @@ usage: h5dump [OPTIONS] files
                           separated by commas. Offset is the beginning bit in
                           the data value and length is the number of bits of
                           the mask.
-     -R, --region         Print dataset pointed by region references
-     -x, --xml            Output in XML using Schema
-     -u, --use-dtd        Output in XML using DTD
+     -R,   --region       Print dataset pointed by region references
+     -x,   --xml          Output in XML using Schema
+     -u,   --use-dtd      Output in XML using DTD
      -D U, --xml-dtd=U    Use the DTD or schema at U
-     -X S, --xml-ns=S      (XML Schema) Use qualified names n the XML
+     -X S, --xml-ns=S     (XML Schema) Use qualified names n the XML
                           ":": no namespace, default: "hdf5:"
                           E.g., to dump a file called `-f', use h5dump -- -f
      --enable-error-stack Prints messages from the HDF5 error stack as they
                           occur.
      --no-compact-subset  Disable compact form of subsetting and allow the use
-                          of "[" in datset names.
+                          of "[" in dataset names.
 
  Subsetting is available by using the following options with a dataset
  attribute. Subsetting is done by selecting a hyperslab from the data.
@@ -59,7 +59,8 @@ usage: h5dump [OPTIONS] files
       -c COUNT,  --count=COUNT    Number of blocks to include in selection
       -k BLOCK,  --block=BLOCK    Size of block in hyperslab
   START, COUNT, STRIDE, and BLOCK - is a list of integers the number of which are equal to the
-        number of dimensions in the dataspace being queried
+      number of dimensions in the dataspace being queried
+      (Alternate compact form of subsetting is described in the Reference Manual)
 
   D - is the file driver to use in opening the file. Acceptable values
       are "sec2", "family", "split", "multi", "direct", and "stream". Without
diff --git a/tools/testfiles/tpbitsOffsetExceeded.ddl b/tools/testfiles/tpbitsOffsetExceeded.ddl
index 92cc816..b0c655d 100644
--- a/tools/testfiles/tpbitsOffsetExceeded.ddl
+++ b/tools/testfiles/tpbitsOffsetExceeded.ddl
@@ -1,22 +1,22 @@
 usage: h5dump [OPTIONS] files
   OPTIONS
-     -h, --help           Print a usage message and exit
-     -n, --contents       Print a list of the file contents and exit
+     -h,   --help         Print a usage message and exit
+     -n,   --contents     Print a list of the file contents and exit
                           Optional value 1 also prints attributes.
-     -B, --superblock     Print the content of the super block
-     -H, --header         Print the header only; no data is displayed
-     -A, --onlyattr       Print the header and value of attributes
-     -i, --object-ids     Print the object ids
-     -r, --string         Print 1-byte integer datasets as ASCII
-     -e, --escape         Escape non printing characters
-     -V, --version        Print version number and exit
+     -B,   --superblock   Print the content of the super block
+     -H,   --header       Print the header only; no data is displayed
+     -A,   --onlyattr     Print the header and value of attributes
+     -i,   --object-ids   Print the object ids
+     -r,   --string       Print 1-byte integer datasets as ASCII
+     -e,   --escape       Escape non printing characters
+     -V,   --version      Print version number and exit
      -a P, --attribute=P  Print the specified attribute
                           If an attribute name contains a slash (/), escape the
                           slash with a preceding backslash (\).
                           (See example section below.)
      -d P, --dataset=P    Print the specified dataset
-     -y, --noindex        Do not print array indices with the data
-     -p, --properties     Print dataset filters, storage layout and fill value
+     -y,   --noindex      Do not print array indices with the data
+     -p,   --properties   Print dataset filters, storage layout and fill value
      -f D, --filedriver=D Specify which driver to open the file with
      -g P, --group=P      Print the specified group and all members
      -l P, --soft-link=P  Print the value(s) of the specified soft link
@@ -35,17 +35,17 @@ usage: h5dump [OPTIONS] files
                           separated by commas. Offset is the beginning bit in
                           the data value and length is the number of bits of
                           the mask.
-     -R, --region         Print dataset pointed by region references
-     -x, --xml            Output in XML using Schema
-     -u, --use-dtd        Output in XML using DTD
+     -R,   --region       Print dataset pointed by region references
+     -x,   --xml          Output in XML using Schema
+     -u,   --use-dtd      Output in XML using DTD
      -D U, --xml-dtd=U    Use the DTD or schema at U
-     -X S, --xml-ns=S      (XML Schema) Use qualified names n the XML
+     -X S, --xml-ns=S     (XML Schema) Use qualified names n the XML
                           ":": no namespace, default: "hdf5:"
                           E.g., to dump a file called `-f', use h5dump -- -f
      --enable-error-stack Prints messages from the HDF5 error stack as they
                           occur.
      --no-compact-subset  Disable compact form of subsetting and allow the use
-                          of "[" in datset names.
+                          of "[" in dataset names.
 
  Subsetting is available by using the following options with a dataset
  attribute. Subsetting is done by selecting a hyperslab from the data.
@@ -59,7 +59,8 @@ usage: h5dump [OPTIONS] files
       -c COUNT,  --count=COUNT    Number of blocks to include in selection
       -k BLOCK,  --block=BLOCK    Size of block in hyperslab
   START, COUNT, STRIDE, and BLOCK - is a list of integers the number of which are equal to the
-        number of dimensions in the dataspace being queried
+      number of dimensions in the dataspace being queried
+      (Alternate compact form of subsetting is described in the Reference Manual)
 
   D - is the file driver to use in opening the file. Acceptable values
       are "sec2", "family", "split", "multi", "direct", and "stream". Without
diff --git a/tools/testfiles/tpbitsOffsetNegative.ddl b/tools/testfiles/tpbitsOffsetNegative.ddl
index c318834..213641b 100644
--- a/tools/testfiles/tpbitsOffsetNegative.ddl
+++ b/tools/testfiles/tpbitsOffsetNegative.ddl
@@ -1,22 +1,22 @@
 usage: h5dump [OPTIONS] files
   OPTIONS
-     -h, --help           Print a usage message and exit
-     -n, --contents       Print a list of the file contents and exit
+     -h,   --help         Print a usage message and exit
+     -n,   --contents     Print a list of the file contents and exit
                           Optional value 1 also prints attributes.
-     -B, --superblock     Print the content of the super block
-     -H, --header         Print the header only; no data is displayed
-     -A, --onlyattr       Print the header and value of attributes
-     -i, --object-ids     Print the object ids
-     -r, --string         Print 1-byte integer datasets as ASCII
-     -e, --escape         Escape non printing characters
-     -V, --version        Print version number and exit
+     -B,   --superblock   Print the content of the super block
+     -H,   --header       Print the header only; no data is displayed
+     -A,   --onlyattr     Print the header and value of attributes
+     -i,   --object-ids   Print the object ids
+     -r,   --string       Print 1-byte integer datasets as ASCII
+     -e,   --escape       Escape non printing characters
+     -V,   --version      Print version number and exit
      -a P, --attribute=P  Print the specified attribute
                           If an attribute name contains a slash (/), escape the
                           slash with a preceding backslash (\).
                           (See example section below.)
      -d P, --dataset=P    Print the specified dataset
-     -y, --noindex        Do not print array indices with the data
-     -p, --properties     Print dataset filters, storage layout and fill value
+     -y,   --noindex      Do not print array indices with the data
+     -p,   --properties   Print dataset filters, storage layout and fill value
      -f D, --filedriver=D Specify which driver to open the file with
      -g P, --group=P      Print the specified group and all members
      -l P, --soft-link=P  Print the value(s) of the specified soft link
@@ -35,17 +35,17 @@ usage: h5dump [OPTIONS] files
                           separated by commas. Offset is the beginning bit in
                           the data value and length is the number of bits of
                           the mask.
-     -R, --region         Print dataset pointed by region references
-     -x, --xml            Output in XML using Schema
-     -u, --use-dtd        Output in XML using DTD
+     -R,   --region       Print dataset pointed by region references
+     -x,   --xml          Output in XML using Schema
+     -u,   --use-dtd      Output in XML using DTD
      -D U, --xml-dtd=U    Use the DTD or schema at U
-     -X S, --xml-ns=S      (XML Schema) Use qualified names n the XML
+     -X S, --xml-ns=S     (XML Schema) Use qualified names n the XML
                           ":": no namespace, default: "hdf5:"
                           E.g., to dump a file called `-f', use h5dump -- -f
      --enable-error-stack Prints messages from the HDF5 error stack as they
                           occur.
      --no-compact-subset  Disable compact form of subsetting and allow the use
-                          of "[" in datset names.
+                          of "[" in dataset names.
 
  Subsetting is available by using the following options with a dataset
  attribute. Subsetting is done by selecting a hyperslab from the data.
@@ -59,7 +59,8 @@ usage: h5dump [OPTIONS] files
       -c COUNT,  --count=COUNT    Number of blocks to include in selection
       -k BLOCK,  --block=BLOCK    Size of block in hyperslab
   START, COUNT, STRIDE, and BLOCK - is a list of integers the number of which are equal to the
-        number of dimensions in the dataspace being queried
+      number of dimensions in the dataspace being queried
+      (Alternate compact form of subsetting is described in the Reference Manual)
 
   D - is the file driver to use in opening the file. Acceptable values
       are "sec2", "family", "split", "multi", "direct", and "stream". Without