updated git doc
[TortoiseGit.git] / doc / source / en / TortoiseGit / git_doc / git-quiltimport.xml
blob2b6a960a47877d7515f661f6c286027b0a0045ea
1 <?xml version="1.0" encoding="UTF-8"?>\r
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">\r
3 \r
4 <article lang="en" id="git-quiltimport(1)">\r
5 <articleinfo>\r
6     <title>git-quiltimport(1)</title>\r
7 <indexterm>\r
8 <primary>git-quiltimport(1)</primary>\r
9 </indexterm>\r
10 </articleinfo>\r
11 <simplesect id="_name">\r
12 <title>NAME</title>\r
13 <simpara>git-quiltimport - Applies a quilt patchset onto the current branch</simpara>\r
14 </simplesect>\r
15 <simplesect id="_synopsis">\r
16 <title>SYNOPSIS</title>\r
17 <blockquote>\r
18 <literallayout><emphasis>git quiltimport</emphasis> [--dry-run | -n] [--author &lt;author&gt;] [--patches &lt;dir&gt;]</literallayout>\r
19 </blockquote>\r
20 </simplesect>\r
21 <simplesect id="_description">\r
22 <title>DESCRIPTION</title>\r
23 <simpara>Applies a quilt patchset onto the current git branch, preserving\r
24 the patch boundaries, patch order, and patch descriptions present\r
25 in the quilt patchset.</simpara>\r
26 <simpara>For each patch the code attempts to extract the author from the\r
27 patch description.  If that fails it falls back to the author\r
28 specified with --author.  If the --author flag was not given\r
29 the patch description is displayed and the user is asked to\r
30 interactively enter the author of the patch.</simpara>\r
31 <simpara>If a subject is not found in the patch description the patch name is\r
32 preserved as the 1 line subject in the git description.</simpara>\r
33 </simplesect>\r
34 <simplesect id="_options">\r
35 <title>OPTIONS</title>\r
36 <variablelist>\r
37 <varlistentry>\r
38 <term>\r
39 -n\r
40 </term>\r
41 <term>\r
42 --dry-run\r
43 </term>\r
44 <listitem>\r
45 <simpara>\r
46         Walk through the patches in the series and warn\r
47         if we cannot find all of the necessary information to commit\r
48         a patch.  At the time of this writing only missing author\r
49         information is warned about.\r
50 </simpara>\r
51 </listitem>\r
52 </varlistentry>\r
53 <varlistentry>\r
54 <term>\r
55 --author Author Name &lt;Author Email&gt;\r
56 </term>\r
57 <listitem>\r
58 <simpara>\r
59         The author name and email address to use when no author\r
60         information can be found in the patch description.\r
61 </simpara>\r
62 </listitem>\r
63 </varlistentry>\r
64 <varlistentry>\r
65 <term>\r
66 --patches &lt;dir&gt;\r
67 </term>\r
68 <listitem>\r
69 <simpara>\r
70         The directory to find the quilt patches and the\r
71         quilt series file.\r
72 </simpara>\r
73 <simpara>The default for the patch directory is patches\r
74 or the value of the $QUILT_PATCHES environment\r
75 variable.</simpara>\r
76 </listitem>\r
77 </varlistentry>\r
78 </variablelist>\r
79 </simplesect>\r
80 <simplesect id="_git">\r
81 <title>GIT</title>\r
82 <simpara>Part of the <xref linkend="git(1)" /> suite</simpara>\r
83 </simplesect>\r
84 </article>\r