index.html #1

<HTML>

<HEAD>

<TITLE>
RevML Project - Perforce Public Depot
</TITLE>

</HEAD>

<BODY BGCOLOR="#FFFFFF">
<CENTER>
<P>
<A NAME="toc"></A>
<h2>
<sub><a href="../index.html">Perforce Public Depot</a></sub><br>
The RevML Project
<br>
(including <tt>vcp</tt>)
</H2>
<P>

<TABLE BORDER=0><TR><TD>
<B>
<UL>
<LI><A HREF="#about">About This Project
</A>
<LI><A HREF="#dist">The RevML Distribution
</A>
<LI><A HREF="#docs">Documentation
</A>
</UL>
</B>
</TABLE>
</CENTER>
<br>
<br>
<br>

<!------------------------------------------------------------------>
<P>
<TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>

<A NAME="about"></A>
<H2>About This Project
</H2>

<TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
Back to<BR>Table of<BR>Contents</A></TD></TR>
</TABLE>
<!------------------------------------------------------------------>

<p>
<table cellpadding=5%>
<tr>
<td valign=top>
<b>Content</b>
</td>
<td valign=top>

Perl code and documentation for <b>RevML</b> (Revision Markup
Language) and <b><tt>vcp</tt></b> (Versioned Copy).

<p>
RevML is an XML document type intended for the
representation of file revisions, such as those managed by Perforce,
or other version control and configuration management systems. RevML
provides a generic way to represent revisions (apart from any
particular version control or SCM tool's format). It forms the basis
for other tools that operate on file revisions.

<p>
<tt>vcp</tt> is one such tool.
It allows file revisions to be interchanged between repositories of
either the same or different types.  For example, using <tt>vcp</tt>,
it is possible to copy the contents of a entire Perforce depot (or
part of one) into a depot on a different Perforce server; or, to copy
the contents of a CVS repository into a Perforce server (or
vice-versa).

<p>
<tt>vcp</tt> currently supports bidirectional exchanges between any
combination of:
<ul>
<li>RevML
<li><tt>CVS</tt>
<li>Perforce
</ul>

</td>
</tr>


<tr>
<td valign=top>
<b>Curator</b>
</td>
<td valign=top>
The current curator for this project is Barrie Slaymaker.  Please send
email to <a href="mailto:barries@slaysys.com">barries@slaysys.com</a> if
you would like to submit contributions.
</td>
</tr>


<tr>
<td valign=top>
<b>Mailing<br>List</b>
</td>
<td valign=top>

The
<a href="http://maillist.perforce.com/mailman/listinfo/revml"><b>revml</b>
mailing list</a> is used by contributors and users of RevML and <tt>vcp</tt>
for a general discussion of the development and use of these tools.

</td>
</tr>
</table>

<!------------------------------------------------------------------>
<P>
<TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>

<A NAME="dist"></A>
<H2>The RevML Distribution
</H2>

<TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
Back to<BR>Table of<BR>Contents</A></TD></TR>
</TABLE>
<!------------------------------------------------------------------>

<p>
The file comprising the current distribution of RevML are available
for direct browsing and downloading from the Perforce Public Depot at
<blockquote><b>
<A HREF="http://public.perforce.com:8080/@ra=s@/public/revml/">
//public/revml/...</a>
</b></blockquote>

<p>
RevML may be downloaded from the Public Depot using any Perforce client software.


<!------------------------------------------------------------------>
<P>
<TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>

<A NAME="docs"></A>
<H2>Documentation
</H2>

<TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
Back to<BR>Table of<BR>Contents</A></TD></TR>
</TABLE>
<!------------------------------------------------------------------>

<p>
High-level documentation for RevML and <tt>vcp</tt> is currently rather sparse.
(Contributors are cordially invited to add documentation!)

<p>
The perl files in bin/... and lib/... are self-documented using perl
"pod" embedded documents. Please see the "perlpod" man page from your
perl distribution if you are not familiar with this format.

<p>
Please refer to the following files from the distribution for more information:

<ul>
<li><b><a href=README>README</a></b>
<li><b><a href=INSTALL>INSTALL</a></b>
<li><b><a href=CHANGES>CHANGES</a></b>
<li><b><a href=LICENSE>LICENSE</a></b>
<li><b><a href=MANIFEST>MANIFEST</a></b>
</ul>


<!------------------------------------------------------------------>


<br><br><br>
<!------------------------------------------------------------------>
<P>
<TABLE CELLSPACING=0 BORDER=0 WIDTH=100%>
<TR>

<TD WIDTH=15% BGCOLOR=FFCC66 ALIGN=LEFT VALIGN=CENTER>
<FONT SIZE="-2">
Copyright &copy;<br>
1998, 1999<br>
<a href="http://www.perforce.com">Perforce Software</a><br>
</FONT>
</TD>

<TD WIDTH=70% BGCOLOR=FFCC66 ALIGN=CENTER>
<FONT SIZE="-2">
You're browsing a file stored as<br> 
<code>$Id: //guest/sean_mccune/revml/index.html#1 $</code><br> 
in the 
<A HREF=http://public.perforce.com/public/index.html>Perforce Public Depot</A>.
</FONT>
</TD>

<TD WIDTH=15% BGCOLOR=FFCC66 ALIGN=RIGHT>
<FONT SIZE="-2"><A HREF="#toc">
Back to<BR>Table of<BR>Contents</A></TD></TR>
</FONT>
</TD>

</TR>
</TABLE>
<!------------------------------------------------------------------>



</BODY>

#	Change	User	Description
#1	1375	Sean McCune	Creating my own branch for work on vcp.
//guest/perforce_software/revml/index.html
#3	1155	rmg	The change to utils/index.html was required to get the page to render better with Netscape 6.2. (Without the closing </B> tags, the whole page from the Depot Browsers section on down rendered bold...!) I made the same logical change to the other four for consistency, though they didn't seem to suffer from the same problem. p4dti/index.html still doesn't render right under Netscape 6.2, but it's from a different patterns and I couldn't see a quick clean fix... so I didn't mess with it for now.
#2	776	rmg	Adjust the revml index (per feedback from barries and others) and point the top level index link at it.
#1	775	rmg	First cut index page for RevML.