annotate demo.cfg @ 357:eb6445552640

added a small comment about the behaviour of this packager
author Bjoern Ricks <bricks@intevation.de>
date Tue, 18 May 2010 12:13:31 +0000
parents f06f707d9fda
children 2995f3042f82
rev   line source
1
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
1 [DEFAULT]
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
2 # the default section provides defaults for the other sections. Also,
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
3 # other sections can use the values here in interpolations.
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
4
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
5 # The basedir to use for interpolations in other sections
180
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
6 treepkg_dir: /home/builder/mill
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
7
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
8 # basedir for the packager track subdirectories
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
9 tracks_dir: %(treepkg_dir)s/tracks
1
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
10
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
11 # The command to use to gain the permissions to execute pbuilder. The
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
12 # default is sudo. The actual command line used to run pbuilder is
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
13 # root_cmd followed by the pbuilder command line. With the default it
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
14 # is something like
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
15 #
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
16 # sudo pbuilder build <name-of-dsc-file>
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
17 #
2
e6a9f4037f68 readconfig.py is smarter now about conversions and supports shlex
Bernhard Herzog <bh@intevation.de>
parents: 1
diff changeset
18 # The value of this option is split into words with the python function
e6a9f4037f68 readconfig.py is smarter now about conversions and supports shlex
Bernhard Herzog <bh@intevation.de>
parents: 1
diff changeset
19 # shlex.split. See the python documentation for the precise semantics.
103
4224f0bf2168 fix typos
Bernhard Herzog <bh@intevation.de>
parents: 93
diff changeset
20 # shlex.split works pretty much like a POSIX shell but it doesn't
4224f0bf2168 fix typos
Bernhard Herzog <bh@intevation.de>
parents: 93
diff changeset
21 # perform any expansions.
1
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
22 #
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
23 # Set an empty value to indicate that no special command is needed.
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
24 #
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
25 # You can override this in the pkg_ sections if you need package
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
26 # specific values
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
27 root_cmd: sudo
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
28
344
f06f707d9fda merged branches/scratchbox into trunk
Bjoern Ricks <bricks@intevation.de>
parents: 298
diff changeset
29 # The builder config file to use. It should be an absolute filename.
47
2802be410156 add config options pbuilderrc and use it when calling pbuilder
Bernhard Herzog <bh@intevation.de>
parents: 6
diff changeset
30 # The script initpbuilder.py can create it and the rest of the pbuilder
2802be410156 add config options pbuilderrc and use it when calling pbuilder
Bernhard Herzog <bh@intevation.de>
parents: 6
diff changeset
31 # files and directories. You can override this in the pkg_ sections for
344
f06f707d9fda merged branches/scratchbox into trunk
Bjoern Ricks <bricks@intevation.de>
parents: 298
diff changeset
32 # individual packagers if necessary. You will have to adapt e.g. pbuilder
47
2802be410156 add config options pbuilderrc and use it when calling pbuilder
Bernhard Herzog <bh@intevation.de>
parents: 6
diff changeset
33 # yourself, then, though.
344
f06f707d9fda merged branches/scratchbox into trunk
Bjoern Ricks <bricks@intevation.de>
parents: 298
diff changeset
34 builderconfig: %(treepkg_dir)s/pbuilder/pbuilderrc
47
2802be410156 add config options pbuilderrc and use it when calling pbuilder
Bernhard Herzog <bh@intevation.de>
parents: 6
diff changeset
35
2802be410156 add config options pbuilderrc and use it when calling pbuilder
Bernhard Herzog <bh@intevation.de>
parents: 6
diff changeset
36
1
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
37 # Email address and name to use as the packager in the debian packages.
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
38 # You can override this in the pkg_ sections if you need package
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
39 # specific values
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
40 deb_email: packager@example.com
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
41 deb_fullname: Sample Packager
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
42
298
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
43 # specify debian build options. The value specified here will be passed
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
44 # through to the build process in the environment variable
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
45 # DEB_BUILD_OPTIONS. You can override the value in the pkg_ sections.
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
46 #
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
47 # For example, you can use the following setting to indicate to the
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
48 # build process that make should use two processes in parallel when
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
49 # building the software:
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
50 #
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
51 # deb_build_options: parallel=2
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
52 #
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
53 # Note: When using pbuilder via sudo (see root_cmd option) make sure
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
54 # that sudo does not strip DEB_BUILD_OPTIONS and DEB_BUILD_PARALLEL from
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
55 # the environment (the latter variable is needed for packages that use
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
56 # cdbs, it's automatically set by the tree packager).
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
57 #deb_build_options:
e9d5b44f8f52 Add a paragraph about the new option deb_build_options to demo.cfg.
Bernhard Herzog <bh@intevation.de>
parents: 295
diff changeset
58
294
aed96809160c Update the sample configuration
Bernhard Herzog <bh@intevation.de>
parents: 291
diff changeset
59 # Template for the package revision. The template should include the
aed96809160c Update the sample configuration
Bernhard Herzog <bh@intevation.de>
parents: 291
diff changeset
60 # specifier "%(pkg_revision)d" which will be replaced by the revision
aed96809160c Update the sample configuration
Bernhard Herzog <bh@intevation.de>
parents: 291
diff changeset
61 # number of the package (usually 1). Note, that since the format used
aed96809160c Update the sample configuration
Bernhard Herzog <bh@intevation.de>
parents: 291
diff changeset
62 # by the config file also uses %-based interpolation the %-character has
aed96809160c Update the sample configuration
Bernhard Herzog <bh@intevation.de>
parents: 291
diff changeset
63 # to be doubled.
aed96809160c Update the sample configuration
Bernhard Herzog <bh@intevation.de>
parents: 291
diff changeset
64 # E. g. with a prefix "treepkg%(pkg_revision)d", the default, a
aed96809160c Update the sample configuration
Bernhard Herzog <bh@intevation.de>
parents: 291
diff changeset
65 # generated package might be named foo_1.0-treepkg1_all.deb
295
dcdf23dece2d Correct the update of the sample configuration
Bernhard Herzog <bh@intevation.de>
parents: 294
diff changeset
66 pkg_revision_template: treepkg%%(pkg_revision)d
93
73c67372c7f7 Make the prefix used in the debian revision number configurable.
Bernhard Herzog <bh@intevation.de>
parents: 92
diff changeset
67
291
7b00edc5bf66 fix typo
Bernhard Herzog <bh@intevation.de>
parents: 257
diff changeset
68 # Whether to handle dependencies between packagers. This is useful if
7b00edc5bf66 fix typo
Bernhard Herzog <bh@intevation.de>
parents: 257
diff changeset
69 # the tree packager is to build a library and a program using the
7b00edc5bf66 fix typo
Bernhard Herzog <bh@intevation.de>
parents: 257
diff changeset
70 # library, each with their own debian source packages and repositories.
7b00edc5bf66 fix typo
Bernhard Herzog <bh@intevation.de>
parents: 257
diff changeset
71 # With dependency handling the library will always be updated before the
133
a13850c3be85 Update demo.cfg: add option for dependency handling, adapt
Bernhard Herzog <bh@intevation.de>
parents: 130
diff changeset
72 # program and the binary packages of the library will be made available
a13850c3be85 Update demo.cfg: add option for dependency handling, adapt
Bernhard Herzog <bh@intevation.de>
parents: 130
diff changeset
73 # to the pbuilder instance, so that the program will be built against
a13850c3be85 Update demo.cfg: add option for dependency handling, adapt
Bernhard Herzog <bh@intevation.de>
parents: 130
diff changeset
74 # them.
a13850c3be85 Update demo.cfg: add option for dependency handling, adapt
Bernhard Herzog <bh@intevation.de>
parents: 130
diff changeset
75 # You can override this in the pkg_ sections if you need package
a13850c3be85 Update demo.cfg: add option for dependency handling, adapt
Bernhard Herzog <bh@intevation.de>
parents: 130
diff changeset
76 # specific values
a13850c3be85 Update demo.cfg: add option for dependency handling, adapt
Bernhard Herzog <bh@intevation.de>
parents: 130
diff changeset
77 handle_dependencies: False
a13850c3be85 Update demo.cfg: add option for dependency handling, adapt
Bernhard Herzog <bh@intevation.de>
parents: 130
diff changeset
78
1
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
79
180
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
80 # Uncomment and insert the ID of the key with which to sign .dsc, .changes the
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
81 # Release file in the pbuilder's extra-pkg directory.
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
82 # You can override this in the pkg_ sections if you need package
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
83 # specific values
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
84 #signing_key_id:
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
85
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
86
1
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
87 [treepkg]
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
88 # Section for general tree packager configuration
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
89
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
90 # Interval in seconds between checks for updates
180
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
91 check_interval: 3600
1
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
92
92
1c74e3b56a63 Add instructions_file setting to demo.cfg
Bernhard Herzog <bh@intevation.de>
parents: 47
diff changeset
93 # file used to communicate instructions to a running tree packager
1c74e3b56a63 Add instructions_file setting to demo.cfg
Bernhard Herzog <bh@intevation.de>
parents: 47
diff changeset
94 instructions_file: %(treepkg_dir)s/instructions
1c74e3b56a63 Add instructions_file setting to demo.cfg
Bernhard Herzog <bh@intevation.de>
parents: 47
diff changeset
95
1
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
96
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
97 [pkg_kdepim]
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
98 # Sections with names starting with "pkg_" define the configuration for
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
99 # a package.
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
100
3
7e9db903ba16 more infos about svn_url
Bernhard Herzog <bh@intevation.de>
parents: 2
diff changeset
101 # The SVN URL to check out for packaging. Will only be used for the
7e9db903ba16 more infos about svn_url
Bernhard Herzog <bh@intevation.de>
parents: 2
diff changeset
102 # initial checkout
1
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
103 svn_url: svn://anonsvn.kde.org/home/kde/branches/kdepim/enterprise/kdepim
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
104
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
105 # The directory under which the packager directory structure will be
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
106 # created.
180
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
107 base_dir: %(tracks_dir)s/kdepim
1
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
108
6
38330d45047f Adapt demo.cfg to the new packager classes
Bernhard Herzog <bh@intevation.de>
parents: 3
diff changeset
109 # The packager class defines how the packaging works. The
38330d45047f Adapt demo.cfg to the new packager classes
Bernhard Herzog <bh@intevation.de>
parents: 3
diff changeset
110 # enterprise.kdepim class knows how to package the enterprise branch of
38330d45047f Adapt demo.cfg to the new packager classes
Bernhard Herzog <bh@intevation.de>
parents: 3
diff changeset
111 # KDE-PIM.
133
a13850c3be85 Update demo.cfg: add option for dependency handling, adapt
Bernhard Herzog <bh@intevation.de>
parents: 130
diff changeset
112 packager_class: recipes.kde_enterprise_3_5.kdepim
6
38330d45047f Adapt demo.cfg to the new packager classes
Bernhard Herzog <bh@intevation.de>
parents: 3
diff changeset
113
1
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
114 # Required fields for a pkg_ section inherited from the DEFAULT section
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
115 # in this example: root_cmd deb_email deb_fullname
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
116
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
117 # An additional option, name, is inferred from the section name. Its
02d5702314a3 add demo.cfg
Bernhard Herzog <bh@intevation.de>
parents:
diff changeset
118 # value is the part of the section name after the pkg_ prefix.
6
38330d45047f Adapt demo.cfg to the new packager classes
Bernhard Herzog <bh@intevation.de>
parents: 3
diff changeset
119
38330d45047f Adapt demo.cfg to the new packager classes
Bernhard Herzog <bh@intevation.de>
parents: 3
diff changeset
120
104
c0c93d242438 Better default values for the kde-i18n section of demo.cfg
Bernhard Herzog <bh@intevation.de>
parents: 103
diff changeset
121 [pkg_kde-i18n]
6
38330d45047f Adapt demo.cfg to the new packager classes
Bernhard Herzog <bh@intevation.de>
parents: 3
diff changeset
122 # Another packager. This one for the the localizations. This packager
130
84a1716827f8 Fix typo in comment in demo.cfg
Bernhard Herzog <bh@intevation.de>
parents: 104
diff changeset
123 # requires an additional parameter, orig_tarball.
6
38330d45047f Adapt demo.cfg to the new packager classes
Bernhard Herzog <bh@intevation.de>
parents: 3
diff changeset
124 svn_url: svn://anonsvn.kde.org/home/kde/branches/kdepim/enterprise/kde-l10n
180
12e4efd5cc74 Update demo.cfg with better defaults and a new paragraph for the
Bernhard Herzog <bh@intevation.de>
parents: 133
diff changeset
125 base_dir: %(tracks_dir)s/kde-i18n
104
c0c93d242438 Better default values for the kde-i18n section of demo.cfg
Bernhard Herzog <bh@intevation.de>
parents: 103
diff changeset
126 orig_tarball: %(base_dir)s/kde-i18n-de-3.5.5.tar.bz2
6
38330d45047f Adapt demo.cfg to the new packager classes
Bernhard Herzog <bh@intevation.de>
parents: 3
diff changeset
127
133
a13850c3be85 Update demo.cfg: add option for dependency handling, adapt
Bernhard Herzog <bh@intevation.de>
parents: 130
diff changeset
128 packager_class: recipes.kde_enterprise_3_5.kde_i18n
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)