#pragma section-numbers 2
= ConvertPRCS extension =
Add-on to the [[ConvertExtension|Convert extension]] which adds [[http://prcs.sourceforge.net/|PRCS]] as a conversion source (work-in-progress).

<<TableOfContents>>

== Status ==
'''This extension is not distributed with Mercurial.'''

''Author: '' ''Kaz Nishimura''

Repository: ''https://bitbucket.org/kazssym/hgext-convertprcs''

Web page: ''https://bitbucket.org/kazssym/hgext-convertprcs'' (temporary location)

=== Implementation status ===
As of May 22, 2015, this extension can import all revision history from a PRCS project except file renames.

== Overview ==
This extension just adds [[http://prcs.sourceforge.net/|PRCS]] as a conversion source of the [[ConvertExtension|Convert extension]]. With this extension, you can specify a PRCS project as a conversion source in the `hg convert` command.

This extension will import all branches with numeric major versions as the main (default) branches according to the PRCS convention and others as its own. If a PRCS project has multiple numeric major versions such as 0, 1, 2, etc., the destination repository will have multiple heads. It does not add tags to any imported revisions since PRCS does not support them.

This extension requires the following software:

 * Mercurial on Python 2.5 or later,
 * a working `prcs` command (available from [[https://bitbucket.org/kazssym/prcs|here]]), and
 * Python module prcslib in [[http://bitbucket.org/kazssym/prcs2hg|prcs2hg]] 2.0 which is not released yet.

== Configuration ==
Configure your .hgrc to enable the extension by adding following lines:

{{{
[extensions]
convert =
converprcs = REPO/hgext/convertprcs
}}}
== See also ==
 * [[ConvertExtension|Convert extension]]
 * [[http://prcs.sourceforge.net/|PRCS (Project Revision Control System]]

----
CategoryExtensionsByOthers