README

   1 README for archives2git
   2 =======================
   3
   4 `archives2git` is intended to recreate a poor-man's history from the release
   5 archives of a project.  It is an sh script that commits the given file archives
   6 to a Git repository as a series of commits; by default the commit (sub-)trees
   7 will replicate the contents of their corresponding archive.
   8
   9 Resources
  10 ---------
  11
  12 For the documentation see the manuals of linkpage:archives2git[1] and
  13 linkpage:dsc2git[1] (or the help message outputs), then look inside the
  14 configuration file example link:archives2gitrc[.archives2gitrc] and finally
  15 inside the link:archives2git[script].
  16
  17 Basic usage:
  18
  19         $ cd git-repo # may be a subdir of the toplevel of a repo
  20         $ GIT_AUTHOR_NAME="Firstname Lastname" GIT_AUTHOR_EMAIL=user@host \
  21           archives2git --tag ../oldproject-?.??.tar.gz
  22
  23 The file link:NEWS.html[+NEWS+] describes the important user visible changes.
  24 The project is available online at
  25 link:http://repo.or.cz/archives2git.git[repo.or.cz].
  26
  27 Limitions & Bugs
  28 ----------------
  29
  30 * Trailing newlines in file names are not supported.
  31
  32 Dependencies
  33 ------------
  34
  35 * POSIX `sh` (tested only with `dash` but BSD `ash` should be compatible).
  36 * `sed` with option +-r+ for Extended Regular Expressions (GNU and BSD
  37   implementations are compatible).
  38 * `mktemp` (GNU and BSD implementations are compatible).
  39 * link:http://git-scm.com[Git] of course.
  40 * `aunpack` from link:http://www.nongnu.org/atool/[atool] or from
  41   link:http://repo.or.cz/atool/gnatool.git[gnatool] is the default extraction
  42   command used.
  43 * link:http://joeyh.name/code/pristine-tar/[`pristine-tar`] can be used to
  44   embed the archives in the repository.
  45 * link:http://repo.or.cz/shelmfish.git[SHelMFiSH/HelpMessage] and
  46   link:http://perldoc.perl.org/pod2man.html[`pod2man`] are required to build
  47   the manpage.
  48
  49 Similar programs
  50 ----------------
  51
  52 * link:https://github.com/git/git/blob/master/contrib/fast-import/import-tars.perl[`import-tars.perl`]
  53   and link:https://github.com/git/git/blob/master/contrib/fast-import/import-directories.perl[`import-directories.perl`]
  54   from the contrib directory of Git.
  55 * link:http://honk.sigxcpu.org/projects/git-buildpackage/manual-html/man.gbp.import.orig.html[`gbp-import-orig`]
  56   and link:http://honk.sigxcpu.org/projects/git-buildpackage/manual-html/man.gbp.import.dsc.html[`gbp-import-dsc`]
  57   from git-buildpackage.
  58
  59 Credits & License
  60 -----------------
  61
  62 archives2git was written by G.raud Meyer.
  63
  64 This program is free software; you can redistribute it and/or modify it under
  65 the terms of the GNU General Public License version 2 as published by the Free
  66 Software Foundation.  The full text of the license can be found in the root
  67 directory of the project sources, in the file link:COPYING[+COPYING+].  Otherwise see
  68 <http://www.gnu.org/licenses/>.