git-quiltimport.1   [plain text]


'\" t
.\"     Title: git-quiltimport
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 08/19/2012
.\"    Manual: Git Manual
.\"    Source: Git 1.7.12
.\"  Language: English
.\"
.TH "GIT\-QUILTIMPORT" "1" "08/19/2012" "Git 1\&.7\&.12" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
git-quiltimport \- Applies a quilt patchset onto the current branch
.SH "SYNOPSIS"
.sp
.nf
\fIgit quiltimport\fR [\-\-dry\-run | \-n] [\-\-author <author>] [\-\-patches <dir>]
.fi
.sp
.SH "DESCRIPTION"
.sp
Applies a quilt patchset onto the current git branch, preserving the patch boundaries, patch order, and patch descriptions present in the quilt patchset\&.
.sp
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\&.
.sp
If a subject is not found in the patch description the patch name is preserved as the 1 line subject in the git description\&.
.SH "OPTIONS"
.PP
\-n, \-\-dry\-run
.RS 4
Walk through the patches in the series and warn if we cannot find all of the necessary information to commit a patch\&. At the time of this writing only missing author information is warned about\&.
.RE
.PP
\-\-author Author Name <Author Email>
.RS 4
The author name and email address to use when no author information can be found in the patch description\&.
.RE
.PP
\-\-patches <dir>
.RS 4
The directory to find the quilt patches and the quilt series file\&.
.sp
The default for the patch directory is patches or the value of the $QUILT_PATCHES environment variable\&.
.RE
.SH "GIT"
.sp
Part of the \fBgit\fR(1) suite