'\" t
.\"     Title: stg-export
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 03/13/2012
.\"    Manual: StGit Manual
.\"    Source: StGit
.\"  Language: English
.\"
.TH "STG\-EXPORT" "1" "03/13/2012" "StGit" "StGit 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"
stg-export \- Export patches to a directory
.SH "SYNOPSIS"
.sp
.nf
\fIstg\fR export [options] [<patch1>] [<patch2>] [<patch3>\&.\&.<patch4>]
.fi
.SH "DESCRIPTION"
Export a range of applied patches to a given directory (defaults to \fIpatches\-<branch>\fR) in a standard unified GNU diff format\&. A template file (defaulting to \fI\&.git/patchexport\&.tmpl\fR or \fI~/\&.stgit/templates/patchexport\&.tmpl\fR or \fI/usr/share/stgit/templates/patchexport\&.tmpl\fR) can be used for the patch format\&. The following variables are supported in the template file:

.sp
.if n \{\
.RS 4
.\}
.nf
%(description)s \- patch description
%(shortdescr)s  \- the first line of the patch description
%(longdescr)s   \- the rest of the patch description, after the first line
%(diffstat)s    \- the diff statistics
%(authname)s    \- author\*(Aqs name
%(authemail)s   \- author\*(Aqs e\-mail
%(authdate)s    \- patch creation date
%(commname)s    \- committer\*(Aqs name
%(commemail)s   \- committer\*(Aqs e\-mail
.fi
.if n \{\
.RE
.\}
.SH "OPTIONS"
.PP
\-d DIR, \-\-dir DIR
.RS 4
Export patches to DIR instead of the default\&.
.RE
.PP
\-p, \-\-patch
.RS 4
Append \&.patch to the patch names\&.
.RE
.PP
\-e EXTENSION, \-\-extension EXTENSION
.RS 4
Append \&.EXTENSION to the patch names\&.
.RE
.PP
\-n, \-\-numbered
.RS 4
Prefix the patch names with order numbers\&.
.RE
.PP
\-t FILE, \-\-template FILE
.RS 4
Use FILE as a template\&.
.RE
.PP
\-b BRANCH, \-\-branch BRANCH
.RS 4
Use BRANCH instead of the default branch\&.
.RE
.PP
\-s, \-\-stdout
.RS 4
Dump the patches to the standard output\&.
.RE
.PP
\-O OPTIONS, \-\-diff\-opts OPTIONS
.RS 4
Extra options to pass to "git diff"\&.
.RE
.SH "STGIT"
Part of the StGit suite \- see linkman:stg[1]