1 debian-policy (3.9.3.0) UNRELEASED; urgency=low
4 * Policy: Improve Architecture field in source package
5 Wording: Raphaël Hertzog <hertzog@debian.org>
6 Seconded: Russ Allbery <rra@debian.org>
7 Seconded: Charles Plessy <plessy@debian.org>
8 Seconded: Guillem Jover <guillem@debian.org>
10 * Consistently use "Debian source control file" for *.dsc files and
11 "Source package control file" for debian/control files. Patch from
12 Charles Plessy. (Closes: #626796)
13 * Add the release date of 3.9.2.0 to upgrading-checklist.
14 * Fix ordering of the last entries in the 3.9.2.0 upgrading-checklist.
15 * Fix typo in upgrading-checklist entry for multiarch paths. Thanks,
16 Michael Dorrington. Closes: #626408
17 * Add AGPL-3 to tools/license-count.
20 * Policy: Link relationship fields (7.1) to architecture specification
22 Patch from Charles Plessy in #628174.
23 * Policy: Retire legacy Motif policy (11.8.8)
24 Proposed by: Justin B Rye
25 Wording: Russ Allbery <rra@debian.org>
26 Seconded: Jakub Wilk <jwilk@debian.org>
27 Seconded: Steve Langasek <vorlon@debian.org>
28 Seconded: Charles Plessy <plessy@debian.org>
30 * copyright-format: Fix URL for the Eiffel Forum License.
31 Reported by Thomas Preud'homme, patch by Charles Plessy.
33 * copyright-format: Update SPDX link to point to the SPDX license registry.
34 Patch by Charles Plessy. Closes: #628540
35 * Policy: Clarify that 'machine-extractable' referer the copyright
37 Wording: Charles Plessy <plessy@debian.org>
38 Seconded: Bill Allombert <ballombe@debian.org>
39 Seconded: Jakub Wilk <jwilk@debian.org>
41 * copyright-format: remove drivers from abstract and useless appendix
42 Wording: Lars Wirzenius <liw@liw.fi>
43 Seconded: Charles Plessy <plessy@debian.org>
44 Seconded: Jakub Wilk <jwilk@debian.org>
46 * Perl policy: Document major version upgrade trigger
47 Wording: Dominic Hargreaves <dom@debian.org>
48 Seconded: Russ Allbery <rra@debian.org>
49 Seconded: Niko Tyni <ntyni@debian.org>
50 Seconded: Gregor Herrmann <gregoa@debian.org>
52 * Virtual: change ttf-japanese-{mincho, gothic} to
53 fonts-japanese-{mincho, gothic}.
54 Proposed by: Nobuhiro Iwamatsu <iwamatsu@nigauri.org>
55 Seconded: Charles Plessy <plessy@debian.org>
56 Seconded: Bill Allombert <ballombe@debian.org>
59 -- Bill Allombert <ballombe@debian.org> Tue, 11 Oct 2011 10:39:15 +0200
61 debian-policy (3.9.2.0) unstable; urgency=low
63 * Policy: Require human Maintainer or Uploader, clarify Maintainer
64 Wording: Russ Allbery <rra@debian.org>
65 Seconded: Charles Plessy <plessy@debian.org>
66 Seconded: Raphaël Hertzog <hertzog@debian.org>
67 Closes: #459868, #581011
68 * Policy: Add an FHS exception on GNU/Hurd for /hurd and /servers
69 Wording: Russ Allbery <rra@debian.org>
70 Seconded: Andrew McMillan <andrew@morphoss.com>
71 Seconded: Guillem Jover <guillem@debian.org>
73 * Policy: Document DM-Upload-Allowed
74 Wording: Charles Plessy <plessy@debian.org>
75 Seconded: Andrew McMillan <andrew@morphoss.com>
76 Seconded: Russ Allbery <rra@debian.org>
78 * Policy: Update multiarch FHS exception for i386 naming
79 Wording: Steve Langasek <vorlon@debian.org>
80 Seconded: Aurelien Jarno <aurelien@aurel32.net>
81 Seconded: Raphael Hertzog <hertzog@debian.org>
83 * Policy: Significant additions to maintainer script documentation
84 Wording: Russ Allbery <rra@debian.org>
85 Seconded: Steve Langasek <vorlon@debian.org>
86 Seconded: Raphaël Hertzog <hertzog@debian.org>
88 * Policy: Clarify format of Debian control fields
89 Wording: Charles Plessy <plessy@debian.org>
90 Seconded: Russ Allbery <rra@debian.org>
91 Seconded: Julien Cristau <jcristau@debian.org>
92 Closes: #501930, #593909
93 * Virtual: Added mailx as a new virtual package
94 Wording: Russ Allbery <rra@debian.org>
95 Seconded: Raphaël Hertzog <hertzog@debian.org>
96 Seconded: Giacomo A. Catenazzi <cate@debian.org>
98 * Be more verbose in defining the build architecture and the host
99 architecture and consistently refer to architecture rather than
100 machine. (Closes: #591857)
101 * Correct the name of the Filesystem Hierarchy Standard in the package
102 description. Patch from Christoph Anton Mitterer. (Closes: #590696)
103 * Use the word "implemented" to describe required targets in
104 debian/rules, which is clearer about allowing wildcard rules. List
105 the required rules in their own paragraph rather than with the
106 paragraph discussing non-interactivity, and explicitly mark all rules
107 as either required or optional. (Closes: #536790)
108 * Update the ldconfig footnote listing the /etc/ld.so.conf directories
109 to remove the libc5 compatibility directories and mention the
110 multiarch triplet directories. Based on a patch by Charles Plessy.
112 * Add introductory paragraphs for each archive area explaining briefly
113 the purpose of that archive area. Based on a proposal by CJ
114 Fearnley. (Closes: #594542)
115 * Change all non-historical references to Debian GNU/Linux to simply
116 Debian since Debian now includes FreeBSD-based architectures. Patch
117 from Guillem Jover. (Closes: #594656)
118 * Remove references to the obsolete debmake package.
119 * Update the list of Policy maintainers.
120 * Wrap Uploaders in debian/control.
121 * Move Build-Depends-Indep to Build-Depends (there's no reason to use
122 -Indep in a package that builds only architecture-independent binary
123 packages), wrap it, and remove version restrictions that are older
124 than the version in oldstable.
125 * Add emacs23 to the build dependencies and remove the files generated
126 from org source from the revision control repository. Build and clean
127 files from org source unconditionally. Add Process.{txt,html} to the
128 list of files generated from org source. (Closes: #594274)
129 * Fix URLs under www.freedesktop.org to avoid permanent redirects.
130 Thanks, David Prévot. (Closes: #606869)
131 * Add a cross-reference to the Pre-Depends requirement in 3.5 to section
132 7.2 where Pre-Depends is defined. Thanks, Mattias Ellert and Jonathan
133 Nieder. (Closes: #599944)
134 * Include the new (optional) copyright format that was drafted as DEP-5.
135 This is not yet a final version; that's expected to come in the
136 3.9.3.0 release. Thanks to all the DEP-5 contributors and to Lars
137 Wirzenius and Charles Plessy for the integration into the Policy
138 package. (Closes: #609160)
140 -- Russ Allbery <rra@debian.org> Wed, 06 Apr 2011 22:48:55 -0700
142 debian-policy (3.9.1.0) unstable; urgency=low
144 * Policy: Include GPL version 1 in common-licenses
145 Wording: Russ Allbery <rra@debian.org>
146 Seconded: gregor herrmann <gregoa@debian.org>
147 Seconded: Damyan Ivanov <dmn@debian.org>
148 Seconded: Giacomo A. Catenazzi <cate@debian.org>
150 * Policy: Libtool *.la files should generally not be installed
151 Wording: Russ Allbery <rra@debian.org>
152 Seconded: Julien Cristau <jcristau@debian.org>
153 Seconded: Cyril Brulebois <kibi@debian.org>
155 * Policy: Require dpkg-divert --package when adding/removing diversions
156 Wording: Russ Allbery <rra@debian.org>
157 Seconded: Raphaël Hertzog <hertzog@debian.org>
158 Seconded: Raphael Geissert <geissert@debian.org>
160 * Policy: Remove encouragement to create shlibs.local
161 Wording: Russ Allbery <rra@debian.org>
162 Seconded: Julien Cristau <jcristau@debian.org>
163 Seconded: Jakub Wilk <jwilk@debian.org>
164 Seconded: Cyril Brulebois <kibi@debian.org>
165 * Policy: Document alternate SONAME format with version before .so
166 Wording: Russ Allbery <rra@debian.org>
167 Seconded: Julien Cristau <jcristau@debian.org>
168 Seconded: Raphaël Hertzog <hertzog@debian.org>
170 * Policy: Architecture wildcards also allowed in binary relationships
171 Wording: Russ Allbery <rra@debian.org>
172 Seconded: Guillem Jover <guillem@debian.org>
173 Seconded: Raphaël Hertzog <hertzog@debian.org>
175 * Policy: Say Conflicts should not be used unless necessary
176 Wording: Russ Allbery <rra@debian.org>
177 Seconded: Guillem Jover <guillem@debian.org>
178 Seconded: Jakub Wilk <jwilk@debian.org>
180 * Policy: Remove obsolete _REENTRANT, require thread-safe libraries
181 Wording: Russ Allbery <rra@debian.org>
182 Seconded: Kurt Roeckx <kurt@roeckx.be>
183 Seconded: Giacomo A. Catenazzi <cate@debian.org>
185 * Policy: Allow subdirectories of /usr/lib/cgi-bin to be used
186 Wording: Russ Allbery <rra@debian.org>
187 Seconded: Andrew McMillan <andrew@morphoss.com>
188 Seconded: Charles Plessy <plessy@debian.org>
190 * Policy: More specific requirements around date-based versions
191 Wording: Russ Allbery <rra@debian.org>
192 Seconded: Julien Cristau <jcristau@debian.org>
193 Seconded: Cyril Brulebois <kibi@debian.org>
194 Seconded: Steve Langasek <vorlon@debian.org>
196 * Policy: Require slave alternatives for manual pages
197 Wording: Russ Allbery <rra@debian.org>
198 Seconded: Guillem Jover <guillem@debian.org>
199 Seconded: Jakub Wilk <jwilk@debian.org>
200 Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
202 * Policy: More explicit requirements around library SONAMEs
203 Wording: Russ Allbery <rra@debian.org>
204 Seconded: Raphaël Hertzog <hertzog@debian.org>
205 Seconded: Emilio Pozuelo Monfort <pochu27@gmail.com>
207 * Policy: Only dpkg-gencontrol supports variable substitutions
208 Wording: Charles Plessy <plessy@debian.org>
209 Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
210 Seconded: Guillem Jover <guillem@debian.org>
212 * Policy: Ada Library Information files must be read-only
213 Wording: Russ Allbery <rra@debian.org>
214 Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
215 Seconded: Ludovic Brenta <ludovic@ludovic-brenta.org>
217 * Policy: Recommend /etc/logrotate.d/package for logrotate rules
218 Wording: Russ Allbery <rra@debian.org>
219 Seconded: Guillem Jover <guillem@debian.org>
220 Seconded: Thijs Kinkhorst <thijs@debian.org>
222 * Policy: Allow /bin/sh scripts to rely on XSI for kill and trap
223 Wording: Russ Allbery <rra@debian.org>
224 Seconded: Giacomo A. Catenazzi <cate@debian.org>
225 Seconded: Raphael Geissert <geissert@debian.org>
227 * Policy: Ownership and permissions for control information files
228 Wording: Russ Allbery <rra@debian.org>
229 Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
230 Seconded: Julien Cristau <jcristau@debian.org>
232 * Set the version of the Perl Policy to match the version of the Policy
234 * Explain the Perl module package naming policy more explicitly and
235 provide some examples. (Closes: #175202)
236 * Revise the footnote discussing shlibs creation to not talk about the
237 switch to objdump as if it were a new innovation and to explicitly
238 mention the NEEDED attribute as the source of dependency information.
239 * Introduce "control information file" to refer to the contents of the
240 Debian package control.tar.gz, following the dpkg documentation. Use
241 that terminology consistently, and change possibly confusing
242 references to fields in control files to use "control field"
244 * Document that the first line of the changelog entry is conventionally
245 an explanation for the upload if the uploader is not the regular
246 maintainer. Patch from Charles Plessy. (Closes: #589605)
247 * Fix typo in upgrading-checklist. (Closes: #588750)
248 * Fix formatting error in footnote to 7.7. (Closes: #589362)
249 * Remove ancient Conflicts and Replaces.
251 -- Russ Allbery <rra@debian.org> Sun, 25 Jul 2010 19:38:21 -0700
253 debian-policy (3.9.0.0) unstable; urgency=low
256 * Fix path to changelog.Debian.gz in footnote on documentation symlinks.
259 * Convert upgrading-checklist to debiandoc-sgml. This generates a better
262 * Fix typo in package_upstream-version.orig.tar.gz.
263 Thanks, Salvatore Bonaccorso. (Closes: #558430)
264 * Replace 'copyright and distribution license' by 'copyright information
265 and distribution license' (three times).
266 Proposed by Jonathan Nieder.
267 Seconded: Steve Langasek <vorlon@debian.org>
268 Seconded: Thijs Kinkhorst <thijs@debian.org>
269 Seconded: Julien Cristau <jcristau@debian.org>
270 Seconded: Gregor Herrmann <gregoa@debian.org>
272 * extend UID range of user accounts by removing the 30000-59999 reserved
274 Proposed by Santiago Vila
275 Seconded: Russ Allbery <rra@debian.org>
276 Seconded: Luk Claes <luk@debian.org>
277 Seconded: Raphael Hertzog <hertzog@debian.org>
278 Seconded: Steve Langasek <vorlon@debian.org>
282 * Policy: Overhaul Breaks, Conflicts, Provides, and Replaces
283 Wording: Russ Allbery <rra@debian.org>
284 Seconded: Steve Langasek <vorlon@debian.org>
285 Seconded: Raphael Hertzog <hertzog@debian.org>
287 * Policy: Support for architecture wildcards
288 Wording: Manoj Srivastava <srivasta@debian.org>
289 Wording: Russ Allbery <rra@debian.org>
290 Seconded: Guillem Jover <guillem@debian.org>
291 Seconded: Andrew McMillan <andrew@morphoss.com>
292 Seconded: Steve Langasek <vorlon@debian.org>
294 * Policy: Except init.d scripts from the normal set -e requirement
295 Wording: Russ Allbery <rra@debian.org>
296 Seconded: Raphael Hertzog <hertzog@debian.org>
297 Seconded: Guillem Jover <guillem@debian.org>
299 * Policy: Maintainer scripts might not have a controlling terminal
300 Wording: Russ Allbery <rra@debian.org>
301 Seconded: Guillem Jover <guillem@debian.org>
302 Seconded: Andrew McMillan <andrew@morphoss.com>
303 Seconded: Steve Langasek <vorlon@debian.org>
305 * Policy: Fully specify the date format for changelog entries
306 Wording: Charles Plessy <plessy@debian.org>
307 Seconded: Russ Allbery <rra@debian.org>
308 Seconded: Andrew McMillan <andrew@morphoss.com>
309 Seconded: Giacomo A. Catenazzi <cate@debian.org>
311 * Policy: Deprecate /usr/share/common-licenses/BSD
312 Wording: Russ Allbery <rra@debian.org>
313 Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
314 Seconded: Jakub Wilk <jwilk@debian.org>
315 Seconded: gregor herrmann <gregoa@debian.org>
317 * Policy: Document Checksums-Sha1 and Checksums-Sha256
318 Wording: Russ Allbery <rra@stanford.edu>
319 Seconded: Julien Cristau <jcristau@debian.org>
320 Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
322 * Policy: Prohibit duplicate field names in a control paragraph
323 Wording: Russ Allbery <rra@debian.org>
324 Seconded: Charles Plessy <plessy@debian.org>
325 Seconded: Steve Langasek <vorlon@debian.org>
326 Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
328 * Policy: Relax requirement that library dev files be in one package
329 Wording: Russ Allbery <rra@debian.org>
330 Seconded: Julien Cristau <jcristau@debian.org>
331 Seconded: Andrew McMillan <andrew@morphoss.com>
333 * Policy: Tighten requirements for maintainer-like fields
334 Wording: Russ Allbery <rra@debian.org>
335 Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
336 Seconded: Andrew McMillan <andrew@morphoss.com>
338 * Policy: Update Format control field documentation
339 Wording: Russ Allbery <rra@debian.org>
340 Wording: Charles Plessy <plessy@debian.org>
341 Seconded: Charles Plessy <plessy@debian.org>
342 Seconded: Emilio Pozuelo Monfort <pochu27@gmail.com>
344 * Debconf: Add SETTITLE, like title but uses a template
345 Wording: Frans Pop <elendil@planet.nl>
346 Seconded: Russ Allbery <rra@debian.org>
347 Seconded: Ben Pfaff <blp@cs.stanford.edu>
349 * Perl Policy: Change perlapi provides to use an ABI version
350 Wording: Niko Tyni <ntyni@debian.org>
351 Seconded: Russ Allbery <rra@debian.org>
352 Seconded: Brendan O'Dea <bod@debian.org>
353 Seconded: Damyan Ivanov <dmn@debian.org>
355 * Perl Policy: Recommend DESTDIR instead of PREFIX with Makefile.PL
356 Wording: Niko Tyni <ntyni@debian.org>
357 Seconded: Russ Allbery <rra@debian.org>
358 Seconded: Raphael Hertzog <hertzog@debian.org>
360 * Standardize dpkg state wording and bring it in line with dpkg,
361 renaming Failed-Config to Half-Configured and use uniform
362 capitalization and punctuation. (Closes: #442134)
363 * Remove documentation of alternative changelog formats. This feature
364 is not allowed in the Debian archive and will be documented in the
365 dpkg-dev documentation instead. The documentation that was in Policy
366 was also somewhat outdated. (Closes: #555009, see #584141)
367 * Remove obsolete footnote sentence saying that dpkg-statoverride is a
368 new feature and not well-known. (Closes: #563425)
369 * Clarify in the Perl Policy that perl-base is essential, not perl, and
370 don't imply packages need to depend on perl-base. (Closes: #576594)
371 * Document the special debian-installer section in the list of current
372 sections and add a link to the list of sections in unstable, which
373 contains longer descriptions. (Closes: #577666)
374 * Remove the footnote listing every architecture known to dpkg. This
375 list can be trivially produced by dpkg-architecture -L (already
376 noted), is very long, and quickly becomes out-of-date.
377 * Move silly version ordering example to a footnote. (Closes: #560839)
378 * Reletter the process steps to not skip State C and use more
379 traditional foreground and background colors for Process.html and
380 README.html. (Closes: #584521)
381 * Fix typo in footnote about help2man. (Closes: #584796)
382 * Add an example for Replaces when a package is split. Thanks, Uwe
383 Kleine-König. (Closes: #572253)
384 * Explicitly state that packages may remove unmodified, obsolete
385 configuration files during upgrade. (Closes: #470633)
386 * Clarify the wording around which build dependencies must be satisfied
387 for different debian/rules targets and add a footnote to the
388 description of the build-arch and build-indep targets explaining why
389 this split does not currently work as desired. (Closes: #328951)
390 * Avoid "Debianised" or "Debianized" in favor of just "Debian" or
391 "Debian package" as appropriate. Patch from Ben Finney.
393 * Switch to source format 3.0 (native).
395 -- Russ Allbery <rra@debian.org> Sun, 27 Jun 2010 21:40:52 -0700
397 debian-policy (3.8.4.0) unstable; urgency=low
400 * Also provide documents in single-file HTML format.
401 Proposed by Jari Aalto.
403 * Number the DFSG points like in the social_contract document.
404 Proposed by Enrico Zini.
408 * [b270d2d]: Typo fix: relayed -> related. Thanks to Matt Kraai for
411 Policy: Grant an FHS exception for the multiarch library directories
412 Wording: Steve Langasek.
413 Seconded: Aurelien Jarno
414 Seconded: Julien Cristau
415 Seconded: Kurt Roeckx
418 virtual package list: Added Doom virtual packages
419 Wording: Manoj Srivastava
420 Seconded: Russ Allbery
421 Seconded: Giacomo A. Catenazzi
424 README Process upgrading-checklist: Created/converted to org-mode
425 Wording: Manoj Srivastava
426 Seconded: Russ Allbery
428 * [4da0692]: [typo-fixes]:
429 policy: Fix a number of grammatical or typographical errors
430 wording: Eric Dantan Rzewnicki
431 Seconded: Manoj Srivastava
432 * [112c4bc]: FHS Exceptions
433 policy: Explicitly allow /selinux and /sys as FHS exceptions
434 Wording: Manoj Srivastava
435 Seconded: Russ Allbery <rra@debian.org>
436 Seconded: Kurt Roeckx <kurt@roeckx.be>
438 This patch explicitly allows /sys and /selinux as additional
439 directories in the root file system allowed under the policy.
440 * [16afbcb]: Clarify ./debian/rules #! line
441 policy: Clarify rule for debian/rules shebang line
442 Wording: Ben Finney <ben+debian@benfinney.id.au>
443 Seconded: Kurt Roeckx <kurt@roeckx.be>
444 Seconded: Russ Allbery <rra@debian.org>
445 Seconded: Manoj Srivastava <srivasta@debian.org>
446 Explicitly state that "make -f debian/rules" and "./debian/rules"
447 must behave identically, to prevent confusion, and to promote
448 reproducibility, and conform to the principle of least surprise.
449 * [dab93b2]: Add a cron-daemon virtual package
450 policy, virtual package list: New virtual package: cron-daemon
451 wording: Javier Fernández-Sanguino Peña, Manoj Srivastava
452 Seconded: Russ Allbery <rra@debian.org>
453 Seconded: Kurt Roeckx <kurt@roeckx.be>
455 Create a virtual cron daemon package that:
456 - Has to provide /usr/bin/crontab and support crontab entries
457 - Correct execution of /etc/cron.d
458 - Correct support of /etc/crontab
459 - Support of crontab entries with names for days and months,
461 - Correct execution of /etc/cron.{hourly,daily,weekly,monthly}
464 * Policy: Clarify policy on named pipes in packages
465 Wording: Russ Allbery <rra@debian.org>
466 Seconded: Manoj Srivastava <srivasta@debian.org>
467 Seconded: Andrew McMillan <andrew@morphoss.com>
468 * Change the sole occurrence of MUST to must for consistency and to
469 avoid confusion with IETF RFC keywords. Thanks, Jakub Wilk.
472 -- Bill Allombert <ballombe@debian.org> Wed, 27 Jan 2010 19:22:43 +0100
474 debian-policy (3.8.3.0) unstable; urgency=low
476 * Policy: Bring Architecture description in line with dpkg-source
477 Wording: Russ Allbery <rra@debian.org>
478 Seconded: Raphael Hertzog <hertzog@debian.org>
479 Seconded: Manoj Srivastava <srivasta@debian.org>
481 * Policy: Update information about DEB_*_ARCH variables
482 Wording: Guillem Jover <guillem@debian.org>
483 Seconded: Russ Allbery <rra@debian.org>
484 Seconded: Andrew McMillan <andrew@morphoss.com>
486 * Policy: Remove support for uploads to multiple distributions
487 Wording: Russ Allbery <rra@debian.org>
488 Seconded: Raphael Hertzog <hertzog@debian.org>
489 Seconded: Manoj Srivastava <srivasta@debian.org>
491 * Policy: Remove permission for packages to modify ld.so.conf
492 Wording: Steve Langasek <vorlon@debian.org>
493 Seconded: Russ Allbery <rra@debian.org>
494 Seconded: Kurt Roeckx <kurt@roeckx.be>
495 Seconded: Adeodato Simó <dato@net.com.org.es>
496 Seconded: Julien Cristau <jcristau@debian.org>
498 * Policy: Clarify X installation directory handling
499 Wording: Russ Allbery <rra@debian.org>
500 Seconded: Julien Cristau <jcristau@debian.org>
501 Seconded: Manoj Srivastava <srivasta@debian.org>
502 Seconded: Raphaël Hertzog <hertzog@debian.org>
504 * Policy: Localized man pages should be up-to-date or warn
505 Wording: Russ Allbery <rra@debian.org>
506 Seconded: Julien Cristau <jcristau@debian.org>
507 Seconded: Raphaël Hertzog <hertzog@debian.org>
509 * Policy: Remove restriction on manual page character encoding
510 Wording: Colin Watson <cjwatson@debian.org>
511 Seconded: Russ Allbery <rra@debian.org>
512 Seconded: Manoj Srivastava <srivasta@golden-gryphon.com>
514 * Policy: Allow Binary field to span multiple lines
515 Wording: Russ Allbery <rra@debian.org>
516 Seconded: Julien Cristau <jcristau@debian.org>
517 Seconded: Guillem Jover <guillem@debian.org>
519 * Policy: Revise info requirements for triggerized install-info
520 Wording: Russ Allbery <rra@debian.org>
521 Seconded: Guillem Jover <guillem@debian.org>
522 Seconded: Raphaël Hertzog <hertzog@debian.org>
524 * Perl Policy: Remove obsolete dependency requirements
525 Wording: Cyril Brulebois <kibi@debian.org>
526 Seconded: Russ Allbery <rra@debian.org>
527 Seconded: Manoj Srivastava <srivasta@debian.org>
529 * Breaks is now supported by the stable release of dpkg, so drop
530 warnings against its use. Thanks, Steve Langasek. (Closes: #533577)
531 * Add references to the sections on Breaks and Conflicts to the section
532 on binary dependencies. Thanks, Frank Küster. (Closes: #529771)
533 * Clarify the units of Installed-Size and document that it is an
534 approximation. Thanks, Martin Dorey. (Closes: #534408)
535 * Don't suggest calling dpkg-statoverride --remove unconditionally in
536 the postrm script. Thanks, Patrick Schoenfeld. (Closes: #539389)
537 * Explain that the copyright dates are for the original Policy manual
538 and that there is no updated list of copyright holders for subsequent
539 revisions available. (Partly addresses #47438)
540 * Clarify the description of the Files control field and add examples.
541 * Change the wording of the Description and Changes field specifications
542 for *.changes files to more closely match the wording for Files and
543 add more details about the contents of the Description field in
545 * Merge the package name syntax requirements between the Package and
546 Source field descriptions.
547 * Say that sensible-editor and sensible-pager are provided by the
548 sensible-utils package, not by the base system. Thanks, Clint Adams
549 and Steve Langasek. (Closes: #541537)
550 * Document that control field values are case-sensitive unless the field
551 description says otherwise.
553 -- Russ Allbery <rra@debian.org> Sat, 15 Aug 2009 17:13:26 -0700
555 debian-policy (3.8.2.0) unstable; urgency=low
558 * Policy: Mandate debconf or equivalent for user prompting
559 Wording: Andrew McMillan <awm@debian.org>
560 Seconded: Russ Allbery <rra@debian.org>
561 Seconded: Holger Levsen <holger@layer-acht.org>
562 Seconded: Bill Allombert <Bill.Allombert@math.u-bordeaux1.fr>
563 Seconded: Julien Cristau <jcristau@debian.org>
565 * Policy: Remove /etc/X11/XF86Config-4 FHS exception
566 Wording: Julien Cristau <jcristau@debian.org>
567 Seconded: Russ Allbery <rra@debian.org>
568 Seconded: Bill Allombert <Bill.Allombert@math.u-bordeaux1.fr>
570 * Policy: Remove obsolete /var/mail transition requirement
571 Wording: Russ Allbery <rra@debian.org>
572 Seconded: Julien Cristau <jcristau@debian.org>
573 Seconded: Andrew McMillan <andrew@morphoss.com>
575 * Policy: Move Speedo fonts into the deprecated category
576 Wording: Julien Cristau <jcristau@debian.org>
577 Seconded: Russ Allbery <rra@debian.org>
578 Seconded: Julien Danjou <acid@debian.org>
580 * Housekeeping (resynchronizing lists maintained elsewhere):
581 - Add GFDL 1.3 to the common-licenses list.
582 - Update the list of archive sections. (Closes: #519835)
583 * Set the release date of the 3.8.1 upgrading-checklist entry.
587 * The FHS is the "Filesystem Hierarchy Standard", regardless of our
588 preferred spelling of "file system" elsewhere. Fix this and a nearby
589 search-and-replace capitalisation bug.
590 * Build-depend on texlive-latex-extra, which is needed by
591 debiandoc2latexps and isn't included in texlive's dependencies.
593 * Policy: State requirements for source package names
594 Wording: Colin Watson <cjwatson@debian.org>
595 Seconded: Russ Allbery <rra@debian.org>
596 Seconded: Julien Cristau <jcristau@debian.org>
598 * Add myself to Uploaders.
601 * Add myself to Uploaders.
602 * Update Standards-Version to 3.8.1 (no changes required).
604 - use `dpkg --print-architecture' instead of obsolete form
605 `dpkg --print-installation-architecture'.
606 - fix a race condition while generating DEBIAN/md5sums.
608 -- Bill Allombert <ballombe@debian.org> Tue, 16 Jun 2009 21:42:53 +0200
610 debian-policy (3.8.1.0) unstable; urgency=low
612 * Policy: Clarify what "sensible behavior" is for init scripts
613 Wording: Steve Langasek <vorlon@debian.org>
614 Seconded: Raphaël Hertzog <hertzog@debian.org>
615 Seconded: Russ Allbery <rra@debian.org>
617 * Policy: Remove alternative changelog formats from main manual
618 Wording: Russ Allbery <rra@debian.org>
619 Seconded: Ben Pfaff <blp@cs.stanford.edu>
620 Seconded: Guillem Jover <guillem@debian.org>
622 * Policy: Mandate UTF-8 for changelog files
623 Wording: Russ Allbery <rra@debian.org>
624 Seconded: Guillem Jover <guillem@debian.org>
625 Seconded: Kurt Roeckx <kurt@roeckx.be>
627 * Policy: Mandate UTF-8 for control files
628 Wording: Russ Allbery <rra@debian.org>
629 Seconded: Kurt Roeckx <kurt@roeckx.be>
630 Seconded: Raphaël Hertzog <hertzog@debian.org>
632 * Policy: New option in DEB_BUILD_OPTIONS to avoid running test-suites
633 Wording: Russ Allbery <rra@debian.org>
634 Seconded: Guillem Jover <guillem@debian.org>
635 Seconded: Raphaël Hertzog <hertzog@debian.org>
637 * Policy: Expand expected capabilities for local in /bin/sh scripts
638 Wording: Russ Allbery <rra@debian.org>
639 Seconded: Guillem Jover <guillem@debian.org>
640 Seconded: Raphaël Hertzog <hertzog@debian.org>
642 * Policy: Clarify Essential definition and caution when adding to it
643 Wording: Russ Allbery <rra@debian.org>
644 Seconded: Jörg Sommer <joerg@alea.gnuu.de>
645 Seconded: Guillem Jover <guillem@debian.org>
647 * Policy: Allow user mail spools to be mode 0600 or 0660
648 Wording: Russ Allbery <rra@debian.org>
649 Seconded: Kurt Roeckx <kurt@roeckx.be>
650 Seconded: Andrew McMillan <awm@debian.org>
652 * Policy: Remove special handling of init scripts ending in .sh
653 Wording: Kel Modderman <kel@otaku42.de>
654 Seconded: Russ Allbery <rra@debian.org>
655 Seconded: Henrique de Moraes Holschuh <hmh@debian.org>
657 * Policy: /var/run and /var/lock may be volatile
658 Wording: Colin Watson <cjwatson@debian.org>
659 Seconded: Russ Allbery <rra@debian.org>
660 Seconded: Bill Allombert <Bill.Allombert@math.u-bordeaux1.fr>
662 * Policy: debian/control allows comments starting with #
663 Wording: Russ Allbery <rra@debian.org>
664 Seconded: Julien Cristau <jcristau@debian.org>
665 Seconded: Adeodato Simó <dato@net.com.org.es>
666 Seconded: Guillem Jover <guillem@debian.org>
668 * Improve the documentation of maintainer script actions for diversions
669 in the informative appendix to allow for addition of a new diversion
670 on upgrade and handle error cases correctly. Thanks to Olivier Berger
671 for the report and Raphaël Hertzog for the review. (Closes: #483418)
672 * Clarify the meaning of architecture restrictions on build dependencies
673 in the presence of alternatives. Thanks to Guillem Jover for the
674 explanation and review and Emilio Pozuelo Monfort and Don Armstrong
675 for wording review. (Closes: #163666)
676 * Change the term "category" to "archive area" when referring to main,
677 contrib, and non-free. This is closer to the wording of the Social
678 Contract. (Closes: #473439)
679 * Use <user>:<group> notation rather than <user>.<group> notation in
680 multiple places. Thanks, Kurt Roeckx. (Closes: #488039)
681 * Fix typo in 3.8.0.0 upgrading-checklist entry. Patch from Kobayashi
682 Noritada. (Closes: #487701)
683 * Mention debugging packages as an explicit example of packages with
684 extra priority. Thanks, Charles Plessy. (Closes: #491985)
685 * Clarify that translation is only required for user-visible debconf
686 messages. Capitalize "Debian Configuration Management Specification"
687 uniformly. Thanks, Julian Andres Klode. (Closes: #492624)
688 * Add --wildcards to the sample tar command in appendix B.1 for
689 extracting the package copyright file, adjusting for new tar option
690 behavior. Thanks, Yan Morin. (Closes: #503685)
691 * Reword the requirement that maintainer scripts exit with a zero
692 status on success to avoid double-negatives.
693 * Include the full name of each menu category rather than only the
694 portion relative to the parent heading to be clearer in long category
695 lists. Thanks, Christoph Berg. (Closes: #511804)
696 * Build-Depend on texlive rather than tetex-extra. texlive appears to
697 be sufficient for how Policy uses debiandoc-sgml and pulls in far
699 * Remove the postinst and prerm scripts. doc-base registration is now
700 handled by triggers and no longer required and removal of /usr/doc
701 links was completed long ago.
702 * Reference GPL-2 rather than the GPL symlink in debian/copyright.
704 -- Russ Allbery <rra@debian.org> Wed, 11 Mar 2009 20:50:52 -0700
706 debian-policy (3.8.0.1) unstable; urgency=low
708 * Don't attempt to register the non-existent debian-policy-process
709 document. Thanks, Adrian von Bidder. (Closes: #484706)
711 -- Russ Allbery <rra@debian.org> Thu, 05 Jun 2008 13:13:01 -0700
713 debian-policy (3.8.0.0) unstable; urgency=low
715 * Bug fix: "[PROPOSAL] "debian/README.source" file for packages with
716 non-trivial source", thanks to Wouter Verhelst, Jörg Sommer, Colin Watson,
717 and Junichi Uekawa (Closes: #250202).
718 * Bug fix: "[AMENDMENT 11/02/2008] Manual page encoding", thanks to
719 Colin Watson (Closes: #440420).
720 * Bug fix: "[PROPOSAL] common interface for parallel building in
721 DEB_BUILD_OPTIONS", thanks to Loïc Minier, Peter Samuelson, and Robert
722 Millan (Closes: #209008).
723 * Bug fix: "Please clarify splitting/syntax of DEB_BUILD_OPTIONS", thanks to
724 Loïc Minier, Peter Samuelson, Robert Millan, and Guillem Jover
726 * Bug fix: "Documentation for Breaks in dpkg", thanks to Ian Jackson
728 * Bug fix: "support for wrapped Uploaders should now be mandatory"
730 * Bug fix: "[PROPOSAL] Add should not embed code from other packages",
731 thanks to Neil McGovern, Colin Watson, Bill Allombert, Steve Langasek,
732 Kurt Roeckx, and others (Closes: #392362).
733 * Bug fix: "Homepage field in debian/control undocumented", thanks to
734 Mario Iseli (Closes: #452105).
735 * Bug fix: "Policy inconsistent with reality: base subsection no longer
736 used", thanks to Magnus Holmgren, Bernd Zeimetz, and Colin Watson
738 * Bug fix: "Inclusion of Apache Software License versions in
739 /usr/share/common-licenses", thanks to Barry Hawkins (Closes: #291460).
740 * Bug fix: "[Amended] copyright should include notice if a package is
741 not a part of Debian distribution", thanks to Taketoshi Sano
743 * Bug fix: "scripts as configuration files: should vs. must", thanks to Frank
744 Küster (Closes: #403391).
745 * Bug fix: "debconf specification should allow underscores in template
746 names", thanks to Colin Watson (Closes: #473761).
747 * Bug fix: "clarify handling of run-time and compile-time support programs",
748 thanks to Goswin Brederlow and Raphael Hertzog (Closes: #367984).
749 * Policy: better document version ranking and empty Debian revisions
750 Wording: Russ Allbery <rra@debian.org>
751 Seconded: Raphaël Hertzog <hertzog@debian.org>
752 Seconded: Manoj Srivastava <srivasta@debian.org>
753 Seconded: Guillem Jover <guillem@debian.org>
754 Closes: #186700, #458910
755 * Policy: remove obsolete app-defaults and Xresources provisions
756 Wording: Julien Cristau <jcristau@debian.org>
757 Seconded: Russ Allbery <rra@debian.org>
759 * Bug fix: "Examples of dpkg frontends should mention apt now", thanks
760 to Josh Triplett (Closes: #455602).
761 * Bug fix: "Minor typos and wording suggestions", thanks to Michael
762 Tautschnig (Closes: #422552).
763 * Bug fix: "substvar reference moved from dpkg-source(1) to
764 deb-substvars(5)", thanks to Ian Beckwith (Closes: #475731).
765 * Policy: bugs fixed in NMUs are now closed rather than marked fixed
766 Wording: Russ Allbery <rra@debian.org> (thanks, Sandro Tosi)
768 * Policy: C.1.4, C.1.8: minor typos
769 Wording: Sandro Tosi <matrixhasu@gmail.com>
771 * Remove the now-obsolete policy-process document.
772 * Add an md5sums control file.
773 * Add Vcs-Browser and Vcs-Git control fields.
774 * Remove build system support for FHS 2.1 and FSSTND, mostly commented out.
775 * Remove more temporary files created by the build.
776 * Remove the FSSTND license from debian/copyright; no FSSTND files are
777 currently part of policy.
778 * Update FHS copyright dates in debian/copyright.
779 * Standardize the spacing around headings in upgrading-checklist.html.
780 * Remove old ChangeLog files and metadata headers in maintainer scripts
783 -- Russ Allbery <rra@debian.org> Wed, 04 Jun 2008 15:53:27 -0700
785 debian-policy (3.7.3.0) unstable; urgency=low
787 * Bug fix: "FTBFS if built twice in a row" (Closes: #424212).
788 * Bug fix: "[PROPOSAL] Document ~ behavior in version numbers", thanks
789 to Nicolas François and Marc Brockschmidt (Closes: #382612).
790 * Bug fix: "Please add 'local' to list of supra-POSIX features that
791 /bin/sh can be expected to offer". Also add test -a/-o binary logical
792 operators and change references from POSIX to SUSv3 (Closes: #294962).
793 * Bug fix: "[Proposal] new Debian menu structure", thanks to Bill
794 Allombert (Closes: #361418).
795 * Bug fix: "typo: "must not be not world-writable"", thanks to Sam
796 Hocevar (Closes: #392594).
797 * Bug fix: "debian-policy: recommend binary:Version substvar instead",
798 thanks to Guillem Jover (Closes: #418444).
799 * Bug fix: "New virtual package: dictd-dictionary", thanks to Tatsuya
800 Kinoshita (Closes: #413575).
801 * The virtual package in use is inet-superserver, not inetd-superserver.
802 Adjust the virtual package list to match. Thanks, Tatsuya Kinoshita
804 * Wrapped, cleaned up trailing whitespace, and alphabetized the list of
806 * Bug fix: "Small spelling errors and erratic sentences in debian-policy",
807 thanks to Michiel de Boer. (Closes: #435207).
808 * Bug fix: "Source field of .changes files may contain a version number"
810 * Bug fix: "822-date is deprecated (use date -R instead)" (Closes: #448035).
811 * Bug fix: "5.6.17 (Urgency) should list emergency, maybe a normative
812 list?" (Closes: #412634).
813 * Bug fix: "[PROPOSAL] Document support of package types in shlibs
814 files", thanks to Franz Pop and Raphaël Hertzog (Closes: #363133).
815 * Bug fix: "Introduce a requirement for internationalisation of debconf
816 templates", thanks to Christian Perrier (Closes: #402975).
817 * Bug fix: "GFDL is now in common-licenses". Also add the rest of the
818 specific license versions and the GPLv3 (Closes: #420701).
819 * Bug fix: "Virtual package for Japanese font packages
820 (ttf-japanese-mincho and ttf-japanese-gothic)", thanks to Nobuhiro
821 Iwamatsu (Closes: #440931).
822 * Drop unsupported docbook-xml format from the doc-base file for the
823 debconf specification.
824 * Remove inactive uploaders and add Russ Allbery.
825 * Update Standards-Version to 3.7.3 (no changes required).
827 -- Russ Allbery <rra@debian.org> Sun, 02 Dec 2007 22:33:55 -0800
829 debian-policy (3.7.2.2) unstable; urgency=low
831 * Bug fix: "clarify 12.3 Additional documentation", thanks to Peter
832 Eisentraut (Closes: #367697).
833 * Bug fix: "debian-policy: s/dependcy/dependency/", thanks to Justin
834 Pryzby (Closes: #375508).
835 * Bug fix: "various spelling mistakes", thanks to Nico Golde
837 * Bug fix: "debian-policy: typo", thanks to Peter Samuelson
839 * Bug fix: "debian-policy: [PROPOSAL] maintainer scripts must not be
840 world writable", thanks to Kari Pahula (Closes: #376438).
841 * Bug fix: "policy-process: s/ a a / a /; s/peoples/people's/;
842 s/intiated/initiated/; s/participattion the/participation in the/? add
843 quotes; s/was a larger/a larger/?", thanks to Justin Pryzby
845 * Bug fix: "[PROPOSAL] Include the GFDL in the set shipped in
846 /usr/share/common-licenses", thanks to Adeodato Simó. However, it is
847 premature to tell packages to use the common licenses file until we
848 actually ship the license in /usr/share/common-licenses/ (Closes: #378386).
849 * Bug fix: "circular dependencies, improved guarantees", thanks to Ian
850 Jackson (Closes: #379630).
851 * Bug fix: "section on invoke-rc.d doesn't make sense", thanks to Peter
852 Eisentraut (Closes: #380692).
853 * Bug fix: "policy: postinst doesn't document typical abort-remove
854 case", thanks to Justin Pryzby. Removed all such comments. This is not
855 the place to document such material. (Closes: #373212).
856 * Bug fix: "use of "invoke-rc.d $PACKAGE stop || exit $?" in
857 prerm scripts", thanks to Lars Wirzenius (Closes: #370471).
858 * Bug fix: "debian-policy: Inconsistent requirements wrt bashisms",
859 thanks to Frank Küster (Closes: #367531).
860 * Bug fix: "debian-policy: s/with With/with /", thanks to Justin Pryzby
862 * Bug fix: "debian-policy: "$RET" not "RET"", thanks to Justin Pryzby
864 * Bug fix: "debian-policy: Spelling error in chapter 9.1.1:
865 exceptiions", thanks to Andreas Janssen (Closes: #388302).
866 * Bug fix: "[PROPOSAL] Document ~ behavior in version numbers", thanks
867 to Jakob Bohm (Closes: #382612).
868 * Bug fix: "debian-policy: [ACCEPTED] Request for the 'stardict'",
869 thanks to Andrew Lee (Closes: #385935).
870 * Bug fix: "[ACCEPTED] virtual package 'lzh-archiver' -- an LZH archiver
871 package", thanks to Ying-Chun Liu (PaulLiu) (Closes: #387027).
873 -- Manoj Srivastava <srivasta@debian.org> Mon, 2 Oct 2006 17:31:23 -0500
875 debian-policy (3.7.2.1) unstable; urgency=low
877 * Bug fix: "debian-policy: s/control are/&a/; s/stats/status/;
878 s/and/an/; s/'/"/; s/rewind/unwind/; s/fact/& that/; s/like
879 like/look like/;", thanks to Justin Pryzby (Closes: #372147).
880 * Bug fix: "debian-policy: Minor typo in footnote 53", thanks to Jordà
881 Polo (Closes: #372497).
882 * Bug fix: "debian-policy: Typo in 9.1.1: "'..' character"
883 should be "'.' character"", thanks to Matt Zagrabelny
885 * Bug fix: "debian-policy: More typos in upgrading-checklist.txt",
886 thanks to Kevin B. McCarty (Closes: #366466).
887 * Bug fix: "typo: package remains in and "Installed' state", thanks
888 to Sam Hocevar \(Debian packages\) (Closes: #369413).
889 * Bug fix: "debian-policy: Cleanup build-dependencies", thanks to Stefan
890 Huehner (Closes: #366032).
891 * Bug fix: "debian-policy: 2.2 should be named 'categories'", thanks to
892 Thomas Weber (Closes: #369912).
893 * Bug fix: "debian-policy: old postinst abort-upgrade, not new", thanks
894 to Justin Pryzby. The fix was thanks to Margarita Manterola
896 * Bug fix: "policy: please say which control fields can line-wrap",
897 thanks to Peter Samuelson (Closes: #372731).
898 * Bug fix: "debian/copyright should be mentioned in source section",
899 thanks to Ian Jackson (Closes: #369011).
900 * Bug fix: "GNU office not on Temple Place anymore", thanks to Dan
901 Jacobson (Closes: #366889).
903 -- Manoj Srivastava <srivasta@debian.org> Tue, 20 Jun 2006 00:18:19 -0500
905 debian-policy (3.7.2.0) unstable; urgency=low
907 * Revert the cgi-lib change.
908 * Bug fix: "Clarification for difference between Build-Depends and
909 Build-Depends-Indep (Section 7.6)", thanks to Christoph Berg
910 Note that this is not part of policy, just an informative footnote.
912 * Bug fix: "debian-policy: Typo in policy 5.6.3: semantic meaning",
913 thanks to Thijs Kinkhorst (Closes: #365907).
915 -- Manoj Srivastava <srivasta@debian.org> Wed, 3 May 2006 18:07:19 -0500
917 debian-policy (3.7.1.0) unstable; urgency=low
919 * Bug fix: "[PROPOSAL] 11.9: document handling of directories permission
920 when upgrading", thanks to Bill Allombert (Closes: #136318).
921 * Bug fix: "[DISCUSS] documentation of the "-fPIC" constraint", thanks
922 to Loïc Minier. Clarified when it may be reasonable to violate the standard
923 directive that shared libraries must be compiled with -fPIC, and
924 static libraries without, added the protocol to be followed when
925 doing so. (Closes: #329762).
926 * Bug fix: "Minor typo in upgrading checklist", thanks to David
927 Weinehall (Closes: #364982).
928 * Bug fix: "Typo in upgrading-checklist", thanks to David Weinehall
930 * Bug fix: "typo in debian policy section 10.9.1", thanks to Miguel Gea
931 Milvaques (Closes: #365058).
932 * Bug fix: "debian-policy: The section 11.8.5 needs some
933 clarifications", thanks to Robert Luberda (Closes: #365356).
934 * Bug fix: "11.8.7: X11R7 puts headers in /usr/include/X11", thanks to
935 Drew Parsons (Closes: #365510).
936 * Bug fix: "debian-policy: typo in policy-process:
937 "Guideliens"", thanks to Lars Wirzenius (Closes: #360518).
938 * Bug fix: "debian-policy: repeated word in section 10.4", thanks to
939 Russ Allbery (Closes: #364985).
940 * Bug fix: "typo in debian-policy", thanks to Miguel Gea Milvaques
943 -- Manoj Srivastava <srivasta@debian.org> Wed, 3 May 2006 11:17:42 -0500
945 debian-policy (3.7.0.0) unstable; urgency=low
947 * Bug fix: "[PENDING AMENDMENT 20/01/2000] Splitting cgi-bin", thanks to
948 Brian White. (Closes: #32263).
949 * Bug fix: "debian-policy: [PROPOSAL] Should update to Filesystem
950 Hierarchy Standard FHS 2.3", thanks to Tobias Burnus
951 (Closes: #230217, #212434, #344158).
952 * Bug fix: "[AMENDMENT 11/04/2006] Permit multi-line fields in
953 debian/control", thanks to John R. Daily. Mention that all fields,
954 except the Uploaders, are supposed to be a single logical line, which
955 may be spread over multiple physical lines (newline followed by space
956 is elided). Also mention that anything parsing the control file must
957 allow for a multi-line uploaders field. (Closes: #148194).
958 * Bug fix: "[AMENDMENT 12/04/2004] frown on programs in PATH with
959 language extentions", thanks to Joey Hess. (Closes: #190753).
960 * Bug fix: "init script stop example should use --oknodo", thanks to
961 Matt Kraai. Removed the example entirely. (Closes: #346598).
962 * Bug fix: "policy 12.5: Please recommend a sane practice WRT different
963 gpl versions (was: Re: RFC/RFS: beef - a flexible BrainFuck
964 interpreter)", thanks to Justin Pryzby. The subject leaves something
965 to be desired, but polic should not attempt to enumerate all common
966 licenses. (Closes: #355263).
967 * Bug fix: "debian-policy: Conflicting Architecture definitions", thanks
968 to Hans Ulrich Niedermann. Punt to dpkg-architecture to providing
969 legal architecture strings, since that's what is used by everyone
970 anyway. The version in policy was wrong, but that s=does not seem to
971 have hindered anyone, which indicates that this policy directive was
972 uneeded. Now the dpkg-architecture list is deemed authoritative, which
973 it is, but the format for the string is defined by policy, and the
974 current list of architecture strings is in an informative foot note.
976 * Bug fix: "[AMENDMENT 06/04/2006] Make use of invoke-rc.d, if
977 available, mandatory", thanks to Lars Wirzenius. (Closes: #361137).
978 * Bug fix: "no longer current regarding X font paths", thanks to Joey
979 Hess (Closes: #362247).
980 * Bug fix: "debian-policy: please prohibit circular dependencies, or
981 mention that dependencies won't be respected during prerm remove",
982 thanks to Justin Pryzby. Well, we did not prohibit circular
983 dependencies. But we do now have a warning that In case of circular
984 dependencies, since installation or removal order honoring the
985 dependency order can't be established, dependency loops are broken at
986 some random point, and some packages may not be able to rely on their
987 dependencies being present when being installed or removed, depending
988 on which side of the break of the circular dependcy loop they happen
989 to be on. (Closes: #362975).
990 * Bug fix: "8.6.4. Providing a `shlibs' file: s/should create/must
991 provide/", thanks to Christoph Berg. Clarified the wording.
993 * Bug fix: "debian-policy: Chapter 6 - Package maintainer scripts:
994 redundant info about exit status", thanks to Daniel Bonniot
996 * Bug fix: "debian-policy: Refers to upgrading-checklist.txt instead of
997 upgrading-checklist.txt.gz", thanks to Matt Kraai (Closes: #349775).
998 * Bug fix: "debian-policy: dpkg-gencontrol now uses -isp by default",
999 thanks to Guillem Jover (Closes: #359817).
1000 * Bug fix: "[PROPOSAL] unclear recommendation for debconf w/
1001 dpkg-statoverride", thanks to Eduard Bloch (Closes: #199849).
1002 * debian-policy: please support Watch file as recommendation, thanks to
1003 Bluefuture (Closes: #342611).
1004 * Bug fix: "[PROPOSED] Mandate http servers to provide httpd-cgi as
1005 relevenat", thanks to Uwe Hermann. This is already supported by the
1006 http servers out there. (Closes: #117916).
1008 -- Manoj Srivastava <srivasta@debian.org> Tue, 25 Apr 2006 23:56:16 -0500
1010 debian-policy (3.6.2.2) unstable; urgency=low
1013 * Bug fix: "policy is out of date re tasks and tasksel", thanks to Joey
1014 Hess. Removed the section from policy. (Closes: #344310).
1015 * Bug fix: "debian-policy: Please remove virtual package cron-daemon",
1016 thanks to Steve Greenland (Closes: #257726).
1017 * Bug fix: "debian-policy: incorrect tar example deb manipulation",
1018 thanks to Bob Proulx (Closes: #224770).
1019 * Bug fix: "Probable typo in 10.1 install -s miss INSTALL =", thanks to
1020 Bill Allombert (Closes: #341992).
1021 * Bug fix: "debian-policy: postinst abort-remove (6.7) not present in
1022 summary (6.4)", thanks to Ferenc Wagner (Closes: #338493).
1023 * Bug fix: "UTF-8 footnote is out of date (pre-sarge)", thanks to Martin
1024 Michlmayr (Closes: #337539).
1025 * Bug fix: "debian-policy: Typo in perl-policy", thanks to Tibor Csögör
1027 * Bug fix: "debian-policy: Outdated FSF postal address in Copyright
1028 Notice", thanks to Jean-Marc Ranger (Closes: #334819).
1029 * Bug fix: "debian-policy: §6.5 (3)(1): missing "Error
1030 unwind:" for "new-postrm abort-upgrade"", thanks to
1031 Henning Makholm (Closes: #321792).
1032 * Bug fix: "debian-policy: typo in §5.6.3: co-maintaintainers", thanks
1033 to Henning Makholm (Closes: #321790).
1034 * Bug fix: "debian-policy: typos in sect 9.3.1: "ends .sh",
1035 "rather that"", thanks to Thijs Kinkhorst (Closes: #343933).
1036 * Bug fix: "debian-policy: Unclear wording of ldconfig requirements in
1037 section 8.1.1", thanks to Ben Finney (Closes: #318214).
1038 * Bug fix: "debian-policy: Typo in 8.6.2: ${shlib:Depends} must be
1039 ${shlibs:Depends}", thanks to Thijs Kinkhorst (Closes: #318147).
1040 * Bug fix: "debian-policy: gzipped fhs-2.3 documentation is corrupt",
1041 thanks to Gabor Gombas (Closes: #340189).
1042 * Bug fix: "Section 6.3 should reference 3.10.1", thanks to Marc 'HE'
1043 Brockschmidt (Closes: #326633).
1044 * Bug fix: "debian-policy: section 2.2 refers to no-longer existant
1045 non-US repository sections", thanks to Martin-Eric Racine
1048 -- Manoj Srivastava <srivasta@debian.org> Sun, 25 Dec 2005 08:47:52 -0600
1050 debian-policy (3.6.2.1) unstable; urgency=low
1052 * Bug fix: "debian-policy: Typo in upgrading-checklist.txt.gz", thanks
1053 to Romain Francoise. Added the missing /. (Closes: #314569).
1054 * Bug fix: "x-session-manager already in use, so please add to
1055 virtual-package-names-list.txt", thanks to Christopher Martin
1057 * Bug fix: "[ACCEPTED] SRFI 22 names for Scheme implementations", thanks
1058 to Jorgen Schaefer (Closes: #310113).
1059 * Bug fix: "debian-policy: please add x-display-manager to
1060 virtual-package-names-list.txt", thanks to Jon Dowland (Closes: #294633).
1062 -- Manoj Srivastava <srivasta@debian.org> Sat, 18 Jun 2005 00:48:14 -0500
1064 debian-policy (3.6.2.0) unstable; urgency=low
1067 * Bug fix: "policy 11.5.3 refers to using the menu package to register
1068 docs", thanks to Joey Hess (Closes: #222553).
1069 * Bug fix: "[PROPOSAL] Document Uploaders: field in policy", thanks to
1070 Andrew Pollock. Andreas Metzler provided the wording, though it was
1071 modified during inclusion. (Closes: #203145).
1072 * Bug fix: "debian-policy: Minor grammatical correction in section 9.4",
1073 thanks to Eric Evans. I rejected the proposed change, instead I went
1074 over the whole policy document and removed all he/she/him/her
1075 constructs before the gender police jump all over me. (Closes: #273122).
1076 * Bug fix: "XSI:ism in prerm and postinst", thanks to David Weinehall
1078 * Bug fix: "debian-policy: please clarify section 12.7.", thanks to
1079 Adrian Bunk. Added a clarifying footnote that makes it clear that
1080 section 12.3 does not allow one to ignore section 12.7 (Closes: #276953).
1082 * Bug fix: "debian-policy: should not ship generated files in source
1083 archive, and should clean them from the tree", thanks to Branden
1084 Robinson (Closes: #284967).
1085 * Bug fix: "debian-policy: Detailed description of maintainer script
1086 calls (Section 6.5) is incomplete", thanks to Nikolaus Schulz
1087 and Thomas Hood. What happens when error unwinding itself runs into
1088 problems is perhaps not discussed as completely as it should be.
1090 * Bug fix: "9.3.3.2 "command -v" example needs tweaking",
1091 thanks to Thomas Hood. Instead of the massively complex shenanigans
1092 suggested in the bug report, just use which. which lives in an
1093 essential package, so can be used in the preinst of packages.
1095 * Bug fix: "debian-policy: please clarify/loosen the policy on rewriting
1096 history", thanks to Frank Küster. Since this was not really a
1097 directive, but merely an expression of an opinion, moved it into an
1098 informative footnote. (Closes: #290270).
1099 * Bug fix: "debian-policy: virtual package request: mpd-client", thanks
1100 to Eric Wong (Closes: #270020).
1101 * Bug fix: "[ACCEPTED 2005/02/04]: "libexec", or use of "lib" for
1102 binaries in lib* packages", thanks to Junichi Uekawa
1104 * Bug fix: "debian-policy: virtual package: flexmem", thanks to Bartosz
1105 Fenski aka fEnIo (Closes: #239359).
1106 * Bug fix: "Please clarify Section 2.5. required <-> essential",
1107 thanks to Adrian Bunk. Clarified the section. (Closes: #216104).
1108 * Bug fix: "debian-policy: Please remove virtual package
1109 aspell-dictionary", thanks to Brian Nelson (Closes: #295939).
1110 * Bug fix: "[AMENDMENT 18/02/2002] Where to place web-accessible
1111 images", thanks to Tollef Fog Heen (Closes: #89867).
1112 * Bug fix: "debian-policy: erroneous enumeration in prebuilt policy.*
1113 files", thanks to Nikolaus Schulz. I am hoping that this shall go away
1114 when we rebuild. (Closes: #286553).
1115 * Bug fix: "please make names of alternate versions links", thanks to
1116 Robert Cheramy. Added HTTPPATH elements that should provide the URL's
1117 as well as the hyperlinks. (Closes: #308886).
1118 * Bug fix: "www.debian.org: Misspelling in Policy Manual", thanks to
1119 Roberto C. Sanchez Various spelling errors were also corrected in a
1120 spell check run. (Closes: #309162).
1122 -- Manoj Srivastava <srivasta@debian.org> Thu, 16 Jun 2005 20:27:17 -0500
1124 debian-policy (3.6.1.1) unstable; urgency=low
1127 * [AMENDMENT 15/09/2003] Move documentation of behavior of ancient dpkg
1128 in 6.6 to a footnote. closes: Bug#209855
1129 * Fix the outdated link for the mime subpolicy. closes: Bug#212153
1130 * Fix a missing comma in the list of sections closes: Bug#215524
1131 * Fix spelling of sysv-rc closes: Bug#215558
1132 * [AMENDMENT 28/03/2004] ${perl:Depends} documentation
1133 incomplete. Added an informative foot note stating that dependencies
1134 caused by versioned uses and on separately packaged modules are not
1135 included in this variable and must be explicitly included.
1137 * Clarified that section 3.2.1 refers to the date based postion of the
1138 version number, if not already clear from the context. This allows
1139 developers leeway in selecting date based version numbers for their
1140 packages, without loosing the advantages of the format specified in
1141 this section. closes: Bug#248618
1142 * Bug fix: "Broken link to virtual-package-names-list.txt in section
1143 3.6", thanks to Carlos O'Donell (Closes: #248786).
1144 * Bug fix: "Broken link to debconf_specification.txt.gz in section
1145 3.10.1 of the Debian Policy manual.", thanks to Carlos O'Donell and
1146 Scott C.MacCallum <scm@madoshi.com> (Closes: #248788, 247761).
1147 * Bug fix: "missing commas in subsections list", thanks to Filippo
1148 Giunchedi (Closes: #236614).
1149 * Bug fix: "debian-policy: policy-process, broken URL", thanks to Manoj
1150 Srivastava (Closes: #244969).
1151 * Bug fix: "bad reference to debconf-devel(8) has to be (7)", thanks to
1152 Kevin Price (Closes: #247143).
1153 * Bug fix: "debian-policy: Small wording change", thanks to Mike Paul
1155 * Bug fix: "debian-policy: broken URL: CSH Programming Considered
1156 Harmful", thanks to Steven Augart (Closes: #253324).
1157 * Bug fix: "New virtual package: cron-daemon", thanks to Adam Byrtek
1160 * Fixed detection of invoke-rc.d's existence, closes: #218530.
1161 * Generalized the dpkg-shlibdeps example and added a current example in a
1162 footnote, set proper section ids and linked the d-sd section better,
1164 * Clarified the section about the Architecture field and added footnotes
1165 to indicate recommended actions, closes: #51832.
1166 * Updated PGP references, closes: #68827.
1167 * Linked f-Format in the list of fields of the .dsc file, not mandatory
1168 according to my skimming of dpkg-source, closes: #70742.
1169 * Fixed the command line required to output the copyright file,
1171 * Removed the long obsolete notion of specific directory names within
1172 source tarballs, closes: #79210.
1174 * sgml-dtd was moved, fix FTBFS. Closes: #241683
1175 * fix link to WM specification. Closes: #235484
1176 * manpage -> man page. Closes: #232364, #238958
1177 * language adjustment. Closes: #227762
1178 * added virtual packages stardict-dictionary, inetd-superserver.
1179 Closes: #185943, #237049
1181 -- Manoj Srivastava <srivasta@debian.org> Fri, 25 Jun 2004 16:07:38 -0500
1183 debian-policy (3.6.1.0) unstable; urgency=low
1186 * Removed obsolete section on obsolete constructs and libraries,
1189 * Change reference to the debconf introduction from kitenet to a debian
1190 hosted server. closes: Bug#187297
1191 * Added myspell-dictionary to the virtual packages list closes: Bug#203728
1192 * Fix the restart action in the init.d/bind example; it now uses
1193 --oknodo so that the action does not fail when the service is not
1194 running. closes: Bug#187250
1195 * invoke-rc.d and update-rc.d are now in the sysv-rc package instead of
1196 the sysvinit package. Fixed a reference in policy. closes: Bug#200440
1197 * Note that postinst abort-remove is called if there is an error while
1198 removing the package. closes: Bug#188030
1199 * [AMENDMENT 2003/08/03] Make Debconf the standard for prompting the
1200 user closes: Bug#176506
1202 -- Manoj Srivastava <srivasta@debian.org> Tue, 19 Aug 2003 07:28:10 -0500
1204 debian-policy (3.6.0) unstable; urgency=low
1207 * Restructured Policy, closes: #189306.
1208 + Many packaging manual appendices that were integrated into policy
1209 sections are now empty, and replaced with links to the Policy.
1210 In particular, the appendices that included the list of control
1211 fields were updated (new fields like Closes, Changed-By were added)
1212 and the list of fields for each of control, .changes and .dsc files
1213 is now in Policy, and they're marked mandatory, recommended or
1214 optional based on the current practice and the behaviour of the
1215 deb-building toolchain.
1216 + Elimination of needlessly deep section levels, primarily in the
1217 chapter Debian Archive, from which two new chapters were split out,
1218 Binary packages and Source packages. What remained was reordered
1219 properly, that is, some sect1s became sects etc.
1220 + Several sections that were redundant, crufty or simply not designed
1221 with any sort of vision, were rearranged according to the formula that
1222 everything should be either in the same place or properly interlinked.
1223 Some things remained split up between different chapters when they
1224 talked about different aspects of files: their content, their syntax,
1225 and their placement in the file system. In particular, see the new
1226 sections about changelog files.
1228 * Added Games/Simulation to menu subpolicy closes: Bug#194974
1229 * Added Apps/Education to menu subpolicy closes: Bug#194972
1230 * [ACCEPTED]: Debian changelogs should be UTF-8 encoded. Changed the
1231 wording from a should to a may; since a should would make an unknown
1232 number of packages insta buggy. A reuest makes all these wishlist
1233 bugs; we can raise the severity in a later version of policy.
1235 * Added LANG=C before the debiandoc2X invocations, this ensures that the
1236 resulting documents do not get converted to the locale on the building
1237 machine. This answers some of the issues mentioned in Bug#175064
1238 * [AMENDMENT 02/05/2003] encourage packagers to systematically prevent
1239 mis-linked libraries closes: Bug#191369
1240 * [AMENDMENT 6/6/2003] build-depends-indep need not be satisfied
1241 during clean target. closes: Bug#191411, Bug#178809
1242 * Fixed the fact that section 7.5.1 does not describe dpkg's true
1243 behavior. Now added a footnote that explains that replaces is a one
1244 way relationship. closes: Bug#183195
1245 * Could no longer find the misspelling "seciton", thus this must have
1246 been fixed in a previous change in the manual. closes: Bug#193903
1247 * Fixed an incorect /usr/share/common-licences/GPL reference, ensured a
1248 consistent spelling across the manuals. closes: Bug#189516
1249 * Removed an extraneous > in menu policy. closes: Bug#187615
1250 * Fixed typos, and part of the report that was deemed valid; the other
1251 changes suggested were incorrect, or style issues. closes: Bug#169744
1252 * updated the section numbers in the upgrading checklist
1253 for the restructuring
1255 -- Josip Rodin <joy-packages@debian.org> Wed, 9 Jul 2003 18:01:35 +0200
1257 debian-policy (3.5.10.0) unstable; urgency=low
1260 * Fixed date, typos and added indentation in the virtual packages list,
1262 * Changed the formatting of the link to the authors section to avoid
1263 confusion in the debiandoc2txt output, closes: #185985.
1264 * Fixed various typos, closes: #189274, #187418, #187422, #189654.
1265 * Removed broken link to csh.whynot on CPAN, closes: #187567.
1266 * Updated archive section list, closes: #187420.
1267 * Stop attaching byhand tarballs, cf. bug #184082.
1269 * Clarify x-terminal-emulator virtual package eligibility, in an
1270 extention to an informative footnote. closes: Bug#165063
1271 * Add 40 points, not 20, when the window manager is compliant with "The
1272 Window Manager Specification Project". closes: Bug#167004
1273 * Fixed reference to the debconf URL (we can change the URL as it
1274 changes again, and I don't think any additional load would accrue
1275 since people using the old URL were redirected to auric anyway).
1277 * Inserted the word only in the package name section. closes: Bug#184368
1278 * Amended the section about Prompting in maintainer scripts. Added a
1279 footnote (quoting from the Jargon File) to explain what "by hand"
1280 means in a computer context. closes: Bug#184507
1282 -- Josip Rodin <joy-packages@debian.org> Sat, 10 May 2003 19:13:50 +0200
1284 debian-policy (3.5.9.0) unstable; urgency=low
1287 * Added missing bits of information about Description: fields from
1288 the old Packaging manual, closes: #172022
1289 * Fixed a stale reference to the "base system maintainer" to
1290 base-passwd maintainer, closes: #174927
1291 * Fixed an accidental change from /usr/share/package to /usr/share/doc in
1292 the paragraph about not depending on /usr/share/doc/package,
1294 * Fixed several errors reported by Guenther Palfinger, with some help from
1295 Richard Braakman, closes: #177205, #177206, #177207, #177208, #177209
1296 * Added versions to links and docbook-xml source-dependencies, hopefully
1297 fixes the bug with potato, and even if it doesn't, I don't care :)
1299 * Fixed typos in the debconf spec noticed by Jay Bonci, closes: #178455
1300 * Clarified that using Build-Depends for build-dependencies is not a "may"
1301 but a "should", added proper linking among various sections dealing with
1302 the dependencies so that there is no confusion, closes: #87510
1303 If any one of those poor, misguided people ;) still thinks that the
1304 requirement should be a "must" (in _our_ meaning, not RFC "MUST"),
1305 please file a new bug, as it's quite unproductive to have to sift
1306 through a 152-page bug log which mostly goes back-and-forth with
1307 explanations how policy should work, occasionally sprinkled with
1308 offtopic stuff, too.
1309 * When asked to restart a service that isn't already running, the init
1310 script should start it, closes: #60979
1311 * Rephrased section on configuration files to remove confusing use of
1312 "should", closes: #170019
1313 * Rearranged the shared library information properly, closes: #109166
1314 This change also centralizes the info on how to ship static libraries
1315 in one place (hopefully not too ambiguous), closes: #93975
1316 * Allow examples to be placed in /usr/share/doc/package/ in packages
1317 that are meant to provide examples, closes: #69864
1318 * Removed several references to the Policy manual etc in the stuff
1319 imported from old packaging manual, closes: #181923
1320 * Fixed too greedy wildcard match in the logrotate example,
1323 -- Manoj Srivastava <srivasta@acm.org> Fri, 7 Mar 2003 12:35:16 -0600
1325 debian-policy (3.5.8.0) unstable; urgency=low
1328 * Added example for why one may call ldconfig anywhere in the
1329 postsint. closes: Bug#120585
1330 * Add the modifications about base system, as opposed to the soon to be
1331 obsolete base section (I assume it is) closes: Bug#53582
1332 * Rearranged the virtual packages list. closes: Bug#72980
1333 * This is basically an attempt to ratify the current practice of using
1334 debhelper in the clean target. Currently, policy does not require
1335 debhelper to be installed when the clean target is run, even though it
1336 is in the build-depends field. This was a simple oversight.
1338 * No longer depend on fileutils. closes: Bug#167425
1339 * Added the Apps/Science menu section closes: Bug#162812
1340 * Applied text patch from Joey Hess to the debconf spec simply make it
1341 conform to the reality of how some things work now. This is part of an
1342 effort to make debconf and cdebconf better substitutes for each
1343 other. Since it was not an XML patch, no special markup is present in
1344 the new content, except where I made guesses. closes: Bug#160776
1345 * Clarify section 13.3. closes: Bug#160248
1346 * Removed the undocumented(7) hack requirement. closes: Bug#39830
1348 * Removed the obsolete notion of documenting changes within the copyright
1349 file, closes: Bug#65764
1351 -- Manoj Srivastava <srivasta@debian.org> Fri, 15 Nov 2002 00:36:54 -0600
1353 debian-policy (3.5.7.1) unstable; urgency=low
1355 * Fix the debconf spec to (postinst -> postrm) closes: Bug#129375, Bug#160839
1356 * Fix update-rc.d example, mention that changing run-levels or priority
1357 may require removing and re-creating the symbolic links. closes: Bug#149709
1358 * Fix the groff and col -b interaction closes: Bug#164755
1359 * Added section numbers to upgrading checklist closes: Bug#160914
1360 * Fixed typo KB_Backspace -> KB_BackSpace
1361 * Clarify wording in the section about ChangeLog files to allow for
1362 symbolic links in /usr/share/doc/ directory (was already allowed in a
1363 previous section of policy 13.6) closes: Bug#111137
1364 * Removed a spurious + from text. closes: Bug#160908
1365 * Added a note in the debconf spec to consult debconf-devel(8) for
1366 details. closes: Bug#133030
1367 * Added a reference to the local copy of the FHS. closes: Bug#122928
1368 * Updated reference to ash (dash). This implements the non controversial
1369 parts of Bug#161455.
1371 -- Manoj Srivastava <srivasta@debian.org> Sat, 26 Oct 2002 13:12:49 -0500
1373 debian-policy (3.5.7.0) unstable; urgency=low
1375 * Fixed some broken hrefs in links
1376 * No longer use local debiandoc stuff (it's been fixed upstream)
1377 * Added table of contents (index.html) to policy-process.sgml, fixing
1378 the new error reported to bug #137521 closes: Bug#137521
1379 * Fixed a couple of typos closes: Bug#139832
1380 * Ran through the policy document looking for long instances of text in
1381 the <tt> tag, and changed it to <file> where appropriate. This is
1382 since the <file> tag can handle line breaking, but the <t> flag does
1383 not. closes: Bug#139820
1384 * Change the requirement to ask permission to make devices to merely
1385 requiring a notification. closes: Bug#106280
1386 * Added a build dependson docbook utils. closes: Bug#154660
1387 * Since this is being built with a newer version of debiandoc-sgml, this
1388 should display better with lynx. closes: Bug#153704
1389 * Add in the crypto-in-main amendment. closes: Bug#81852, Bug#144411
1390 * we no longer have task packages, instead, we define tasks using a
1391 special field in the control file (and these should be added only
1392 after discussion on the mailing lists) closes: Bug#97755
1393 * Clarify wording in the section for packages providing fonts.
1395 * Fix the doc base file for policy process closes: Bug#137521, Bug#147554
1397 * using set -e is not dubious advice. Rejecting this. closes: Bug#139969
1398 * Make the directory one is building under ./debian/ be up to the
1399 maintainer, instead of mandating ./debian/tmp/ closes: Bug#144297
1400 * Add a standards version closes: Bug#145067
1401 * Added virtual package debconf-2.0 closes: Bug#151328
1402 * Added The Window Manager Specification Project support to the default
1403 window manager selection mechanism closes: Bug#155680
1404 * The confusion between /var/mail and /var/spool/mail seems to have been
1405 disambiguated. closes: Bug#114949
1406 * Mention the new Build-Depend-Indep semantic and the new
1407 build-indep/build-arch rules in upgrading checklist closes: Bug#116134
1408 * Made package naming rules in policy consistent. I did not eliminate
1409 the duplication, since I don't want to make major changes to the flow,
1410 since we are supposed to be re-writing policy anyway. closes: Bug#131441
1411 * Clarified wording about cases where we may have concrete and virtual
1412 packages with the same name. closes: Bug#134977
1413 * Fixed typo 'be be' closes: Bug#138681
1414 * Fixed typo in appendix G -- example of diversion closes: Bug#140697
1415 * fix typo shlib: -> shlibs: closes: Bug#141903
1416 * Provide a link between two sections dealing with virtual packages.
1418 * Fixed xtifr's email address in the menu policy closes: Bug#152965
1419 * Allow shared library names to be have a hyphen between library name
1420 and soversion if the library name ends in a number. closes: Bug#100472
1421 * Permit some libraries to only install static libs. closes: Bug#100346
1422 * Remove the debug option, add noopt closes: Bug#157131, Bug#113525
1423 * provide dhcp-client virtual package. closes: Bug#154142
1424 * We do not need bits in policy that ``should not be enforced''.
1426 * We are building this with the latest debianndoc-sgml. closes: Bug#146703
1427 * Finish incorporating all of the accepted changes in Bug#72335, and
1428 this closes: Bug#141307, Bug#156546
1429 * Added virtual package aspell-dictionary closes: Bug#139067
1430 * Added virtual package radius-server closes: Bug#118608
1431 * Clarifying manual pages is not a policy issue. closes: Bug#112828
1432 * Corrected the ldconfig handling instructions. closes: Bug#111025
1433 * Not a policy issue. closes: Bug#106826
1434 * Removed the /usr/doc/ symlink clause. closes: Bug#47298, Bug#69311
1436 -- Manoj Srivastava <srivasta@debian.org> Sat, 31 Aug 2002 02:18:02 -0500
1438 debian-policy (3.5.6.1) unstable; urgency=low
1440 * Set the cotact information for the FHS contact, and add mention of the
1441 FHS mailing list. closes: Bug#137172
1442 * ftp://ftp.debian.org/debian/doc/package-developer/ certainly seems to
1443 exist, and does contain the menu policy. closes: Bug#110711, Bug#121977
1444 * Added java related virtual packages closes: Bug#110713
1445 * Fixed confusion in appar4ently contradictory wording about /etc/init.d
1446 scripts: clarified to emphasize that the init.d files _are_
1447 configuration files, and they _must_ have local changes preserved,
1448 either (if they are present in the .deb) by marking them as conffiles
1449 or, if they do not exist in the .deb file, by any other means. This
1450 does not change any requirements, and should have no affect on any
1451 conformant packages. closes: Bug#132621
1452 * Fixed error in doc-base file closes: Bug#137521
1453 * fixed typo in virtual packages list closes: Bug#110446
1454 * Fixed typo in upgrading checklist. closes: Bug#110705
1455 * Fixed typo (dependencies) in the policy closes: Bug#122931
1456 * Fixed grammar errors in the policy closes: Bug#126131
1457 * While I am cleaning out bugs, these are old and the reporter no longer
1458 wnats to pursue them, and there was never a consensus reached. If
1459 there is interest, new bugs can be filed. closes: Bug#51411, Bug#51412
1460 * Added the virtual package dict-client closes: Bug#122996
1461 * Added the virtual package foomatic-data closes: Bug#123570
1462 * Added the virtual packages {x-}audio-mixer closes: Bug#131781
1464 -- Manoj Srivastava <srivasta@debian.org> Thu, 14 Mar 2002 12:16:53 -0600
1466 debian-policy (3.5.6.0) unstable; urgency=low
1468 * Change footnote about urgency values to the now-current list: low,
1469 medium, high, emergency.
1470 * Correct note about /etc/default files being conffiles/config files,
1471 which I mucked up (sorry Joey) [10.3.2]
1472 * [AMENDMENT 2001/06/26] Downgrade emacs/tex to optional
1473 closes: Bug#102204, Bug#53849
1474 * [AMENDMENT 2001/06/26] Next stage in usr/doc -> usr/share/doc transition
1477 * [AMENDMENT 09/06/2001] Clarifying FHS policy closes: Bug#98291, Bug#60461
1478 * Spelling correction closes: Bug#105625
1479 * [AMMENDMENT 28/06/2001] Restrict http access to /usr/share/doc
1481 * [AMENDMENT 23/5/2001] Optional build-arch and build-indep targets for
1482 debian/rules closes: Bug#72335
1483 * The old packaging manual is included in the policy document as an
1484 informative appendix. It is not part of Debian Technical Policy, and
1485 its presence is a temporary measure until dpkg documentation includes
1486 the information provided. closes: Bug#105535
1487 * Added information about optional blank lines in the chagelog format.
1490 -- Manoj Srivastava <srivasta@debian.org> Tue, 24 Jul 2001 21:43:22 -0500
1492 debian-policy (3.5.5.0) unstable; urgency=low
1494 * Fixed up incorrect entries in the changelog (there was an erroneous
1495 3.5.0.1 revision which never happened; it has now been correctly
1496 merged with the 3.5.3.0 changelog entry)
1497 * Add section numbers to upgrading-checklist for all revisions from
1499 * Complete rewrite (and renumbering) of sections 9.1 and 9,2
1500 * This time *really* include the HTML version of the FHS
1501 * Added doc-base support for all of the HTML files
1502 * Added several more files to the byhand list and rewrote chunks of
1503 debian/rules to do this
1504 * Add patched versions of debiandoc-sgml stuff to source package until
1505 patches are incorporated upstream
1506 * Versioned Build-Depend on debiandoc-sgml for fixed Text.pm
1507 * Improved mkdir example in 10.1.2 closes: Bug#92744
1508 * Made the "where examples live" entry in the upgrading-checklist
1509 clearer (add "for use by scripts")
1510 * Add a dpkg-statoverride description section closes: Bug#89473
1511 * Fix the ldconfig usage description (remove "only if")
1513 * Clarification of package priority issues vis-a-vis the X Windows
1514 system closes: Bug#91249
1515 * Enhanced x-terminal-emulator policy closes: Bug#91252
1516 * Minor changes to X app-defaults policy closes: Bug#91259
1517 * Clarification of X policy in respect to FHS closes: Bug#91260
1518 * OpenMotif has the same rules as OSF/Motif closes: Bug#91261
1519 * The X Font policy rewrite closes: Bug#91257
1520 * The "man" program is no longer guaranteed to read header information
1521 to find alternative manpage names closes: Bug#94995
1522 * Correction to meaning of Standards-Version closes: Bug#97072
1523 * Split section 12.8 (X Window System) into subsections for readability
1524 * Plug-ins != shared libraries (at last) closes: Bug#66023
1525 * Add packaging manual remnants to policy document as appendices, and
1526 mention this in control file closes: Bug#95906
1527 * Clarification in Perl policy closes: Bug#98712
1529 -- Julian Gilbey <jdg@debian.org> Fri, 1 Jun 2001 10:37:52 +0100
1531 debian-policy (3.5.4.0) unstable; urgency=low
1533 * [ACCEPTED 2/4/01] /var/mail and /var/spool/mail closes: Bug#42052
1534 * [AMENDMENT 26/04/2001] include Perl Policy closes: Bug#83977
1535 * Also incorporates all the improvements that Julian has made to to the
1536 grammar and flow of the policy manual. The following are mostly
1538 * Removed reference to non-extant dpkg documentation
1539 * Fixed the confusing self referential language. closes: Bug#85503
1540 * Correct ambiguous kanguage about declaring build dependencies.
1542 * Improved the woding of the footnote about shlibdeps.
1545 -- Manoj Srivastava <srivasta@debian.org> Sat, 28 Apr 2001 13:30:21 -0500
1547 debian-policy (3.5.3.0) unstable; urgency=low
1549 * Removed recommendation on packaging-manual
1550 closes: Bug#86507, #93620, #93705
1551 * Also now Conflicts and Replaces packaging-manual
1552 * Remove FSSTND from binary package, although retain it in the source
1553 package for the time being
1554 * Get the version.ent non-compression thingy right this time!
1555 * Also install FHS stuff byhand (as requested by webmasters)
1556 * Corrected GPL name and location closes: Bug#88788, #93047
1557 * Correct bug severities closes: Bug#91276
1558 * Correct typos etc. in policy-process
1559 * Rename all .text files as .txt
1560 * Fixed the "to to" typo in policy closes: Bug#87007
1561 * Changed packaging manual ==> dpkg documentation closes: Bug#88651
1562 * [ACCEPTED 14/03/2001] Deprecate confusing closes: Bug#87828
1563 Build-Depends arch syntax
1564 * [AMENDMENT 29/03/2001] Clarification of example closes: Bug#87711
1566 * Undo all renaming to text, since the change had not been propogated to
1567 the rules file, which broke badly. This shall have to wait for a later
1569 * Richard Braakman and Michael Dorman have expressed their resignation
1570 from policy maintenance duties.
1571 * fixed the date thinko in upgrading checklist. Thanks to Sébastien
1572 Montagne <sebastien.montagne@netcourrier.com> closes: Bug#84236
1574 -- Manoj Srivastava <srivasta@debian.org> Sun, 15 Apr 2001 13:36:19 -0500
1576 debian-policy (3.5.2.0) unstable; urgency=low
1578 * Add XFree86 app-defaults ammendment closes: Bug#83069
1580 -- Julian Gilbey <jdg@debian.org> Sun, 18 Feb 2001 14:11:49 +0000
1582 debian-policy (3.5.1.0) unstable; urgency=low
1584 * Removed deprecated virtual package names closes: Bug#84641
1585 * Changed rmdir postrm example (suggestion on -policy list)
1586 * Removed Richard Braakman from list of maintainers at his request
1587 * Corrected typos and grammatical errors found by Sean Perry
1588 closes: Bug#85501, #85504, #85505, #85506
1589 closes: Bug#85508, #85510, #85511, #85514
1590 closes: Bug#84631, #84636, #85497, #85982
1591 closes: Bug#85986, #85993, #86001
1592 * No longer include the old proposal document closes: Bug#84079
1593 * Update footnote about dpkg-shlibdeps now that it uses objdump; bump up
1594 minor version number for this
1595 * Updated dpkg-shlibdeps example to use up-to-date package names (and
1596 correct dpkg-shlibdeps command line syntax)
1597 * Clarify error conditions for package installation
1598 (Bug#61801 from packaging-manual)
1599 * Add the "main" section of each distribution (got left out by
1600 accident!) (Bug#64304, #75955 from packaging-manual)
1601 * Clean version numbering string (Bug#73064 from packaging-manual)
1602 * Install HTML version of FHS closes: Bug#83487
1603 * Removed bashism from debian/rules
1605 -- Julian Gilbey <jdg@debian.org> Thu, 15 Feb 2001 12:13:00 +0000
1607 debian-policy (3.5.0.0) unstable; urgency=low
1609 * There have been numerous changes since the last major change, and
1610 peole have had tiome now to review the recent changes, so I am
1611 updating the policy minor version to reflect the quantity and
1612 magnitude of changes since 3.2.1
1613 * More spelling corrections, thanks to "Christian T. Steigies"
1615 * Added mention of DEB_BUILD_OPTIONS in upgrading checklist.
1617 * Fixed some typos. closes: Bug#83960
1618 * Policy now mentions preinst scripts. closes: Bug#80342
1619 * [AMENDMENT 2000/12/26] allow/document use of Debian Configuration
1620 management system (debconf) closes: Bug#80347
1621 * Yet more typo fixes closes: Bug#82743
1622 * Document the fact that X font utilities have moved to the package
1623 xutils closes: Bug#82966
1624 * Fixed the date in the virtual package list closes: Bug#83438
1625 * Cleaned up some ephemeral informative foornotes of the polic. Thanks
1626 to Branden Robinson <branden@debian.org> closes: Bug#83065
1627 * Corrected reference to the mime policy. closes: Bug#79891
1628 * Corrected reference to the menu policy. closes: Bug#75925
1629 * Added a note to the effect that the example make snippet used to
1630 illustrate the DEB_BUILD_OPTIONS environment variable is merely
1631 informative, and expanded the example to dismiss any confusion about
1632 potential failure due to accidentally trying to strip scripts.
1635 -- Manoj Srivastava <srivasta@debian.org> Sun, 28 Jan 2001 21:59:16 -0600
1637 debian-policy (3.2.1.2) unstable; urgency=low
1639 * The minimal change in version number is so that people can test and
1640 root out the bugs in this document before we make everyone change to
1642 * Document the Enhances relationship
1643 * Removed the restriction that one, and exactly one, person must
1644 maintain a package. closes: Bug#51879
1645 * Fixed a typo, and added the nogroup name, in uid/gid section of
1646 policy. closes: Bug#53496
1647 * Fixed a misstatement in policy about not needing to depend on packages
1648 in the base system (not true -- the Essential tag is significant)
1650 * Clarified update-rc.d stuff closes: Bug#55048
1652 * We have already included the material for shlibdep changes, and most
1653 of this is not relevant to policy anyway. closes: Bug#55730
1654 * makedev--> MAKEDEV closes: Bug#57154
1655 * Added restrictions on the files in /usr/share/doc/
1657 * Changed location of a paragraph about copyright files into the section
1658 that deals with copyright files. closes: Bug#65765
1659 * init script configuration variables closes: Bug#66912
1660 * Clarifed language about packages sharing a conffile need to be marked
1661 as conflicting closes: Bug#76028
1663 -- Manoj Srivastava <srivasta@debian.org> Thu, 18 Jan 2001 01:43:58 -0600
1665 debian-policy (3.2.1.1) unstable; urgency=low
1667 * Don't compress version.ent in the doc directory (it gets bigger!)
1668 * Incorporate the packaging manual into the policy document. The minimal
1669 change in version number is because I suspect that this version is
1671 closes: Bug#62943, Bug#72949
1672 * Fixed typo in menu-policy. closes: Bug#70442
1673 * Fixed typo in policy manual closes: Bug#70634, Bug#70643
1674 * Removed extraneous > from policy closes: Bug#77645
1675 * Fixed two typos in upgrading checklist closes: Bug#78809, Bug#78822
1676 * Fixed spelling of utility closes: Bug#82458
1677 * [ACCEPTED 2000/09/08] Free pkgs depending on non-US should go into
1678 non-US/{main,contrib} closes: Bug#69229
1679 * Added rsh-server and telnet server to the virtual packages list
1681 * Fixed outdated references to the FHS. closes: Bug#77650
1683 -- Manoj Srivastava <srivasta@debian.org> Tue, 16 Jan 2001 23:53:31 -0600
1685 debian-policy (3.2.1.0) unstable; urgency=low
1687 * [AMENDMENT 15/01/2000] revision of the "to build with X support or
1688 not" policy. closes: Bug#53759
1689 * [ACCEPTED 2000/06/06] Must/Should/May in policy This is only a
1690 clarifying change, and was not intended to change the intent of
1691 policy. closes: Bug#64437
1692 * [ACCEPTED 03/05/2000] About the use of conffiles. closes: Bug#61308
1693 * [AMENDMENT 10/05/2000] s/mail\.mail/root\.mail/ closes: Bug#62668
1694 * [ACCEPTED 04/05/2000] Update for new non-US layout closes: Bug#62946
1695 * [ACCEPTED 04/05/2000] s/debian-devel/debian-legal/ closes: Bug#62947
1696 * [ACCEPTED 04/05/2000] s/bash/base-files/ closes: Bug#62948
1697 * Typo: 1744s/tty/ttyS/ closes: Bug#64516
1698 * proposal for mp3-encoder virtual package closes: Bug#64004
1699 * proposal for mp3-decoder virtual package closes: Bug#64006
1700 * new virtual package time-daemon closes: Bug#69031
1701 * [PATCH] typos in menu-policy.sgml closes: Bug#69424
1702 * [PATCH] typos and awkwardness in policy.sgml closes: Bug#69426
1703 * the example for using nostrip in DEB_BUILD_OPTIONS is
1704 incorrect. closes: Bug#69487
1705 * [PATCH] more corrections closes: Bug#69670
1706 * [AMENDMENT 26/10/99] Amend non-free definition closes: Bug#46522
1707 * [AMMENDMENT 29/10/99] /bin/sh needs echo -n closes: Bug#48247
1708 * [AMENDMENT 1999/11/23] Clarify meaning of Essential: yes
1710 * [ACCEPTED] Request for new virtual packages: rsh-client and
1711 telnet-client closes: Bug#58759
1713 -- Manoj Srivastava <srivasta@debian.org> Thu, 24 Aug 2000 02:06:30 -0500
1715 debian-policy (3.2.0.0) unstable; urgency=low
1717 * Fixed bugs in debian-policy package:
1718 * We have had doc-base support for a while now. closes: Bug#15709
1719 * packaging manual: Added additional clarification on dpkg
1720 behaviour. closes: Bug#17369
1721 * [PROPOSAL] Do not make hardlinks to conffiles closes: Bug#22935
1722 * [PROPOSED]: clarification needed about diversions.
1723 fixed usage for dpkg-divert closes: Bug#29522
1724 * [OLD PROPOSAL] debian-policy has an unclear statement
1725 on dependancies and priorities closes: Bug#39398
1726 * [ACCEPTED 10/26/99] changelog.html.gz sanitization. closes: Bug#40934
1727 * [AMENDED 07/09/1999] policy on -g, a proposal closes: Bug#43787
1728 * Fixed missing </chapt> tag. closes: Bug#51091
1729 * Correct typo in section 2.3.5 closes: Bug#52225
1730 * Documented that the library before the symlink hack
1731 (which dependend on file system specific kinks to work)
1732 is no longer required by newer versions of dpkg. closes: Bug#53405
1733 * [ACCEPTED 02/01/2000] policy for usage of "xserver"
1734 alternative closes: Bug#53755
1735 * [ACCEPTED 02/01/2000] additions to virtual package
1736 list closes: Bug#53756
1737 * [ACCEPTED 02/01/2000] policy for "x-terminal-emulator"
1738 virtual package and alternative closes: Bug#53757
1739 * [ACCEPTED 02/01/2000] policy for "x-window-manager"
1740 virtual package and alternative closes: Bug#53758
1741 * [ACCEPTED 02/01/2000] revision of X application-defaults
1742 policy closes: Bug#53760
1743 * [ACCEPTED 02/01/2000] revision of the Motif/LessTif
1744 policy closes: Bug#53761
1745 * [ACCEPTED 02/01/2000] applying the FHS to packages
1746 that use X closes: Bug#53762
1747 * [ACCEPTED 02/01/2000] policy for X font packages closes: Bug#53763
1748 * Moved the documents into the Debian/ section, since
1749 that is where they belong, really. closes: Bug#54777
1750 * Fixed the ftp location in the manuals. closes: Bug#56407
1751 * Fixed missing urlname entity in the sgml docs (where
1752 was it defined before anyway?) closes: Bug#56692
1753 * Fixed bugs in packaging-manual package:
1754 * Fixed typo where dpkg-genchanges was used instead of
1755 dpkg-gencontrol. closes: Bug#58771
1757 * Added policy-process to document current procedures.
1758 * Added a dependency on fileutiles >=4.0, since the package would fail
1759 to install with older fileutils.
1760 * Installed FHS version 2.1
1761 * Policy recommends packaging manual and vice versa
1762 * Added FHS details to copyright file
1763 * Updaed the upgrade checklist. Minor changes to the ./debian/rules
1765 * Added footnotes in the packaging manual warning about the upcoming
1766 dpkg-shlibdeps change as in Bug#55730
1768 -- Manoj Srivastava <srivasta@debian.org> Sun, 30 Jul 2000 17:43:02 -0500
1770 debian-policy (3.1.1.3) unstable; urgency=low
1772 * Fixed an upgrade bug when /usr/doc happens to be a symlink, and does
1773 not point to /usr/share/doc. A couple of people were bitten by this.
1775 -- Manoj Srivastava <srivasta@debian.org> Mon, 28 Feb 2000 22:27:05 -0600
1777 debian-policy (3.1.1.2) unstable; urgency=low
1779 * Correct missing </chapt> in packaging.sgml (closes: #51091)
1780 * Correct typo in policy 2.3.5 (closes: #52225)
1782 -- Julian Gilbey <jdg@debian.org> Mon, 20 Dec 1999 20:39:57 +0000
1785 debian-policy (3.1.1.1) unstable; urgency=low
1787 * Correction to typo in packaging manual, section 6.2.
1788 * Correction to typo in packaging manual, section 12.2.5 (closes:
1790 * More corrections to packaging manual typos (closes: #50857)
1792 -- Julian Gilbey <jdg@debian.org> Mon, 22 Nov 1999 19:23:31 +0000
1794 debian-policy (3.1.1.0) unstable; urgency=low
1796 * Correct description of negated architectures in Build-Depends
1797 description in Packaging manual (closes: #49901)
1799 -- Julian Gilbey <jdg@debian.org> Tue, 16 Nov 1999 15:03:48 +0000
1801 debian-policy (3.1.0.0) unstable; urgency=low
1803 * Add instructions on /usr/doc -> /usr/share/doc symlinks (closes:
1804 #45561, #42447, #48570)
1805 * Added source dependencies (closes: #41232)
1806 * Deprecated /etc/rc.boot (closes: #32448, #32449)
1807 * Update-rc.d now only legal way to automatically access /etc/rc?.d
1808 directoried (closes: #41547)
1809 * FHS compliant location of examples (closes: #42849)
1810 * Added ispell-dictionary to virtual-packages.list (following new
1811 suggestions: no objections => accept) (closes: #8221)
1812 * Added man-browser to virtual-packages.list (closes: #24695)
1813 * Added ident-server to virtual-packages.list (closes: #45307)
1814 * Alphabeticised virtual packages list ;)
1815 * Corrected GPL reference in proposal.sgml
1816 * Clarification of "extra" priority (closes: #33076)
1817 * Remove buggy and seriously problematic licenses from list of contrib
1818 package criteria (closes: #45318)
1819 * Move docs to /usr/share/doc with a compatibility symlink (closes:
1821 * Update to FHS 2.1 draft #3 (for /var/state etc. changes).
1822 * Correct /var/lib/games -> /var/games (closes: #42358)
1823 * Added MIME subpolicy (closes: #46516)
1824 * Added support for VISUAL (closes: #41121)
1825 * Clarify non-dependence on /usr/local (closes: #44922)
1826 * Modified description of mail spool locking (closes: #43651)
1827 * Clarified wording of conffiles and configuration files (closes:
1829 * Changed description of release numbers (closes: #44620)
1830 * Added changelog.html -> changelog requirement (closes: $40934)
1831 * packaging-manual now correctly installs its docs (closes: #44643)
1832 * The packaging manual now discusses version numbers based on dates
1834 * Mention ls -f for testing order in which files appear on disk (closes:
1836 * Change order of '.' and '+' in description of version numbers (closes:
1838 * s/fields/field names/ in section 4.1 of packaging manual for clarity
1839 * Add Build-Depends-Indep: field to control file
1841 -- Julian Gilbey <jdg@debian.org> Thu, 4 Nov 1999 23:50:37 +0000
1843 debian-policy (3.0.1.1) unstable; urgency=low
1845 * Typo corrected in packaging manual. closes: Bug#40180
1846 * Chnaged rules file to create ps and pdf files.
1848 -- Manoj Srivastava <srivasta@debian.org> Mon, 16 Aug 1999 01:21:09 -0500
1850 debian-policy (3.0.1.0) unstable; urgency=low
1852 * A few typos and omissions corrected
1853 * Added the pop3-server to the virtual packages list, as decided on the
1855 * Fix the self reference to a location on the web site. closes: Bug#39408
1856 * Added the clarification that the .la files are essential for the
1857 packages using libtool's libltdl library, in which case the
1858 .la files must go in the run-time library package. (this is why this
1859 is version 3.0.1.0, and not 3.0.0.1)
1860 * The virtual package list has new directions (this has been true for a
1861 while, I am just closing the bug now). closes: Bug#26159
1862 * Since this package now contains the FHS, this closes: Bug#25533
1863 * The General resolution prototcol handling of the logos closes: Bug#26915
1864 * Inclusion of the Menu policy in the main policy document closes: Bug#30036
1865 * Since proposal submitting guidelines are now in the policy package,
1866 this closes: Bug#38612
1867 * Changed a /usr/doc reference to /usr/share/doc which had beeen missed
1868 before. closes: Bug#40864
1870 -- Manoj Srivastava <srivasta@debian.org> Thu, 15 Jul 1999 13:35:11 -0500
1872 debian-policy (3.0.0.0) unstable; urgency=low
1874 * This is a test version of the policy package, and shall not be
1875 officially uploaded.
1876 * Merged in the packaging manual sources (we still have two separate
1878 * Multiple minor packaging tweaks.
1879 * [ACCEPTED 1998/05/01] Policy clarification about Standards-Version
1880 Added the clarifying paragraph (and the rationale in a footnote).
1882 * [ACCEPTED 1999/04/05] Policy note that GPL moved to
1883 /usr/share/common-licenses. Again, also added the rationale as a
1884 footnote. closes: Bug#28747
1885 * [ACCEPTED 1999/05/04] Libtool archive (*.la) files in -dev' packages
1886 closes: Bug#37257, Bug#37338
1887 * [ACCEPTED 1999/04/28] Logrotation. Standardizer on logrotate.
1889 * [ACCEPTED 1999/05/23] Rewrite of section 5.7 (Programs for the X
1890 Window System) closes: Bug#38212
1891 * [ACCEPTED 1999/05/15] Separate menu policy (like virtual package list)
1893 * [ACCEPTED 1999/05/09] Utmp group proposal
1895 * [ACCEPTED 1999/05/09] Adopt the FHS in place of FSSTND
1896 Changed all references to the proper FHS versions. This was a first
1897 scan, so some references may still need to be changed. closes: Bug#37345
1898 * Updated the upgrading checklist.
1899 * updated the proposal for policy update to reflect the latest
1901 -- Manoj Srivastava <srivasta@debian.org> Wed, 30 Jun 1999 22:49:15 -0500
1903 debian-policy (2.5.1.0) unstable; urgency=low
1905 * Removed double '>' marks from the policy document. closes: Bug#35095
1906 * Corrected canonical source for "Csh Programming Considered Harmful"
1907 closes: Bug#36286 Bug#32499
1908 * Fixed typo in invocation of update-rc.d. closes: Bug#34988 Bug#34543
1909 * Fixed misspelling of accessible. Ran ispell over the rest of the
1910 document (painful because of the large number of technical terms in
1911 there). closes: Bug#34233
1912 * Make the binary package contain the version.ent as well. closes: Bug#31033
1913 * Fixed typo s/as is/is/. closes: Bug#30302
1914 * AMENDMENT 23/04/1999: changed /etc/nntpserver recommendation to
1915 /etc/news/server. closes: Bug#21875
1916 * Added the current list of policy maintainers. closes: Bug#30148
1918 -- Manoj Srivastava <srivasta@debian.org> Tue, 27 Apr 1999 11:10:29 -0500
1920 debian-policy (2.5.0.0) unstable; urgency=low
1922 * AMENDMENT: Added in changes in Bug #25911, which rearranged sections
1923 to create a new section 4, namely, files. Section 3.3 ("Files") should
1924 become Section 4. The Sections that are currently Section 4 and
1925 Section 5 should be moved down to become Section 5 and Section 6
1928 What is now Section 5.5 ("Log files") should be moved to be a
1929 subsection of the new Section 4 ("Files"), becoming section 4.8,
1930 placing it after "Configuration files", moving the would-be Section
1931 4.8 ("Permissions and owners") to Section 4.9. All subsections of the
1932 current Section 5 after 5.5 should be accordingly moved down to fill
1935 This, along with the next amendment, justifies bumping up the version
1936 number. closes: BUG#25911
1938 * AMENDMENT: Added in changes in Bug #21185, about the naming and
1939 compression of changelog files. Now, if the upstream changelog file is
1940 HTML formatted, it should be accessible as
1941 /usr/doc/<package>/changelog.html.gz It also allows for this to be a
1942 symlink, if the upstream file name does not conform to Debian
1943 conventions. closes: BUG#21185
1945 * AMENDMENT: Added in changes in Bug #7890, to make clear that the HTML
1946 documents should be supplied in _some_ package, not necessarily in the
1947 main binary package (at the discretion of the maintainer).
1950 * AMENDMENT: Added in changes in Bug #26461, which corrects the policy
1951 to refer to /usr/doc/<package>/copyright, rather than
1952 /usr/doc/copyright/<package>. closes: BUG#26461
1954 * AMENDMENT: Added in changes in Bug #25385, which allow the
1955 architecture specification strings to be of the form <arch>-<os>,
1956 where os is one of linux, gnu. Previously, only linux was allowed, now
1957 we also cater to the hurd. closes: BUG#25385
1959 * The responsibility of the contents of this package has now passed to
1960 the debian-policy mailing list. The packaging details are now being
1961 managed by a group of maintainers that do ot won the contents.
1963 * Make the package optional, not extra.
1965 * Re did the SGML markup. Normalized the document, and undid the omitted
1966 and shor tags. Personally, I use too many DTD's in real life to be so
1967 converssant with each one to be clever with tag omissions, and, since
1968 I have a smart editor, omitting tags does not byuy one much. In the
1969 process, I discovered a few errors in the markup (one of my
1970 predecessors hasd the unfortunate habit of treating <p> as a "create
1971 some space here" tag, and more often than not put it at the end of a
1972 paragraph, rather than using is as a container element (which is what
1975 * Re did the control files, making them more robust
1977 * re did the rules file, making it more general, and easier to maintain
1978 by putting in a layer of abstractions.
1981 -- Manoj Srivastava <srivasta@debian.org> Thu, 29 Oct 1998 15:16:52 -0600
1983 debian-policy (2.4.1.4) unstable; urgency=low
1985 * New Maintainer <debian-policy@lists.debian.org>
1987 -- Philip Hands <phil@hands.com> Sat, 5 Sep 1998 02:41:35 +0100
1989 debian-policy (2.4.1.3) unstable; urgency=low
1991 * New maintainer (with changes from Adam P. Harris' proposed NMU)
1992 * policy.sgml: some awkward phrasings fixed (closes Bug#22006)
1993 * policy.sgml: s/depreciated/deprecated (closes Bug#21831)
1994 * debian/control: added conflict doc-base (<< 0.6), which I still am not
1995 sure why we need this but hey (closes Bug#21554)
1996 * policy.sgml: use new <url> tag where appropriate
1997 * policy.sgml, debian/control: always dynamically self reference the
1998 current version of policy, that is, do not hard code policy revision
2000 * debian/rules: use dpkg-gencontrol -isp
2001 * bugs fixed in some unknown previous version (closes Bug#23177)
2003 -- Philip Hands <phil@hands.com> Tue, 11 Aug 1998 09:54:17 +0100
2005 debian-policy (2.4.1.2) frozen unstable; urgency=low
2007 * non-maintainer release
2008 * rebuild package to fix truncated Chapter 3 (Bug#23408, not marked as
2009 important but should be, since a gaping hole in policy is very
2011 * bumped version of policy, within the document, to this version number,
2012 but not the date, indicating nothing really changed since then
2013 * no content changes
2014 * debian/rules: clean is a little cleaner
2016 -- Adam P. Harris <aph@debian.org> Tue, 16 Jun 1998 03:15:22 -0400
2018 debian-policy (2.4.1.1) frozen unstable; urgency=low
2022 -- Christian Schwarz <schwarz@debian.org> Thu, 14 May 1998 21:54:50 +0200
2024 debian-policy (2.4.1.0) frozen unstable; urgency=low
2026 * Changes to the Debian Policy Manual:
2028 - Updated section 3.1.2 Site-specific programs
2029 and section 3.8 Keyboard configuration:
2030 + improved wording (fixes:bug#20129)
2032 - Updated section 2.1.7 Subsections:
2033 + fixed typos (fixes:bug#18145)
2035 - Updated section 3.3.5 Symbolic links:
2036 + symbolic links within a toplevel directory should be relative,
2037 symbolic links between toplevel directories should be absolute
2038 (cf., Policy Weekly Issue#6, topic 2)
2040 - Updated section 3.4 System run levels:
2041 + Intro: mention /etc/rcS.d (links to boot time scripts)
2042 + Notes: include rationale why /etc/init.d scripts have to be tagged
2043 as conffiles (fixes:bug#16199)
2044 + Example: changed example init.d script to handle force-reload
2045 and restart options and to comply with the console message
2046 standard (fixes:bug#19216)
2048 - Updated section 4.8 Emacs lisp programs:
2049 + Replaced old section about lisp programs with a reference to
2050 the file debian-emacs-policy.gz, installed by the emacsen-common
2053 - Updated section 4.9 Games:
2054 + manpages for games should be installed in /usr/man/man6
2055 (cf., Policy Weekly Issue#6, topic 3)
2057 - Removed one example reference to the current standards version
2058 - Include manual's date as plain text in the .sgml source so that
2059 a recompiled manual uses the same release date
2061 * Changes to the authoritative list of virtual package names:
2062 - Removed obsolete virtual package `emacs'
2064 * New version numbering scheme:
2066 - The version numbers are independent of dpkg now, but all policy
2067 manuals (the Debian Policy Manual, the Debian Packaging Manual, and
2068 the Debian Developer's Reference) share the same version numbering
2071 - The first three digits of the version number specify the
2072 `Standards-Version.' This number is incremented with each policy
2073 change. The fourth digit represents the `patch-level,' which may
2074 differ between the manuals.
2076 If only the patch-level digit is incremented, no changes in policy
2077 have been made, except bug fixes and clarifications. Packages only
2078 have to specify the first three digits of the version number in the
2079 `Standards-Version' field of their source packages.
2081 * Packaging changes:
2083 - Uploaded to frozen and unstable. This is a documentation-only
2084 package and the changes to the manual are relevant for hamm.
2086 - Fixed FSF's address in copyright file (detected by Lintian)
2088 -- Christian Schwarz <schwarz@debian.org> Tue, 14 Apr 1998 10:08:09 +0200
2090 debian-policy (2.4.0.0) unstable; urgency=low
2092 * Changes to the Debian Policy Manual:
2094 - Updated section 3.3.4 Scripts:
2095 + /bin/sh may be any POSIX compatible shell
2096 + scripts including bashisms have to specify /bin/bash as
2098 + scripts which create files in world-writable directories
2099 (e.g., in /tmp) should use tempfile or mktemp for creating
2102 - Updated section 3.3.5 Symbolic Links:
2103 + symbolic links referencing compressed files must have the same
2104 file extension as the referenced file
2106 - Updated section 3.3.6 Device files:
2107 + /dev/tty* serial devices should be used instead of /dev/cu*
2109 - Updated section 3.4.2 Writing the scripts [in /etc/init.d]:
2110 + all /etc/init.d scripts have to provide the following options:
2111 start, stop, restart, force-reload
2112 + the reload option is optional and must never stop and restart
2115 - Updated section 3.5 Cron jobs:
2116 + cron jobs that need to be executed more often than daily should
2117 be installed into /etc/cron.d
2119 - Updated section 3.7 Menus:
2120 + removed section about how to register HTML docs to `menu'
2121 (the corresponding section in 4.4, Web servers and applications,
2122 has been removed in policy 2.2.0.0 already, so this one was
2125 - New section 3.8 Keyboard configuration:
2126 + details about how the backspace and delete keys should be
2129 - New section 3.9 Environment variables:
2130 + no program must depend on environment variables to get a
2131 reasonable default configuration
2133 - New section 4.6 News system configuration:
2134 + /etc/news/organization and /etc/news/server should be supported
2135 by all news servers and clients
2137 - Updated section 4.7 Programs for the X Windows system:
2138 + programs requiring a non-free Motif library should be provided
2139 as foo-smotif and foo-dmotif package
2140 + if lesstif works reliably for such program, it should be linked
2141 against lesstif and not against a non-free Motif library
2143 - Updated section 4.9 Games:
2144 + games for X Windows have to be installed in /usr/games, just as
2147 - Lots of typos fixed (thanks to Ray Dassen for the patch!)
2149 * Changes to the authoritative list of virtual package names:
2150 - added `libc-dev' and `emacsen'
2152 * Merged `/usr/doc/debian-policy/changelog-policy.gz' into this
2155 * Included `Policy checklist for upgrading your packages' from the
2156 Policy Home Page as /usr/doc/debian-policy/upgrading-checklist.text.gz
2158 * Added support for doc-base to register the Policy Manual to the
2159 online documentation systems dwww and dhelp (fixes:#15710)
2161 * Upgraded to standards version 2.4.0.0 (no changes)
2163 -- Christian Schwarz <schwarz@debian.org> Fri, 30 Jan 1998 21:58:25 +0100
2165 debian-policy (2.3.0.1) unstable; urgency=low
2167 * Changes in the Debian Policy Manual:
2168 - X library package is now called xlib6g
2169 * Changes in the authoritative list of virtual package names:
2170 - Added emacs, c-compiler, fortran77-compiler, lambdamoo-core,
2172 * Conflict with old dpkg-dev version that included policy manual
2174 * Removed `tentative-opt-draft' from package since people considered
2175 the draft official policy (which is not the case)
2176 * Don't use debstd anymore
2178 -- Christian Schwarz <schwarz@debian.org> Tue, 21 Oct 1997 23:03:52 +0200
2180 debian-policy (2.3.0.0) unstable; urgency=low
2182 * Changes in the Debian Policy Manual:
2183 - reworked chapter `The Debian Archive' to cover new
2184 contrib/non-free policy
2185 - call "contrib" and "non-free" a `section' (not `distribution')
2186 - refer to license files (GPL, LGPL, etc.) as uncompressed files
2187 - changed `/etc/news/server' into `/etc/nntpserver' in example of
2188 maintainer scripts (fixes #11517)
2189 - new section about `Daemons'
2190 - updated section about `Configuration files'
2191 - MUAs and MTAs have to use liblockfile
2192 - fixed typos and grammatical errors
2193 * Changes in the authoritative list of virtual package names:
2194 - renamed tcl/tk virtual package names to `tclsh' and `wish'
2195 * Paper about libc6 migration:
2196 - fixed typos (fixes #11641), thanks to James Troup for the patch!
2197 * SGML source code included in package
2198 * don't use `2-up' style for PostScript version (fixes #11095)
2200 -- Christian Schwarz <schwarz@debian.org> Mon, 2 Sep 1997 00:54:31 +0200
2202 debian-policy (2.2.0.0) unstable; urgency=low
2204 * Changes in the Debian Policy Manual:
2205 - completely reworked structure
2206 - moved sections about new maintainers, upload procedure, interim
2207 releases, and mailing lists into the Developers Reference Manual
2208 - moved a few (small) sections into the Debian Packaging Manual
2209 - removed all those ugly footnotes
2210 - new example for "reload" in section about console messages
2211 - mention Artistic License (fixes #9793)
2212 - don't mention dpkg's version number in Policy Manual
2213 - rewrote abstract and section introductions
2214 - mention "orphaned packages"
2215 - maintainer is responsible for a package license to comply with the
2216 distributions' policy
2217 - putting a package into base section requires discussion on debian-devel
2218 - rewrote sections about "pre-depends", "essential" and, "base" packages
2219 - added note that non-us' maintainers have to live outside the US
2220 - added crypto-hook statement (fixes #7257)
2221 - added section about arch spec strings
2222 - rewrote section about "Site specific programs" (/usr/local)
2223 - included Ian's suggestions for user IDs
2224 - added section about "menus"
2225 - removed section about "web menus" since this will be superseded with
2226 the new documentation policy soon
2227 - incorporated "Debian Free Software Guidelines" (fixes #9024)
2228 - removed note that linking with -g produces large a.out binary (fixes
2230 - added section about editors and pagers
2231 - added note about Package priorities and dependencies
2232 - added section about cron jobs (fixes #8814)
2233 - added section about device files
2234 - don't install shared libraries as executable (fixes #7129)
2235 - app-defaults files may not be conffiles (cf. #2717)
2236 - lots of minor changes not worth mentioning here (typos, formulations,
2238 * Changes in the authoritative list of virtual package names
2239 - Removed obsolete virtual packages: xR6shlib, xlibraries,
2240 compress, emacs, sgmls, inews, gs_x, gs_svga, gs_both, xpmR6
2241 - Added new section about obsolete names
2242 * Added Helmut Geyer's paper about libc5-libc6 migration
2243 * Fixed package's description
2245 -- Christian Schwarz <schwarz@debian.org> Sun, 13 Jul 1997 13:25:51 +0200
2247 debian-policy (2.1.3.3) frozen unstable; urgency=low
2249 * Mention Artistic License in section 2.5 (bug #9755)
2251 -- Christian Schwarz <schwarz@debian.org> Wed, 14 May 1997 16:53:15 +0200
2253 debian-policy (2.1.3.2) frozen unstable; urgency=low
2255 * Fixed an email address, an URL, and several typos in chapter 6 (#9358)
2256 * Added new virtual package "wordlist" to list (requested by Joey Hess)
2257 * Changed wording in section about "non-free" packages as suggested
2258 by Kai Henningsen (#7076)
2260 -- Christian Schwarz <schwarz@debian.org> Mon, 5 May 1997 20:05:39 +0200
2262 debian-policy (2.1.3.1) frozen unstable; urgency=low
2264 * Fixed bug in chapter 7: `-ur' should read `-us' (#8874)
2265 * Fixed bug in chapter 7: `-rwhatever' also needed for rebuild (#8874)
2266 * Create a PS and HTML version of the Policy Manual and upload it
2268 * Install virtual-package-names-list.text in /usr/doc/debian-policy
2269 and upload it "byhand" too.
2271 -- Christian Schwarz <schwarz@debian.org> Tue, 29 Apr 1997 18:02:14 +0200
2273 debian-policy (2.1.3.0) unstable; urgency=low
2276 * New Policy Manager: Christian Schwarz <schwarz@debian.org>
2277 * Added section 2.4 about the "non-us" distribution.
2278 * Added section 3.1.1 about the "Package" field in the control file.
2279 * Added section 3.2.1 about "Binaries": two programs with different
2280 functionality must not have the same name.
2281 * Changed headline of section 3.2.6 into "Debian changelog and upstream
2282 changelog" as suggested by Santiago Vila Doncel <sanvila@unex.es>.
2283 * Added log-rotating example to section 3.2.9 that tests with `-sf',
2284 as suggested by Boris D. Beletsky <borik@isracom.co.il>.
2285 * Added section 3.13: "Webstandard 3.0" by Christoph Lameter.
2286 * Added section 3.14: "Standard for Console Messages" by Christian Schwarz.
2287 * Split section 4.1 into 4.1.1 (Options for binaries) and 4.1.2 (Options
2289 * Added note to 4.1.2: Libraries should be compiled with `-D_REENTRANT'
2290 to make them compatible with LinuxThreads, by Rob Browning
2291 <osiris@cs.utexas.edu>.
2292 * Added note to 4.1.2: Libraries should be stripped with
2293 "strip --strip-unneeded", by Guy Maor <maor@ece.utexas.edu>.
2294 * Section 5.2: Policy changelog is now
2295 "/usr/doc/debian-policy/changelog-policy.gz". This fixes bug #6130.
2296 * Section 6.2 renamed to "Uploading your first Debian package". This
2299 -- Christian Schwarz <schwarz@debian.org> Sat, 15 Mar 1997 18:08:56 +0100
2301 debian-manuals (2.1.2.2) frozen unstable;
2303 * Fixed even more typographical and grammatical errors in Policy and
2305 * Corrected the contact email addresses again.
2306 * Added a paragraph to Policy 6.3 on taking over an old package (Guy Maor)
2307 * Added a paragraph to Programmer 4.2.14 on listing distributions to load
2308 a package into. (Guy Maor)
2309 * Further clarification of use of absolute pathnames in scripts in
2312 -- David Morris <bweaver@worf.netins.net> Tue, 3 Dec 1996 23:28:04 -0600
2314 debian-manuals (2.1.2.1) frozen unstable;
2316 * Many editorial and formatting revisions with suggestions from Ian Jackson,
2318 * correction of chiark address in Policy 6.2
2319 * footnote in Programmers chapter 2 pointing to deb(5) manpage for
2320 description of deb file format.
2321 * addition of more dpkg examples in Programmer chapter 2
2322 * Replace paragraph in Policy 4.1 outlining compiling parameters for
2324 * Added paragraph in Programmer 6.1 on paths in maintainer scripts
2326 * Cleaned up language and formatting of Programmer's 12.2, shlibs
2327 * Corrected contact addresses for listmaster and override-change
2329 -- David Morris <bweaver@worf.netins.net> Wed, 27 Nov 1996 08:17:16 -0600
2331 debian-manuals (2.1.2.0) frozen unstable;
2333 * Mostly editorial changes in Policy Manual.
2334 * Added summary of distribution criteria to Introduction
2335 * Added section headings for copyright criteria
2336 * Fixed typos (Bugs #4485, #4622)
2337 * Added paragraph in Compilation Options related to use of shared and
2338 static libraries. (Bug #5299)
2339 * Paragraph added about where to find PGP and other export restricted
2340 packages in section on Procedure
2341 * Change in List administrator and in the contact address for becoming
2342 a package maintainer
2343 * A paragraph added related to who to contact for package maintainer changes.
2344 * Changed where to send upload announcements: uploads destined for unstable,
2345 frozen, or experimental go to debian-devel-changes.
2347 * Made some mostly editorial changes to Programmers Manual.
2348 * Added a recommendation to debmake in Introduction.
2349 * A further interpretation of the various Distributions is added with
2350 the intent of helping people decide which one to choose. (section 4.2.14)
2351 * Section 12 on Shared Libraries expanded with further technical information
2352 on various shlib files
2353 * Section in 2.2 on format of shlib file moved to new subsection within 12.
2354 * Paragraph on adding a symlink without version number added to Shared
2355 Library Section (Guy Maor, Bug #5299)
2357 -- David Morris <bweaver@worf.netins.net> Fri, 22 Nov 1996 23:41:39 -0600
2359 debian-manuals (2.1.1.0) unstable;
2361 * Hard links are forbidden in source packages (they didn't work anyway,
2362 and can't easily be made to work reliably).
2363 * Do not use dpkg-divert or update-alternatives without consultation.
2365 * Do not need to declare dependencies on Essential packages.
2366 * Restrictions on Pre-Depends stated in policy manual.
2367 * debian/substvars file is now almost always auto-generated.
2368 * Shared libraries must be installed stripped.
2369 * Essential and Pre-Depends put together in policy manual.
2371 * Explained component-wise (file-wise) vs. package-wise dependencies.
2373 -- Ian Jackson <ian@chiark.greenend.org.uk> Thu, 12 Sep 1996 01:00:41 +0100
2375 debian-manuals (2.1.0.0) unstable;
2377 * Upstream changelog must be installed too (was just recommended).
2379 * Modification to use dpkg-shlibdeps added to conversion instructions.
2380 * Packages which are buggy and orphaned but which are preserved for
2381 compatibility go in contrib.
2383 * Programmers' manual source package section refers to conversion
2384 instructions in policy manual.
2385 * Make it clear that recommending a non-free or contrib package puts a
2388 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sun, 1 Sep 1996 17:47:18 +0100
2390 debian-manuals (2.0.1.0) unstable;
2392 * varargs.h and libtermcap are obsolete - use stdarg.h and ncurses.
2393 * Shared library link/library ordering corrected (aargh).
2394 * When to byte-compile Elisp files.
2395 * Missing final newlines not represented by dpkg-source.
2397 * Must post upload announcements to debian-changes.
2398 * Moved some sections into new `configuring and building' chapter.
2401 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sat, 31 Aug 1996 20:07:22 +0100
2403 debian-manuals (2.0.0.0) unstable;
2405 * Footnote added OK'ing copyrights which require name changes.
2406 * More detail about changelog format names.
2408 * Problematic licence restrictions are formatted as lists.
2409 * Mentioned 822-date utility as way to generate RFC822 format dates.
2413 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Mon, 26 Aug 1996 14:27:34 +0100
2415 debian-manuals (0.2.1.1) unstable;
2417 * Can't overwrite directories in one package with files in another.
2419 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sat, 24 Aug 1996 18:44:54 +0100
2421 debian-manuals (0.2.1.0) unstable;
2423 * Policy says when and how to include original source in upload.
2425 * Need -sa on dpkg-genchanges/dpkg-buildpackage when converting.
2427 * Use minor patchlevel for meaning changes which don't affect packages.
2428 * More verbosity about netiquette.
2429 * Reorganised participation and upload policy: merged with mailing lists.
2431 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Fri, 23 Aug 1996 12:48:09 +0100
2433 debian-manuals (0.2.0.1) experimental;
2435 * Said that system administrators' manual does not exist.
2437 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Fri, 23 Aug 1996 04:05:36 +0100
2439 debian-manuals (0.2.0.0) experimental;
2443 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Wed, 21 Aug 1996 15:07:53 +0100