Man Linux: Main Page and Category List

NAME

       tla_load_dirs  -  Import  upstream archives into tla, hg, darcs, or git
       and handle renames

SYNOPSIS

       tla_load_dirs [ -wWC | --wc=WC ] [ -lFILE | --log=FILE  ]  [  -LTEXT  |
       --log-message=TEXT  ] [ -sMSG | --summary=MSG ] [ -v | --verbose ] [ -n
       | --no-commit ] [ -f | --fs-changes-only ] vendor_source_dir

       tla_load_dirs --version

       tla_load_dirs [ --help | -h ]

DESCRIPTION

       tla_load_dirs is a tool to help you import archives from people that do
       not  use Arch, Mercurial, Darcs, or Git into an Arch, Mercurial, 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.   tla_load_dirs can handle both first imports of a package
       and successive imports.

       For those familiar with Subversion, you will know that it  has  a  tool
       called svn_load_dirs.  tla_load_dirs is modeled after that program, but
       contains various improvements for ease of use.

USAGE

       In the simplest case, you  will  simply  run  tla_load_dirs  from  your
       working  directory, passing it the name of the directory containing the
       new upstream sources.   tla_load_dirs  will  run,  usually  making  and
       committing changes without any need of greater assistance from you.

   RENAMED FILES
       tla_load_dirs can automatically detect added files and deleted files if
       they occur in isolation.  However, it  cannot  automatically  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, tla_load_dirs will prompt you to solve the problem.  You can
       opt to ignore it -- tla_load_dirs will just issue deletes and  adds  as
       appropriate  --  but then your history will be harder to track if there
       were indeed 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 request the list  be  re-
       drawn, or you can supply one or more renames.

       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 automatically re-drawn, and you can either make
       further selections or exit.

       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=FILE
              Add  the  contents  of  FILE  to  the  end  of  the  log message
              automatically generated by tla_load_dirs for a commit/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, Mercurial, or tla 1.1 or
              above; tla 1.0  does  not  provide  the  features  necessary  to
              implement it.

       -n

       --no-commit
              Do not commit changes to the target VCS.

       -f

       --fs-changes-only
              Move  files in the filesystem, but do not inform VCS of changes.
              You will almost certainly want to use this with \-n.  This  also
              suppresses the interactive interface.

       -v

       --verbose
              Causes  tla_load_dirs  to display additional status information.
              You will see the darcs/tla/git/hg commands that  are  being  run
              behind  the  scenes,  and  some  executed  commands  may receive
              arguments asking them to be more verbose as well.

       --version
              Causes tla_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

       tla_load_dirs,  and  this  manual,  are  Copyright  (C)  2003-2007 John
       Goerzen.

       This program is free software; you can redistribute it and/or modify it
       under  the  terms of the GNU General Public License as published by the
       Free Software Foundation; either version 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   warranty   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 Software Foundation, Inc.,
       59 Temple Place, Suite 330, Boston, MA  02111-1307 USA

AUTHOR

       tla_load_dirs, its libraries, documentation, and  all  included  files,
       except where noted, was written by John Goerzen <jgoerzen@complete.org>
       and copyright is held as stated in the COPYRIGHT section.

       The homepage for tla_load_dirs is
        <URL:http://software.complete.org/vcs-load-dirs>

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

SEE ALSO

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