summaryrefslogtreecommitdiffstats
path: root/tools/h5diff
diff options
context:
space:
mode:
authorPedro Vicente Nunes <pvn@hdfgroup.org>2007-11-19 19:38:34 (GMT)
committerPedro Vicente Nunes <pvn@hdfgroup.org>2007-11-19 19:38:34 (GMT)
commit78898b38c0c8e33a6b9f3af95a7d706ae8c54dcd (patch)
tree981d95ee00ec3b4c0a5d0f3c9a86e99e6d8bac48 /tools/h5diff
parentf0e99ad5d034d7a453b77d37e7a8495ab2f3cc23 (diff)
downloadhdf5-78898b38c0c8e33a6b9f3af95a7d706ae8c54dcd.zip
hdf5-78898b38c0c8e33a6b9f3af95a7d706ae8c54dcd.tar.gz
hdf5-78898b38c0c8e33a6b9f3af95a7d706ae8c54dcd.tar.bz2
[svn-r14267] enhancement: formatted h5diff usage
tested: linux
Diffstat (limited to 'tools/h5diff')
-rw-r--r--tools/h5diff/h5diff_common.c48
-rw-r--r--tools/h5diff/h5diff_main.c4
2 files changed, 31 insertions, 21 deletions
diff --git a/tools/h5diff/h5diff_common.c b/tools/h5diff/h5diff_common.c
index 569cd00..802cc37 100644
--- a/tools/h5diff/h5diff_common.c
+++ b/tools/h5diff/h5diff_common.c
@@ -567,36 +567,46 @@ void usage(void)
printf("\n");
- printf("h5diff has four modes of output:\n");
- printf(" Normal mode: print the number of differences found and where they occured\n");
- printf(" Report mode: print the above plus the differences\n");
- printf(" Verbose mode: print the above plus a list of objects and warnings\n");
- printf(" Quiet mode: do not print output (h5diff always returns an exit code of 1 when differences are found)\n");
+ printf(" Modes of output:\n");
printf("\n");
- printf("Examples of use:\n");
+ printf(" Default mode: print the number of differences found and where they occured\n");
+ printf(" -r Report mode: print the above plus the differences\n");
+ printf(" -v Verbose mode: print the above plus a list of objects and warnings\n");
+ printf(" -q Quiet mode: do not print output\n");
+
printf("\n");
- printf("1) h5diff file1 file2 /g1/dset1 /g1/dset2\n");
+
+ printf(" Return exit code:\n");
printf("\n");
- printf(" Compares object '/g1/dset1' in file1 with '/g1/dset2' in file2\n");
+ printf(" 1 if differences found, 0 if no differences, -1 if error\n");
+
printf("\n");
- printf("2) h5diff file1 file2 /g1/dset1\n");
+
+ printf(" Examples of use:\n");
printf("\n");
- printf(" Compares object '/g1/dset1' in both files\n");
+ printf(" 1) h5diff file1 file2 /g1/dset1 /g1/dset2\n");
printf("\n");
- printf("3) h5diff file1 file2\n");
+ printf(" Compares object '/g1/dset1' in file1 with '/g1/dset2' in file2\n");
printf("\n");
- printf(" Compares all objects in both files\n");
+ printf(" 2) h5diff file1 file2 /g1/dset1\n");
printf("\n");
- printf("Note) file1 and file2 can be the same file. Use\n");
+ printf(" Compares object '/g1/dset1' in both files\n");
printf("\n");
- printf(" h5diff file1 file1 /g1/dset1 /g1/dset2\n");
+ printf(" 3) h5diff file1 file2\n");
printf("\n");
- printf(" to compare '/g1/dset1' and '/g1/dset2' in the same file\n");
+ printf(" Compares all objects in both files\n");
printf("\n");
- printf("If no objects are specified, h5diff only compares objects with the same ");
- printf("absolute path in both files. The compare criteria is: ");
- printf("1) datasets: numerical array differences 2) groups: name string difference ");
- printf("3) datatypes: the return value of H5Tequal 2) links: name string difference of the linked value\n");
+ printf(" Note) file1 and file2 can be the same file. Use\n");
+ printf("\n");
+ printf(" h5diff file1 file1 /g1/dset1 /g1/dset2\n");
+ printf("\n");
+ printf(" to compare '/g1/dset1' and '/g1/dset2' in the same file\n");
+ printf("\n");
+ printf(" If no objects [obj1[obj2]] are specified, h5diff only compares objects\n");
+ printf(" with the same absolute path in both files. The compare criteria is:\n");
+ printf(" 1) datasets: numerical array differences 2) groups: name string difference\n");
+ printf(" 3) datatypes: the return value of H5Tequal 2) links: name string difference\n");
+ printf(" of the linked value\n");
}
diff --git a/tools/h5diff/h5diff_main.c b/tools/h5diff/h5diff_main.c
index e7795c6..06d4d11 100644
--- a/tools/h5diff/h5diff_main.c
+++ b/tools/h5diff/h5diff_main.c
@@ -79,9 +79,9 @@ int main(int argc, const char *argv[])
print_info(&options);
- /*-------------------------------------------------------------------------
+ /*-------------------------------------------------------------------------
* exit code
- * >0 if differences, 0 if no differences, <0 if error
+ * 1 if differences, 0 if no differences, -1 if error
*-------------------------------------------------------------------------
*/