summaryrefslogtreecommitdiff
path: root/Documentation/git-quiltimport.txt
diff options
context:
space:
mode:
authorEric W. Biederman <ebiederm@xmission.com>2006-05-17 12:44:40 -0600
committerJunio C Hamano <junkio@cox.net>2006-05-18 22:55:57 -0700
commitd3d8f361a8c6beb5647e0d963a1460a505324494 (patch)
tree918d3f53e99e71db5f426a139f6a61170a446d8e /Documentation/git-quiltimport.txt
parentff62b7f37899de2faa88cbb5be1f3bcfa246012c (diff)
downloadgit-d3d8f361a8c6beb5647e0d963a1460a505324494.tar.gz
Implement git-quiltimport
Importing a quilt patch series into git is not very difficult but parsing the patch descriptions and all of the other minutia take a bit of effort to get right, so this automates it. Since git and quilt complement each other it makes sense to make it easy to go back and forth between the two. If a patch is encountered that it cannot derive the author from the user is asked. Signed-off-by: Junio C Hamano <junkio@cox.net>
Diffstat (limited to 'Documentation/git-quiltimport.txt')
-rw-r--r--Documentation/git-quiltimport.txt55
1 files changed, 55 insertions, 0 deletions
diff --git a/Documentation/git-quiltimport.txt b/Documentation/git-quiltimport.txt
new file mode 100644
index 0000000000..c66c82c61d
--- /dev/null
+++ b/Documentation/git-quiltimport.txt
@@ -0,0 +1,55 @@
+git-quiltimport(1)
+================
+
+NAME
+----
+git-quiltimport - Applies a quilt patchset onto the current branch
+
+
+SYNOPSIS
+--------
+[verse]
+'git-quiltimport' [--author <author>] [--patches <dir>]
+
+
+DESCRIPTION
+-----------
+Applies a quilt patchset onto the current git branch, preserving
+the patch boundaries, patch order, and patch descriptions present
+in the quilt patchset.
+
+For each patch the code attempts to extract the author from the
+patch description. If that fails it falls back to the author
+specified with --author. If the --author flag was not given
+the patch description is displayed and the user is asked to
+interactively enter the author of the patch.
+
+If a subject is not found in the patch description the patch name is
+preserved as the 1 line subject in the git description.
+
+OPTIONS
+-------
+--author Author Name <Author Email>::
+ The author name and email address to use when no author
+ information can be found in the patch description.
+
+--patches <dir>::
+ The directory to find the quilt patches and the
+ quilt series file.
+
+ The default for the patch directory is patches
+ or the value of the $QUILT_PATCHES environment
+ variable.
+
+Author
+------
+Written by Eric Biederman <ebiederm@lnxi.com>
+
+Documentation
+--------------
+Documentation by Eric Biederman <ebiederm@lnxi.com>
+
+GIT
+---
+Part of the gitlink:git[7] suite
+