source: germinate/trunk/fuentes/man/germinate-update-metapackage.1 @ 1914

Last change on this file since 1914 was 1914, checked in by kbut, 5 years ago

update man

File size: 6.4 KB
Line 
1.Dd Jul 18, 2007
2.Os Ubuntu
3.ds volume-operating-system Ubuntu
4.Dt GERMINATE\-UPDATE\-METAPACKAGE 1
5.Sh NAME
6.Nm germinate\-update\-metapackage
7.Nd update a set of metapackages generated from seeds
8.Sh SYNOPSIS
9.Nm
10.Op Fl Fl vcs
11.Op Fl Fl output-directory Ar dir
12.Op Ar dist
13.Sh DESCRIPTION
14.Nm
15assists with the construction and update of
16.Dq metapackages
17(packages consisting solely of a list of dependencies) from a list of seed
18packages.
19It updates binary package stanzas in
20.Pa debian/control
21to reflect the current contents of the seeds, and updates
22.Pa debian/changelog
23with a description of the changes it made.
24.Pp
25.Nm
26requires a configuration file, called
27.Pa update.cfg ,
28in the current directory.
29The format is described below.
30.Pp
31If a non-option argument is given, it specifies the distribution for which
32metapackages should be generated (e.g.\&
33.Dq unstable ) .
34.Sh OPTIONS
35.Bl -tag -width 4n
36.It Fl Fl nodch
37Don't modify
38.Pa debian/changelog .
39.It Fl Fl vcs
40Check out seeds from a version control system rather than fetching them
41directly from a URL.
42Requires
43.Ic bzr
44or
45.Ic git ,
46as appropriate, to be installed.
47The version control system to use is guessed from the
48.Li seed_base
49URL defined in the configuration file, trying
50.Ic git
51then
52.Ic bzr
53if the URL is ambiguous.
54For
55.Ic git ,
56the part after the rightmost
57.Sq \&.
58character of
59.Li seed_dist ,
60if any, is treated as the branch name to check out; this rather strange
61style is for backward compatibility.
62.It Fl Fl bzr
63Check out seeds from the
64.Ic bzr
65branch defined in the configuration file rather than fetching them directly
66from the URL defined there.
67Requires
68.Ic bzr
69to be installed.
70This option is deprecated and is retained for backward compatibility; use
71.Fl Fl vcs
72instead.
73.It Xo Fl o ,
74.Fl Fl output-directory Ar dir
75.Xc
76Output the package lists in the specified directory.
77.El
78.Sh CONFIGURATION FILE
79.Pa update.cfg
80uses Python's ConfigParser configuration file syntax, supporting
81interpolation as defined by SafeConfigParser.
82It should have a
83.Li DEFAULT
84section with a
85.Li dist
86key indicating the default distribution, and a
87.Ar dist
88section (corresponding to that distribution).
89It may also have a
90.Ar dist Ns Li /vcs
91or
92.Ar dist Ns Li /bzr
93section which can override the
94.Li seed_base
95and
96.Li seed_dist
97values from the
98.Ar dist
99section if the
100.Fl Fl vcs
101or
102.Fl Fl bzr
103option respectively is given.
104For backward compatibility, if
105.Fl Fl vcs
106is given, then
107.Ar dist Ns Li /bzr
108will also be consulted.
109.Pp
110The following keys are recognised in distribution sections:
111.Bl -tag -width 4n
112.It Li seeds No (mandatory)
113Pass these seeds to the germinator for processing.
114.It Li output_seeds No (optional, deprecated)
115Generate metapackages for these seeds.
116If not specified, the value of
117.Li seeds
118is used.
119This option is usually no longer necessary now that the value of
120.Li seeds
121is automatically expanded for seed inheritance.
122.It Li architectures No (mandatory)
123Generate metapackages for these architectures.
124.It Li archive_base/default No (optional)
125Use this URL as the default base for fetching package indices from the
126archive; for examples of valid URLs, see
127.Li deb
128lines in
129.Pa /etc/apt/sources.list ,
130or the
131.Ar MIRROR
132argument to
133.Xr debootstrap 8 .
134.It Li archive_base/ Ns Ar arch No (optional)
135Use this URL as the base for fetching package indices from the archive for
136the specified architecture.
137For each architecture being processed, at least one of
138.Li archive_base/default
139and
140.Li archive_base/ Ns Ar arch
141must be present.
142To try multiple URLs, separate them with commas or spaces;
143the newest version of each package across all archives will win.
144Note that
145.Xr debootstrap 8
146will only use the first archive.
147.It Li seed_base No (mandatory)
148The base URL for fetching seeds.
149To try multiple URLs (for example if a seed branch includes another branch
150stored at a different location), separate them with commas or spaces.
151.It Li seed_dist No (optional)
152The tail of the URL for fetching seeds.
153This will be appended to
154.Li seed_base .
155You will often want to interpolate the value of
156.Li dist
157into this value using ConfigParser's
158.Li %(dist)s
159syntax.
160If not specified, the value of
161.Li dist
162is used.
163.It Li dists No (optional)
164The distributions from which to fetch package indices.
165Listing multiple distributions may be useful, for example, when examining
166both a released distribution and its security updates.
167If not specified, the value of
168.Li dist
169is used.
170.It Li components No (mandatory)
171The archive components from which to fetch package indices.
172.It Li seed_map/ Ns Ar seed No (optional, deprecated)
173The seeds to be used as input for the metapackage corresponding to
174.Ar seed .
175If specified, this will typically be the list of seeds from which
176.Ar seed
177inherits, plus
178.Ar seed
179itself.
180This option is usually no longer necessary; use a
181.Li Task\-Seeds
182header in the seed file instead.
183.It Li metapackage_map/ Ns Ar seed No (optional, deprecated)
184The metapackage name to output for
185.Ar seed .
186If not specified,
187.Nm
188will look for the name of the source package in which it is being run,
189remove "meta" from the end, and append the seed name.
190This option is usually no longer necessary; use a
191.Li Task\-Metapackage
192header in the seed file instead.
193.El
194.Sh EXAMPLE
195At the time of writing, the following configuration file is used to generate
196the
197.Li kubuntu-meta
198source package in the Ubuntu archive:
199.Bd -literal -offset indent
200[DEFAULT]
201dist: xenial
202
203[xenial]
204seeds: desktop full active
205architectures: i386 amd64 powerpc armhf arm64 ppc64el
206seed_base: http://people.canonical.com/~ubuntu-archive/seeds/
207seed_dist: kubuntu.%(dist)s
208archive_base/default: http://archive.ubuntu.com/ubuntu/
209archive_base/ports: http://ports.ubuntu.com/ubuntu-ports/
210archive_base/powerpc: %(archive_base/ports)s
211archive_base/armhf: %(archive_base/ports)s
212archive_base/arm64: %(archive_base/ports)s
213archive_base/ppc64el: %(archive_base/ports)s
214components: main restricted universe
215
216[xenial/bzr]
217seed_base: bzr+ssh://bazaar.launchpad.net/~kubuntu-dev/ubuntu-seeds/ bzr+ssh://bazaar.launchpad.net/~ubuntu-core-dev/ubuntu-seeds/
218seed_dist: kubuntu.%(dist)s
219.Ed
220.Sh AUTHORS
221.An Gustavo Franco Aq stratus@debian.org
222.An Colin Watson Aq cjwatson@canonical.com
223.Pp
224.An -nosplit
225.Nm
226is copyright \(co 2004, 2005, 2006, 2007, 2008
227.An Canonical Ltd.
228and
229copyright \(co 2006
230.An Gustavo Franco .
231See the GNU General Public License version 2 or later for copying
232conditions.
233A copy of the GNU General Public License is available in
234.Pa /usr/share/common\-licenses/GPL .
Note: See TracBrowser for help on using the repository browser.