/ 
Clarity-XOG-Merge-1.001
River stage zero No dependents
/ xogtool

NAME

xogtool - Frontend tool to Clarity::XOG::Merge

ABOUT

This is a Clarity XOG tool. Its primary usecase is merging XOG project files. See xogtool help merge for more details.

SYNOPSIS

merge

This provides the core functionality of the tool.

xogtool merge [-dfiov] [long options...]

Merge Clarity project files.

You either specify the files to merge or it finds all *.xml files either in local directory or the directory you specified with -i.

Specify an output file with -o, default is XOGMERGE.xml in current directory. If you want to force overwrite an existing output file without asking then specify -f.

During the process a temporary directory is created, used, and cleaned up at the end.

To self-test the xogtool use the xogtool selftest.

Options:

-o|--out <FILENAME>

Write result to that file

-i|--in <SUBDIR>

Search default input files in that subdir

-v|--verbose

Be verbose

-d|--debug

Output debugging info

-f|--force

Force overwrite of existing output file.

selftest

xogtool selftest

Built-in self test.

Merge some self-contained dummy xml files into a temporary result file and executes plausibility checks.

This is to check for general working, like XML parsing, create and cleanup temp files, etc.

Expected output is some 'ok' lines and number of tests, eg. '1..4'.

help

xogtool <subcommand> [options]* [files]*

Available commands:

commands: list the application's commands
    help: display a command's help screen
   merge: merge several files
selftest: built-in self test

commands

Lists the available subcommands. Basically the same as help.

AUTHOR

Steffen Schwigon, <ss5 at renormalist.net>

BUGS

Please report any bugs or feature requests to bug-clarity-xog-merge at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Clarity-XOG-Merge. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT & LICENSE

Copyright 2010-2011 Steffen Schwigon, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.