blob: 26dc5230ed5f2885a594a4b016a37466813f9254 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
<chapter id="gbp.cfgfile">
<title>Configuration files</title>
<para>Three configuration files are parsed in this order:
<variablelist>
<varlistentry>
<term>/etc/git-buildpackage/gbp.conf</term>
<listitem><para>system wide configuraton</para></listitem>
</varlistentry>
<varlistentry>
<term>~/.gbp.conf</term>
<listitem><para>per user configuration</para></listitem>
</varlistentry>
<varlistentry>
<term>.git/gbp.conf</term>
<listitem><para>per working copy configuration</para></listitem>
</varlistentry>
</variablelist>
All three have the same format. They consist of (at most) four sections, all of them are optional:
<variablelist>
<varlistentry>
<term>[DEFAULT]</term>
<listitem><para>Options in this section apply to &git-buildpackage;,
&git-import-orig; and &git-import-dsc;.</para></listitem>
</varlistentry>
<varlistentry>
<term>[git-buildpackage]</term>
<listitem><para>Options in this section apply to &git-buildpackage; only and override options from the
[DEFAULT] section.</listitem>
</varlistentry>
<varlistentry>
<term>[git-import-orig]</term>
<listitem><para>Options in this section apply to &git-import-orig; only and override options from the
[DEFAULT] section.</listitem>
</varlistentry>
<varlistentry>
<term>[git-import-dsc]</term>
<listitem><para>Options in this section apply to &git-import-dsc; only and override options from the
[DEFAULT] section.</listitem>
</varlistentry>
</variablelist>
The actual options in these sections are the command line options without
the '--' prefix. So <option>--upstream-branch=</option><replaceable>dfsgfree</replaceable> would read:
<screen>
<option>upstream-branch</option>=<replaceable>dfsgfree</replaceable>
</screen>
in the config file. In the special case of &git-buildpackage; the stripped
prefix is not '--' but '--git-'.
Here's a full example:
<screen>
[DEFAULT]
# the default build command
builder=debuild
# the default branch for upstream sources
upstream-branch=upstream
# the default branch for the debian patch
debian-branch=master
# Special options for git-buildpackage
[git-buildpackage]
upstream-branch=dfsgclean
# Sign tags with GPG:
sign-tags = True
# Keyid to sign tags with
#keyid = 0xdeadbeef
# Special options for git-import-orig
[git-import-orig]
upstream-branch=notdfsgclean
# Special options for git-import-dsc
[git-import-dsc]
upstream-branch=notdfsgclean
</screen>
</para>
</chapter>
|