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>