svk_load_dirs(1)

NAME

svk_load_dirs - Import upstream archives into

tla/arch,darcs or git and handle renames

SYNOPSIS

svk_load_dirs [ -wWC | --wc=WC ] [ -lFILE | --log=FILE ] [
-LTEXT | --log-message=TEXT ] [ -sMSG | --summary=MSG ]  [  -v
--verbose ] [ -n | --no-commit ] vendor_source_dir
svk_load_dirs --version
svk_load_dirs [ --help | -h ]

DESCRIPTION

svk_load_dirs is a tool to help you import archives from

people that do not use Arch, Darcs or Git into an Arch, Darcs or

Git archive. Along the way, it takes care of all the typical

hassles: it will create tags in the repository for new files;

delete tags for removed files; and move tags for files that have

themselves been moved. svk_load_dirs can handle both first im

ports of a package and successive imports.

For those familiar with Subversion, you will know that it

has a tool called svn_load_dirs. svk_load_dirs is modeled after

that program, but contains various improvements for ease of use.

USAGE

In the simplest case, you will simply run svk_load_dirs

from your working directory, passing it the name of the directory

containing the new upstream sources. svk_load_dirs will run,

usually making and commiting changes without any need of greater

assistance from you.

RENAMED FILES

svk_load_dirs can automatically detect added files and

deleted files if they occur in isolation. However, it cannot au

tomatically tell the difference between a delete and an add, and

a rename. (There is not enough information in simple upstream

imports to capture the intent.) Therefore, svk_load_dirs will

prompt you to solve the problem. You can opt to ignore it -

svk_load_dirs will just issue deletes and adds as appropriate -

but then your history will be harder to track if there were in

deed renames along the way.

You will be presented with a four-column listing. Those

columns, in order from left to right, represent:

1. File number for deleted file

2. File name of deleted file

3. File number of added file

4. File name of added file

You have three options at this point: you can press q to

indicate that there are no more renames; you can press r to re

quest the list be re-drawn, or you can supply one or more re

names.

A rename uses the left column as the old name and the

right column as the new name. To save you typing, you just enter

the appropriate file numbers separated by spaces. So, if the

file at position 5 on the left moved to position 1b on the right,

just enter "5 1b". After doing that, the list will be automati

cally re-drawn, and you can either make further selections or ex

it.

If you want to rename several files at once, enter your

rename commands separated by commas. For instance, "5 1b, 6 1c".

OPTIONS

-h

--help Displays a brief summary of the available options

and exits.

-lFILE

--log=FILEAdd the contents of FILE to the end of the log mes

sage automatically generated by svk_load_dirs for a com

mit/record.

-LTEXT

--log-message=TEXT
Add the TEXT specified on the command line to the

log message.

-sMSG

--summary=MSG
Sets the log summary line to the MSG supplied on

the command line. This operation requires darcs or tla 1.1 or

above; tla 1.0 does not provide the features necessary to imple

ment it.

-v

--verbose
Causes svk_load_dirs to display additional status

information. You will see the darcs/tla/git commands that are

being run behind the scenes, and some executed commands may re

ceive arguments asking them to be more verbose as well.

--version
Causes svk_load_dirs to print its version number

and exit.

-wWC

--wc=WC
Explicitly set the working copy directory to WC.

If not specified, defaults to the current working directory.

COPYRIGHT

svk_load_dirs, and this manual, are Copyright (C)

2003-2005 John Goerzen.

This program is free software; you can redistribute it

and/or modify it under the terms of the GNU General Public Li

cense as published by the Free Software Foundation; either ver

sion 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be

useful, but WITHOUT ANY WARRANTY; without even the implied war

ranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See the GNU General Public License for more details.

You should have received a copy of the GNU General Public

License along with this program; if not, write to the Free Soft

ware Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA

02111-1307 USA

AUTHOR

svk_load_dirs, its libraries, documentation, and all in

cluded files, except where noted, was written by John Goerzen

<jgoerzen@complete.org> and copyright is held as stated in the

COPYRIGHT section.

This package may be downloaded from
<URL:http://packages.debian.org/tla-load-dirs>. darcs

users may also obtain the latest version with:

$ darcs get http://darcs.complete.org/tla-load-dirs

SEE ALSO

tla(1), darcs(1), git(1), tla-buildpackage(1).

John Goerzen 22 November 2006

SVK_LOAD_DIRS(1)