From: Eric S. Raymond Date: Thu, 11 Nov 2010 15:05:07 +0000 (-0500) Subject: Add documentation and metadata files. X-Git-Tag: 0.1~59 X-Git-Url: http://thyrsus.com/gitweb/?a=commitdiff_plain;h=648474ff9ba5d2a10cc4760614face654dc51ca4;p=rcs-fast-import.git Add documentation and metadata files. --- diff --git a/COPYING b/COPYING new file mode 100644 index 0000000..a33e149 --- /dev/null +++ b/COPYING @@ -0,0 +1,30 @@ + BSD LICENSE + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + +Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + +Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in the +documentation and/or other materials provided with the distribution. + +Neither name of the this project nor the names of its contributors +may be used to endorse or promote products derived from this software +without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR +CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..5eb34d4 --- /dev/null +++ b/Makefile @@ -0,0 +1,32 @@ +# +# makefile for rcs-fast-export +# +VERS=$(shell sed MANIFEST + @(cd ..; ln -s rcs-fast-export rcs-fast-export-$(VERS)) + (cd ..; tar -czvf rcs-fast-export/rcs-fast-export-$(VERS).tar.gz `cat rcs-fast-export/MANIFEST`) + @(cd ..; rm rcs-fast-export-$(VERS)) + +version: + @echo $(VERS) + +dist: rcs-fast-export-$(VERS).tar.gz + +release: rcs-fast-export-$(VERS).tar.gz rcs-fast-export.html + shipper -u -m -t; make clean diff --git a/README b/README new file mode 100644 index 0000000..47e13d8 --- /dev/null +++ b/README @@ -0,0 +1,12 @@ + rcs-fast-import + +rcs-fast-import unpacks a git fast-import stream into an RCS file tree + +The metadata in modern DVCSes can't really be stuffed back into RCS, +but this tool makes a valiant effort and may occasionally be useful +for extracting the revision histories of individual files from a +project history. + +It keeps the revision structure, comments, authorship dates, and tag names. +It loses tag dates and comments and authorship information; commits are +recorded as though they were from the user invoking it. diff --git a/control b/control new file mode 100644 index 0000000..a3ebf91 --- /dev/null +++ b/control @@ -0,0 +1,13 @@ +# This is not a real Debian control file +# It's project metadata for the shipper tool + +Package: rcs-fast-export + +Description: unpack a git fast-import stream into an RCS file tree + The metadata in modern DVCSes can't really be stuffed back into RCS, + but this tool makes a valiant effort and may be useful for extracting + the revision histories of individual files from a project history. + +Homepage: http://www.catb.org/~esr/rcs-fast-export + +XBS-Project-Tag-List: version control, git diff --git a/rcs-fast-import.xml b/rcs-fast-import.xml new file mode 100644 index 0000000..279ce5f --- /dev/null +++ b/rcs-fast-import.xml @@ -0,0 +1,76 @@ + + + + +rcs-fast-export +1 +Nov 11 2010 +rcs-fast-export +rcs-fast-export +Development Tools + + +rcs-fast-export +surgical operations on repositories + + + + + rcs-fast-export + -v + -u + -l + -d + -n + -V + + + +DESCRIPTION + +This tool breaks the content of a git-fast-import stream on +stdin into individual RCS master files in RCS subdirectories of the +corresponding directory structure. + +With the -v option, emit a twirling-baton prompt during stream read, and +progress messages during RCS writes. + +With the -l option, check out and lock all resulting files at their latest +revisions; with the -u option, check out but do not lock. + +The -V option displays the program version number and exits. -? displays +this help and exits. + +The -d option enables delete operations in the the input +stream. Normally, delete operations in the input stream are ignored so +as to maximize access to the unpacked history. + +The -n option sets dry-run mode; parse the import stream, then go through +all logic other than actually creating files. Useful for debugging in +combination with -v. + +R file operations rename corresponding RCS master files; C file operations +copy them. + +If D, R, or C operations are present, the conversion will not +round-trip properly (that is the file structure after , +rcs-fast-export | rcs-fast-import won't be an exact copy) with +differences near deleted, renamed, and copied files. + +Warning: All tag metadata other than the name will be lost. The date +imputed to commits is from the author metadata if that exists, otherwise +from the committer metadata. Committer and author information is lost. + + +ERROR RETURNS +Returns 1 on any error, 0 otherwise. + + +AUTHOR + +Eric S. Raymond esr@thyrsus.com; project page at http://www.catb.org/~esr/rcs-fast-export. + +