Converting from Arch
====================

There are two different automatic conversion scripts to create a
Darcs repository from an Arch repository: arch2darcs and tla2darcs.
arch2darcs is newer and strives to have these improvements over
``tla2darcs``:


-  Handles renames properly
-  Good support for importing a whole branch at once
-  Less crash-prone
-  Also useful for synching from arch to darcs later on

Please report feedback on either tool to the ``darcs-users``list so
we can update this page.

arch2darcs
----------

Download arch2darcs with:

::

    darcs get --partial http://darcs.complete.org/arch2darcs

Follow the installation instructions in the README file,
`http://darcs.complete.org/arch2darcs/README <http://darcs.complete.org/arch2darcs/README>`_.
arch2darcs can convert entire branches and maintain a Darcs mirror
of an Arch repository. Here's an excerpt from the README
illustrating the use of arch2darcs for the initial conversion of an
Arch branch:

::

    $ tla get jgoerzen@complete.org--projects/missingh--head--0.5--base-0 missingh
    
      *** IMPORTANT NOTE: make sure you include "--base-0" from the above
          command.
    
    $ cd missingh
    $ darcs initialize
    $ arch2darcs -i
    Processing existing Arch situation...
    Looking for new patches...
    Processing jgoerzen@complete.org--projects/missingh--head--0.5--patch-1
    ...
    Processing jgoerzen@complete.org--projects/missingh--head--0.5--patch-145
    Done.

tla2darcs
---------

To migrate an Arch project to Darcs:

Download tla\_import.pl and tla\_convert\_patch.pl from
`http://sacha.free.net.ph/notebook/darcs/dev/tla2darcs/ <http://sacha.free.net.ph/notebook/darcs/dev/tla2darcs/>`_

Check out your project using:

::

        perl tla_import.pl [archive/]category--branch--version directory

Move into the directory you just created

::

        cd directory

Apply patches either all at once or individually with

::

        perl tla_convert_patch.pl [archive/]category--branch--version

or

::

        perl tla_convert_patch.pl patch1 patch2 patch3 ...

Example:

::

        perl tla_import.pl sacha@free.net.ph--main/planner--dev--1.0 planner
        cd planner
        perl ../tla_convert_patch.pl sacha@free.net.ph--main/planner--dev--1.0

Limitations:


-  Does not handle conflicts well yet.
-  Doesn't do anything reasonable with multiple branches.

tla2darcs was written by `SachaChua <SachaChua>`_
(sacha@free.net.ph).

Related Pages
=============


-  `Differences from Arch <DifferencesFromArch>`_

Questions
=========

''Should this perhaps go into the David's repository? -- perhaps
when the conversion can go both ways?
[`firefly@diku.dk <mailto:firefly@diku.dk>`_]''
*Try Asking David... -- `MarkStosberg <MarkStosberg>`_*

I followed the directions and tla\_convert\_patch.pl seems to have
bombed with this:

About to get the unrecorded changes. diffing dir... I've gotten
unrecorded. What is the date? No changes!