<html><head><title>VCP::Dest::revml - Outputs versioned files to a revml file</title></head><body><h1><a name="NAME">NAME
</a></h1><p>VCP::Dest::revml - Outputs versioned files to a revml file
<p><hr><h1><a name="SYNOPSIS">SYNOPSIS
</a></h1><pre> revml:[<output-file>]
revml:[<output-file>] --dtd <revml.dtd>
revml:[<output-file>] --version <version>
revml:[<output-file>] --compress
revml:[<output-file>] --no-indent
</pre><p><hr><h1><a name="DESCRIPTION">DESCRIPTION
</a></h1><p><hr><h1><a name="OPTIONS">OPTIONS
</a></h1><h3>--dtd
</h3><pre> --dtd=revml.dtd
--version=0.33
</pre><p>The --dtd (or --version) option causes the output to be checked against
a particular version of revml. This does <i>not</i> cause output to be in
that version, but makes sure that output is compliant with that version.
<h3>--compress
</h3><p>Generate a gzipped revml file as output. Requires gzip be installed
on the machine.
<p>If the output filename ends in ".gz", the output will be compressed
even if the --compress flag isn't present.
<h3>--no-indent
</h3><p>Makes the revml output with all the start tags flush left rather than
indented to indicate the tree structure.
<p><hr><h1><a name="EXTERNAL_METHODS">EXTERNAL METHODS
</a></h1><dl><dt><a name="new_"><strong><p>new
</strong></a><dd>Creates a new instance. The only parameter is '-dtd', which overrides
the default DTD found by searching for modules matching RevML::DTD:v*.pm.
<p>Attempts to create the output file if one is specified.
<dt><a name="ui_set_revml_repo_spec_"><strong><p>ui_set_revml_repo_spec
</strong></a><dd>set the repo_spec, but die if no good.
this should be called from a ui handler that
will handle exceptions.
<pre>
</pre><pre>
</pre></dl><p><hr><h1><a name="LIMITATIONS">LIMITATIONS
</a></h1><p>Can consume all available memory and disk space because this driver keeps
all old revisions around (metadata in RAM, file images on disk) so that
diff()s may be run against the parent revision when a branch is made.
<p>This behavior is not completely necessary, but because RevML is
currently only used for testing and analysis of small filesets, this
limitation is acceptable.
<p>We can add a command line option to disable this behavior by limiting
(to 0 or to some cache size) the number of revs kept around and letting
files that have no previous rev handy be emitted in their entirety
instead of use a diff. We could also use an on-disk store for the
metadata if that would help. Let us know your needs.
<p><hr><h1><a name="AUTHOR">AUTHOR
</a></h1><p>Barrie Slaymaker <barries@slaysys.com>
<p><hr><h1><a name="COPYRIGHT">COPYRIGHT
</a></h1><p>Copyright (c) 2000, 2001, 2002 Perforce Software, Inc.
All rights reserved.
<p>See <a>VCP::License</a> (<code>vcp help license</code>) for the terms of use.
<p><hr><i><font size="-1">Last updated: Fri Jun 4 14:21:30 2004</font></i></body></html>