The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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>