[svn-r20350] Purpose:

Fixed CHICAGO: Bug 2121 - h5diff - incorrect and lack of output for the 
    different set of attributes (different number and names)

Description:
    Merged from HDF5 trunk r20334.
    This is related to previous checkin r20299.
    Add help page update for verbose option level feature, which displays 
    useful information about attribute difference with -v1, --verbose=1 -v2 
    or --verbose=2 option.

     
Tested:
 jam (linux32-LE), amani (linux64-LE), heiwa (linuxppc64-BE)

release_docs/RELEASE.txt

@@ -82,6 +82,10 @@ New Features
  
     Tools
     -----
+     - h5diff: Added new level for -v (verbose) option. The new levels are
+               1 and 2.  So -v1 and -v2 can be specified to view more 
+               information about attributes differences. 
+               Bug#2121 (JKM 2011/3/23)
      - h5dump: Added new option --enable-error-stack. This option will display 
                error stack information in the output stream. This is useful
                when the "h5dump: Unable to print data" message is output.

tools/h5diff/h5diff_common.c

@@ -433,7 +433,16 @@ void usage(void)
  printf("   -h, --help              Print a usage message and exit.\n");
  printf("   -V, --version           Print version number and exit.\n");
  printf("   -r, --report            Report mode. Print differences.\n");
- printf("   -v, --verbose           Verbose mode. Print differences, list of objects.\n");
+ printf("   -v --verbose            Verbose mode. Print differences information and list\n");
+ printf("                           of objects.\n");
+ printf("   -vN --verbose=N         Verbose mode with level. Print differences and list\n");
+ printf("                           of objects.\n");
+ printf("                           Level of detail depends on value of N:\n");
+ printf("                            0 : Identical to '-v' or '--verbose'.\n");
+ printf("                            1 : All level 0 information plus one-line attribute\n");
+ printf("                                status summary.\n");
+ printf("                            2 : All level 1 information plus extended attribute\n");
+ printf("                                status report.\n");
  printf("   -q, --quiet             Quiet mode. Do not produce output.\n");
  printf("   --follow-symlinks       Follow symbolic links (soft links and external links)\n");
  printf("                           and compare the links' target objects.\n");

tools/h5diff/testfiles/h5diff_10.txt

@@ -8,7 +8,16 @@ usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
    -h, --help              Print a usage message and exit.
    -V, --version           Print version number and exit.
    -r, --report            Report mode. Print differences.
-   -v, --verbose           Verbose mode. Print differences, list of objects.
+   -v --verbose            Verbose mode. Print differences information and list
+                           of objects.
+   -vN --verbose=N         Verbose mode with level. Print differences and list
+                           of objects.
+                           Level of detail depends on value of N:
+                            0 : Identical to '-v' or '--verbose'.
+                            1 : All level 0 information plus one-line attribute
+                                status summary.
+                            2 : All level 1 information plus extended attribute
+                                status report.
    -q, --quiet             Quiet mode. Do not produce output.
    --follow-symlinks       Follow symbolic links (soft links and external links)
                            and compare the links' target objects.

tools/h5diff/testfiles/h5diff_600.txt

@@ -8,7 +8,16 @@ usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
    -h, --help              Print a usage message and exit.
    -V, --version           Print version number and exit.
    -r, --report            Report mode. Print differences.
-   -v, --verbose           Verbose mode. Print differences, list of objects.
+   -v --verbose            Verbose mode. Print differences information and list
+                           of objects.
+   -vN --verbose=N         Verbose mode with level. Print differences and list
+                           of objects.
+                           Level of detail depends on value of N:
+                            0 : Identical to '-v' or '--verbose'.
+                            1 : All level 0 information plus one-line attribute
+                                status summary.
+                            2 : All level 1 information plus extended attribute
+                                status report.
    -q, --quiet             Quiet mode. Do not produce output.
    --follow-symlinks       Follow symbolic links (soft links and external links)
                            and compare the links' target objects.

tools/h5diff/testfiles/h5diff_603.txt

@@ -9,7 +9,16 @@ usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
    -h, --help              Print a usage message and exit.
    -V, --version           Print version number and exit.
    -r, --report            Report mode. Print differences.
-   -v, --verbose           Verbose mode. Print differences, list of objects.
+   -v --verbose            Verbose mode. Print differences information and list
+                           of objects.
+   -vN --verbose=N         Verbose mode with level. Print differences and list
+                           of objects.
+                           Level of detail depends on value of N:
+                            0 : Identical to '-v' or '--verbose'.
+                            1 : All level 0 information plus one-line attribute
+                                status summary.
+                            2 : All level 1 information plus extended attribute
+                                status report.
    -q, --quiet             Quiet mode. Do not produce output.
    --follow-symlinks       Follow symbolic links (soft links and external links)
                            and compare the links' target objects.

tools/h5diff/testfiles/h5diff_606.txt

@@ -9,7 +9,16 @@ usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
    -h, --help              Print a usage message and exit.
    -V, --version           Print version number and exit.
    -r, --report            Report mode. Print differences.
-   -v, --verbose           Verbose mode. Print differences, list of objects.
+   -v --verbose            Verbose mode. Print differences information and list
+                           of objects.
+   -vN --verbose=N         Verbose mode with level. Print differences and list
+                           of objects.
+                           Level of detail depends on value of N:
+                            0 : Identical to '-v' or '--verbose'.
+                            1 : All level 0 information plus one-line attribute
+                                status summary.
+                            2 : All level 1 information plus extended attribute
+                                status report.
    -q, --quiet             Quiet mode. Do not produce output.
    --follow-symlinks       Follow symbolic links (soft links and external links)
                            and compare the links' target objects.

tools/h5diff/testfiles/h5diff_612.txt

@@ -9,7 +9,16 @@ usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
    -h, --help              Print a usage message and exit.
    -V, --version           Print version number and exit.
    -r, --report            Report mode. Print differences.
-   -v, --verbose           Verbose mode. Print differences, list of objects.
+   -v --verbose            Verbose mode. Print differences information and list
+                           of objects.
+   -vN --verbose=N         Verbose mode with level. Print differences and list
+                           of objects.
+                           Level of detail depends on value of N:
+                            0 : Identical to '-v' or '--verbose'.
+                            1 : All level 0 information plus one-line attribute
+                                status summary.
+                            2 : All level 1 information plus extended attribute
+                                status report.
    -q, --quiet             Quiet mode. Do not produce output.
    --follow-symlinks       Follow symbolic links (soft links and external links)
                            and compare the links' target objects.

tools/h5diff/testfiles/h5diff_615.txt

@@ -9,7 +9,16 @@ usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
    -h, --help              Print a usage message and exit.
    -V, --version           Print version number and exit.
    -r, --report            Report mode. Print differences.
-   -v, --verbose           Verbose mode. Print differences, list of objects.
+   -v --verbose            Verbose mode. Print differences information and list
+                           of objects.
+   -vN --verbose=N         Verbose mode with level. Print differences and list
+                           of objects.
+                           Level of detail depends on value of N:
+                            0 : Identical to '-v' or '--verbose'.
+                            1 : All level 0 information plus one-line attribute
+                                status summary.
+                            2 : All level 1 information plus extended attribute
+                                status report.
    -q, --quiet             Quiet mode. Do not produce output.
    --follow-symlinks       Follow symbolic links (soft links and external links)
                            and compare the links' target objects.

tools/h5diff/testfiles/h5diff_621.txt

@@ -9,7 +9,16 @@ usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
    -h, --help              Print a usage message and exit.
    -V, --version           Print version number and exit.
    -r, --report            Report mode. Print differences.
-   -v, --verbose           Verbose mode. Print differences, list of objects.
+   -v --verbose            Verbose mode. Print differences information and list
+                           of objects.
+   -vN --verbose=N         Verbose mode with level. Print differences and list
+                           of objects.
+                           Level of detail depends on value of N:
+                            0 : Identical to '-v' or '--verbose'.
+                            1 : All level 0 information plus one-line attribute
+                                status summary.
+                            2 : All level 1 information plus extended attribute
+                                status report.
    -q, --quiet             Quiet mode. Do not produce output.
    --follow-symlinks       Follow symbolic links (soft links and external links)
                            and compare the links' target objects.

tools/h5diff/testfiles/h5diff_622.txt

@@ -9,7 +9,16 @@ usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
    -h, --help              Print a usage message and exit.
    -V, --version           Print version number and exit.
    -r, --report            Report mode. Print differences.
-   -v, --verbose           Verbose mode. Print differences, list of objects.
+   -v --verbose            Verbose mode. Print differences information and list
+                           of objects.
+   -vN --verbose=N         Verbose mode with level. Print differences and list
+                           of objects.
+                           Level of detail depends on value of N:
+                            0 : Identical to '-v' or '--verbose'.
+                            1 : All level 0 information plus one-line attribute
+                                status summary.
+                            2 : All level 1 information plus extended attribute
+                                status report.
    -q, --quiet             Quiet mode. Do not produce output.
    --follow-symlinks       Follow symbolic links (soft links and external links)
                            and compare the links' target objects.

tools/h5diff/testfiles/h5diff_623.txt

@@ -9,7 +9,16 @@ usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
    -h, --help              Print a usage message and exit.
    -V, --version           Print version number and exit.
    -r, --report            Report mode. Print differences.
-   -v, --verbose           Verbose mode. Print differences, list of objects.
+   -v --verbose            Verbose mode. Print differences information and list
+                           of objects.
+   -vN --verbose=N         Verbose mode with level. Print differences and list
+                           of objects.
+                           Level of detail depends on value of N:
+                            0 : Identical to '-v' or '--verbose'.
+                            1 : All level 0 information plus one-line attribute
+                                status summary.
+                            2 : All level 1 information plus extended attribute
+                                status report.
    -q, --quiet             Quiet mode. Do not produce output.
    --follow-symlinks       Follow symbolic links (soft links and external links)
                            and compare the links' target objects.

tools/h5diff/testfiles/h5diff_624.txt

@@ -9,7 +9,16 @@ usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
    -h, --help              Print a usage message and exit.
    -V, --version           Print version number and exit.
    -r, --report            Report mode. Print differences.
-   -v, --verbose           Verbose mode. Print differences, list of objects.
+   -v --verbose            Verbose mode. Print differences information and list
+                           of objects.
+   -vN --verbose=N         Verbose mode with level. Print differences and list
+                           of objects.
+                           Level of detail depends on value of N:
+                            0 : Identical to '-v' or '--verbose'.
+                            1 : All level 0 information plus one-line attribute
+                                status summary.
+                            2 : All level 1 information plus extended attribute
+                                status report.
    -q, --quiet             Quiet mode. Do not produce output.
    --follow-symlinks       Follow symbolic links (soft links and external links)
                            and compare the links' target objects.