[svn-r19492] Purpose:

Update help page for exclude-path feature.

Description:
 Merged from hdf5 trunk (r19491).
 Related to "1890:  h5diff excluding object for file comparison via command line" checkins. (r19406)

Tested:
 jam, linew
This commit is contained in:
Jonathan Kim
2010-09-29 10:45:11 -05:00
parent 24e0792396
commit c88c65c130
11 changed files with 264 additions and 0 deletions

View File

@@ -63,6 +63,30 @@ usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
comparing floating point values.
By default, strict equality is used. Use -p or -d to
set specific tolerance.
--exclude-path "path" Exclude the specified path to an object when
comparing files or groups. If a group is excluded,
all member objects will also be excluded.
The specified path is excluded wherever it occurs.
This flexibility enables the same option to exclude
either objects that exist only in one file or
common objects that are known to differ.
When comparing files, "path" is the absolute path to
the excluded object; when comparing groups, "path" is
similar to the relative path from the group to the
excluded object. This "path" can be taken from the
first section of the output of the --verbose option.
For example, if you are comparing the group /groupA
in two files and you want to exclude
/groupA/groupB/groupC in both files, the exclude
option would read as follows:
--exclude-path "/groupB/groupC"
If there are multiple paths to an object, only the
specified path(s) will be excluded; the comparison
will include any path not explicitly excluded.
This option can be used repeatedly to exclude
multiple paths.
Modes of output:
Default mode: print the number of differences found and where they occured