NAME
wdsdiff - report the differences between two data service versions
VERSION
1.0
SYNOPSIS
wdsdiff [options] [file1] [file2]
--help -h brief help message
--man -m full documentation
--version show version
--diff=section [,section...]
ds report differences in the formats, vocabularies, etc.
dirs report differences in nodes that have sub-nodes
pages report differences in the non-operation nodes
ops report differences in the operation nodes
nodes report differences in all nodes
params report differences in the parameters of each node
blocks report differences in the output blocks of each node
fields report differences in the output fields of each node
all report all differences
--vocab=<vocab> restrict the report to the specified vocabulary
-v <vocab>
--node=<pattern> restrict the report to nodes matching the specified pattern
-n <pattern>
--specials include special parameters, which are excluded by default
DESCRIPTION
This command analyzes the specified input files, which should contain digests in YAML format generated by running a Web::DataService web application with the 'diag' parameter. You must specify exactly two input filenames.
The primary purpose of this command is to compare two different data service versions for the purpose of writing change logs and other documentation. By default, its report will list additions and subtractions among the nodes, both operation and non-operation. You can also specify that the report include differences in parameters and output fields.
OPTIONS
- --help
-
Print a brief help message and exit.
- --man
-
Print this manual page and exit.
- --params
-
For each data service operation, report differences in the parameters between the versions.
- --blocks
-
For each data service operation, report differences in the list of output blocks between the versions.
- --fields
-
For each data service operation, report differences in the output between the versions.
- --all
-
Generate a full report, with all available reporting options.
OUTPUT
A description of the command output should go here.
AUTHOR
This command is installed as part of the Web::Dataservice module.
Please report bugs using http://rt.cpan.org/.
Michael McClennen <mmcclenn@cpan.org>