descriptionsh script to create a project's git history from release archives
homepage URLhttps://gitorious.org/graud-utils/archives2git
ownergraud@gmx.com
last changeTue, 29 Apr 2014 05:36:41 +0000 (29 07:36 +0200)
content tags
add:
README
README for archives2git
=======================

`archives2git` is intended to recreate a poor-man's history from the release
archives of a project.  It is an sh script that commits the given file archives
to a Git repository as a series of commits; by default the commit (sub-)trees
will replicate the contents of their corresponding archive.

Resources
---------

For the documentation see the manual of linkpage:archives2git[1] (or the help
message output), then look inside the configuration file example
link:archives2gitrc[.archives2gitrc] and finally inside the
link:archives2git[script].

Basic usage:

	$ cd git-repo # may be a subdir of the toplevel of a repo
	$ GIT_AUTHOR_NAME="Firstname Lastname" GIT_AUTHOR_EMAIL=user@host \
	  archives2git --tag ../oldproject-?.??.tar.gz

The file link:NEWS.html[+NEWS+] describes the important user visible changes.
The project is available online at
link:https://gitorious.org/graud-utils/archives2git[Gitorious].

Limitions & Bugs
----------------

* Trailing newlines in file names are not supported.

Dependencies
------------

* POSIX `sh`
* `mktemp`
* `aunpack` from link:http://www.nongnu.org/atool/[atool]
* link:http://git-scm.com[Git]
* link:https://gitorious.org/graud-utils/helpmessage[HelpMessage] and
  link:http://perldoc.perl.org/pod2man.html[`pod2man`] are required to build
  the manpage

Related programs
----------------

* link:http://joeyh.name/code/pristine-tar/[pristine-tar] can be used to embed
  the archives in the repository.

Credits & License
-----------------

archives2git was written by G.raud Meyer.

This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License version 2 as published by the Free
Software Foundation.  The full text of the license can be found in the root
directory of the project sources, in the file link:COPYING[+COPYING+].  Otherwise see
<http://www.gnu.org/licenses/>.
shortlog
2014-04-29 G.raudversion/0.2masterversion/0.2
2014-04-29 G.raudNEWS: new documentation file
2014-04-29 G.raudREADME: wording
2014-04-29 G.raudMakefile: doc-txt, doc-man, doc-html: new targets
2014-04-29 G.raudMakefile: remove needless $(DIST_VERSION)
2014-04-29 G.raudMakefile: suppress the manpage's header and add the...
2014-04-29 G.raudversion.sh: try to get the version from release/* tags...
2014-04-29 G.raudMakefile: dist: new target to build a distribution...
2014-04-29 G.raudarchives2git: HelpM: improve the description of the...
2014-04-29 G.raudarchives2git: HelpM: new section SHELL FUNCTIONS to...
2014-04-29 G.raudREADME: link to the online Gitorious repository
2014-04-29 G.raudREADME: new section about related noteworthy programs
2014-04-29 G.raudREADME: new section Credits & License
2014-04-29 G.raudREADME: link to the Git homepage
2014-04-29 G.raudREADME: depend on HelpMessage and pod2man
2014-04-29 G.raudREADME, archives2git: move the examples to the script
...
tags
3 years ago version/0.2 archives2git version 0.2 (2014...
3 years ago version/0.1 archives2git version 0.1 (2014...
heads
3 years ago master