1 debian-policy (3.8.2.0) UNRELEASED; urgency=low
4 * Policy: Mandate debconf or equivalent for user prompting
5 Wording: Andrew McMillan <awm@debian.org>
6 Seconded: Russ Allbery <rra@debian.org>
7 Seconded: Holger Levsen <holger@layer-acht.org>
8 Seconded: Bill Allombert <Bill.Allombert@math.u-bordeaux1.fr>
9 Seconded: Julien Cristau <jcristau@debian.org>
11 * Policy: Remove /etc/X11/XF86Config-4 FHS exception
12 Wording: Julien Cristau <jcristau@debian.org>
13 Seconded: Russ Allbery <rra@debian.org>
14 Seconded: Bill Allombert <Bill.Allombert@math.u-bordeaux1.fr>
16 * Policy: Remove obsolete /var/mail transition requirement
17 Wording: Russ Allbery <rra@debian.org>
18 Seconded: Julien Cristau <jcristau@debian.org>
19 Seconded: Andrew McMillan <andrew@morphoss.com>
21 * Policy: Move Speedo fonts into the deprecated category
22 Wording: Julien Cristau <jcristau@debian.org>
23 Seconded: Russ Allbery <rra@debian.org>
24 Seconded: Julien Danjou <acid@debian.org>
26 * Housekeeping (resynchronizing lists maintained elsewhere):
27 - Add GFDL 1.3 to the common-licenses list.
28 - Update the list of archive sections. (Closes: #519835)
29 * Set the release date of the 3.8.1 upgrading-checklist entry.
33 * The FHS is the "Filesystem Hierarchy Standard", regardless of our
34 preferred spelling of "file system" elsewhere. Fix this and a nearby
35 search-and-replace capitalisation bug.
36 * Build-depend on texlive-latex-extra, which is needed by
37 debiandoc2latexps and isn't included in texlive's dependencies.
38 * Policy: State requirements for source package names
39 Wording: Colin Watson <cjwatson@debian.org>
40 Seconded: Russ Allbery <rra@debian.org>
41 Seconded: Julien Cristau <jcristau@debian.org>
43 * Add myself to Uploaders.
45 -- Russ Allbery <rra@debian.org> Fri, 20 Mar 2009 14:45:46 -0700
47 debian-policy (3.8.1.0) unstable; urgency=low
49 * Policy: Clarify what "sensible behavior" is for init scripts
50 Wording: Steve Langasek <vorlon@debian.org>
51 Seconded: Raphaël Hertzog <hertzog@debian.org>
52 Seconded: Russ Allbery <rra@debian.org>
54 * Policy: Remove alternative changelog formats from main manual
55 Wording: Russ Allbery <rra@debian.org>
56 Seconded: Ben Pfaff <blp@cs.stanford.edu>
57 Seconded: Guillem Jover <guillem@debian.org>
59 * Policy: Mandate UTF-8 for changelog files
60 Wording: Russ Allbery <rra@debian.org>
61 Seconded: Guillem Jover <guillem@debian.org>
62 Seconded: Kurt Roeckx <kurt@roeckx.be>
64 * Policy: Mandate UTF-8 for control files
65 Wording: Russ Allbery <rra@debian.org>
66 Seconded: Kurt Roeckx <kurt@roeckx.be>
67 Seconded: Raphaël Hertzog <hertzog@debian.org>
69 * Policy: New option in DEB_BUILD_OPTIONS to avoid running test-suites
70 Wording: Russ Allbery <rra@debian.org>
71 Seconded: Guillem Jover <guillem@debian.org>
72 Seconded: Raphaël Hertzog <hertzog@debian.org>
74 * Policy: Expand expected capabilities for local in /bin/sh scripts
75 Wording: Russ Allbery <rra@debian.org>
76 Seconded: Guillem Jover <guillem@debian.org>
77 Seconded: Raphaël Hertzog <hertzog@debian.org>
79 * Policy: Clarify Essential definition and caution when adding to it
80 Wording: Russ Allbery <rra@debian.org>
81 Seconded: Jörg Sommer <joerg@alea.gnuu.de>
82 Seconded: Guillem Jover <guillem@debian.org>
84 * Policy: Allow user mail spools to be mode 0600 or 0660
85 Wording: Russ Allbery <rra@debian.org>
86 Seconded: Kurt Roeckx <kurt@roeckx.be>
87 Seconded: Andrew McMillan <awm@debian.org>
89 * Policy: Remove special handling of init scripts ending in .sh
90 Wording: Kel Modderman <kel@otaku42.de>
91 Seconded: Russ Allbery <rra@debian.org>
92 Seconded: Henrique de Moraes Holschuh <hmh@debian.org>
94 * Policy: /var/run and /var/lock may be volatile
95 Wording: Colin Watson <cjwatson@debian.org>
96 Seconded: Russ Allbery <rra@debian.org>
97 Seconded: Bill Allombert <Bill.Allombert@math.u-bordeaux1.fr>
99 * Policy: debian/control allows comments starting with #
100 Wording: Russ Allbery <rra@debian.org>
101 Seconded: Julien Cristau <jcristau@debian.org>
102 Seconded: Adeodato Simó <dato@net.com.org.es>
103 Seconded: Guillem Jover <guillem@debian.org>
105 * Improve the documentation of maintainer script actions for diversions
106 in the informative appendix to allow for addition of a new diversion
107 on upgrade and handle error cases correctly. Thanks to Olivier Berger
108 for the report and Raphaël Hertzog for the review. (Closes: #483418)
109 * Clarify the meaning of architecture restrictions on build dependencies
110 in the presence of alternatives. Thanks to Guillem Jover for the
111 explanation and review and Emilio Pozuelo Monfort and Don Armstrong
112 for wording review. (Closes: #163666)
113 * Change the term "category" to "archive area" when referring to main,
114 contrib, and non-free. This is closer to the wording of the Social
115 Contract. (Closes: #473439)
116 * Use <user>:<group> notation rather than <user>.<group> notation in
117 multiple places. Thanks, Kurt Roeckx. (Closes: #488039)
118 * Fix typo in 3.8.0.0 upgrading-checklist entry. Patch from Kobayashi
119 Noritada. (Closes: #487701)
120 * Mention debugging packages as an explicit example of packages with
121 extra priority. Thanks, Charles Plessy. (Closes: #491985)
122 * Clarify that translation is only required for user-visible debconf
123 messages. Capitalize "Debian Configuration Management Specification"
124 uniformly. Thanks, Julian Andres Klode. (Closes: #492624)
125 * Add --wildcards to the sample tar command in appendix B.1 for
126 extracting the package copyright file, adjusting for new tar option
127 behavior. Thanks, Yan Morin. (Closes: #503685)
128 * Reword the requirement that maintainer scripts exit with a zero
129 status on success to avoid double-negatives.
130 * Include the full name of each menu category rather than only the
131 portion relative to the parent heading to be clearer in long category
132 lists. Thanks, Christoph Berg. (Closes: #511804)
133 * Build-Depend on texlive rather than tetex-extra. texlive appears to
134 be sufficient for how Policy uses debiandoc-sgml and pulls in far
136 * Remove the postinst and prerm scripts. doc-base registration is now
137 handled by triggers and no longer required and removal of /usr/doc
138 links was completed long ago.
139 * Reference GPL-2 rather than the GPL symlink in debian/copyright.
141 -- Russ Allbery <rra@debian.org> Wed, 11 Mar 2009 20:50:52 -0700
143 debian-policy (3.8.0.1) unstable; urgency=low
145 * Don't attempt to register the non-existent debian-policy-process
146 document. Thanks, Adrian von Bidder. (Closes: #484706)
148 -- Russ Allbery <rra@debian.org> Thu, 05 Jun 2008 13:13:01 -0700
150 debian-policy (3.8.0.0) unstable; urgency=low
152 * Bug fix: "[PROPOSAL] "debian/README.source" file for packages with
153 non-trivial source", thanks to Wouter Verhelst, Jörg Sommer, Colin Watson,
154 and Junichi Uekawa (Closes: #250202).
155 * Bug fix: "[AMENDMENT 11/02/2008] Manual page encoding", thanks to
156 Colin Watson (Closes: #440420).
157 * Bug fix: "[PROPOSAL] common interface for parallel building in
158 DEB_BUILD_OPTIONS", thanks to Loïc Minier, Peter Samuelson, and Robert
159 Millan (Closes: #209008).
160 * Bug fix: "Please clarify splitting/syntax of DEB_BUILD_OPTIONS", thanks to
161 Loïc Minier, Peter Samuelson, Robert Millan, and Guillem Jover
163 * Bug fix: "Documentation for Breaks in dpkg", thanks to Ian Jackson
165 * Bug fix: "support for wrapped Uploaders should now be mandatory"
167 * Bug fix: "[PROPOSAL] Add should not embed code from other packages",
168 thanks to Neil McGovern, Colin Watson, Bill Allombert, Steve Langasek,
169 Kurt Roeckx, and others (Closes: #392362).
170 * Bug fix: "Homepage field in debian/control undocumented", thanks to
171 Mario Iseli (Closes: #452105).
172 * Bug fix: "Policy inconsistent with reality: base subsection no longer
173 used", thanks to Magnus Holmgren, Bernd Zeimetz, and Colin Watson
175 * Bug fix: "Inclusion of Apache Software License versions in
176 /usr/share/common-licenses", thanks to Barry Hawkins (Closes: #291460).
177 * Bug fix: "[Amended] copyright should include notice if a package is
178 not a part of Debian distribution", thanks to Taketoshi Sano
180 * Bug fix: "scripts as configuration files: should vs. must", thanks to Frank
181 Küster (Closes: #403391).
182 * Bug fix: "debconf specification should allow underscores in template
183 names", thanks to Colin Watson (Closes: #473761).
184 * Bug fix: "clarify handling of run-time and compile-time support programs",
185 thanks to Goswin Brederlow and Raphael Hertzog (Closes: #367984).
186 * Policy: better document version ranking and empty Debian revisions
187 Wording: Russ Allbery <rra@debian.org>
188 Seconded: Raphaël Hertzog <hertzog@debian.org>
189 Seconded: Manoj Srivastava <srivasta@debian.org>
190 Seconded: Guillem Jover <guillem@debian.org>
191 Closes: #186700, #458910
192 * Policy: remove obsolete app-defaults and Xresources provisions
193 Wording: Julien Cristau <jcristau@debian.org>
194 Seconded: Russ Allbery <rra@debian.org>
196 * Bug fix: "Examples of dpkg frontends should mention apt now", thanks
197 to Josh Triplett (Closes: #455602).
198 * Bug fix: "Minor typos and wording suggestions", thanks to Michael
199 Tautschnig (Closes: #422552).
200 * Bug fix: "substvar reference moved from dpkg-source(1) to
201 deb-substvars(5)", thanks to Ian Beckwith (Closes: #475731).
202 * Policy: bugs fixed in NMUs are now closed rather than marked fixed
203 Wording: Russ Allbery <rra@debian.org> (thanks, Sandro Tosi)
205 * Policy: C.1.4, C.1.8: minor typos
206 Wording: Sandro Tosi <matrixhasu@gmail.com>
208 * Remove the now-obsolete policy-process document.
209 * Add an md5sums control file.
210 * Add Vcs-Browser and Vcs-Git control fields.
211 * Remove build system support for FHS 2.1 and FSSTND, mostly commented out.
212 * Remove more temporary files created by the build.
213 * Remove the FSSTND license from debian/copyright; no FSSTND files are
214 currently part of policy.
215 * Update FHS copyright dates in debian/copyright.
216 * Standardize the spacing around headings in upgrading-checklist.html.
217 * Remove old ChangeLog files and metadata headers in maintainer scripts
220 -- Russ Allbery <rra@debian.org> Wed, 04 Jun 2008 15:53:27 -0700
222 debian-policy (3.7.3.0) unstable; urgency=low
224 * Bug fix: "FTBFS if built twice in a row" (Closes: #424212).
225 * Bug fix: "[PROPOSAL] Document ~ behavior in version numbers", thanks
226 to Nicolas François and Marc Brockschmidt (Closes: #382612).
227 * Bug fix: "Please add 'local' to list of supra-POSIX features that
228 /bin/sh can be expected to offer". Also add test -a/-o binary logical
229 operators and change references from POSIX to SUSv3 (Closes: #294962).
230 * Bug fix: "[Proposal] new Debian menu structure", thanks to Bill
231 Allombert (Closes: #361418).
232 * Bug fix: "typo: "must not be not world-writable"", thanks to Sam
233 Hocevar (Closes: #392594).
234 * Bug fix: "debian-policy: recommend binary:Version substvar instead",
235 thanks to Guillem Jover (Closes: #418444).
236 * Bug fix: "New virtual package: dictd-dictionary", thanks to Tatsuya
237 Kinoshita (Closes: #413575).
238 * The virtual package in use is inet-superserver, not inetd-superserver.
239 Adjust the virtual package list to match. Thanks, Tatsuya Kinoshita
241 * Wrapped, cleaned up trailing whitespace, and alphabetized the list of
243 * Bug fix: "Small spelling errors and erratic sentences in debian-policy",
244 thanks to Michiel de Boer. (Closes: #435207).
245 * Bug fix: "Source field of .changes files may contain a version number"
247 * Bug fix: "822-date is deprecated (use date -R instead)" (Closes: #448035).
248 * Bug fix: "5.6.17 (Urgency) should list emergency, maybe a normative
249 list?" (Closes: #412634).
250 * Bug fix: "[PROPOSAL] Document support of package types in shlibs
251 files", thanks to Franz Pop and Raphaël Hertzog (Closes: #363133).
252 * Bug fix: "Introduce a requirement for internationalisation of debconf
253 templates", thanks to Christian Perrier (Closes: #402975).
254 * Bug fix: "GFDL is now in common-licenses". Also add the rest of the
255 specific license versions and the GPLv3 (Closes: #420701).
256 * Bug fix: "Virtual package for Japanese font packages
257 (ttf-japanese-mincho and ttf-japanese-gothic)", thanks to Nobuhiro
258 Iwamatsu (Closes: #440931).
259 * Drop unsupported docbook-xml format from the doc-base file for the
260 debconf specification.
261 * Remove inactive uploaders and add Russ Allbery.
262 * Update Standards-Version to 3.7.3 (no changes required).
264 -- Russ Allbery <rra@debian.org> Sun, 02 Dec 2007 22:33:55 -0800
266 debian-policy (3.7.2.2) unstable; urgency=low
268 * Bug fix: "clarify 12.3 Additional documentation", thanks to Peter
269 Eisentraut (Closes: #367697).
270 * Bug fix: "debian-policy: s/dependcy/dependency/", thanks to Justin
271 Pryzby (Closes: #375508).
272 * Bug fix: "various spelling mistakes", thanks to Nico Golde
274 * Bug fix: "debian-policy: typo", thanks to Peter Samuelson
276 * Bug fix: "debian-policy: [PROPOSAL] maintainer scripts must not be
277 world writable", thanks to Kari Pahula (Closes: #376438).
278 * Bug fix: "policy-process: s/ a a / a /; s/peoples/people's/;
279 s/intiated/initiated/; s/participattion the/participation in the/? add
280 quotes; s/was a larger/a larger/?", thanks to Justin Pryzby
282 * Bug fix: "[PROPOSAL] Include the GFDL in the set shipped in
283 /usr/share/common-licenses", thanks to Adeodato Simó. However, it is
284 premature to tell packages to use the common licenses file until we
285 actually ship the license in /usr/share/common-licenses/ (Closes: #378386).
286 * Bug fix: "circular dependencies, improved guarantees", thanks to Ian
287 Jackson (Closes: #379630).
288 * Bug fix: "section on invoke-rc.d doesn't make sense", thanks to Peter
289 Eisentraut (Closes: #380692).
290 * Bug fix: "policy: postinst doesn't document typical abort-remove
291 case", thanks to Justin Pryzby. Removed all such comments. This is not
292 the place to document such material. (Closes: #373212).
293 * Bug fix: "use of "invoke-rc.d $PACKAGE stop || exit $?" in
294 prerm scripts", thanks to Lars Wirzenius (Closes: #370471).
295 * Bug fix: "debian-policy: Inconsistent requirements wrt bashisms",
296 thanks to Frank Küster (Closes: #367531).
297 * Bug fix: "debian-policy: s/with With/with /", thanks to Justin Pryzby
299 * Bug fix: "debian-policy: "$RET" not "RET"", thanks to Justin Pryzby
301 * Bug fix: "debian-policy: Spelling error in chapter 9.1.1:
302 exceptiions", thanks to Andreas Janssen (Closes: #388302).
303 * Bug fix: "[PROPOSAL] Document ~ behavior in version numbers", thanks
304 to Jakob Bohm (Closes: #382612).
305 * Bug fix: "debian-policy: [ACCEPTED] Request for the 'stardict'",
306 thanks to Andrew Lee (Closes: #385935).
307 * Bug fix: "[ACCEPTED] virtual package 'lzh-archiver' -- an LZH archiver
308 package", thanks to Ying-Chun Liu (PaulLiu) (Closes: #387027).
310 -- Manoj Srivastava <srivasta@debian.org> Mon, 2 Oct 2006 17:31:23 -0500
312 debian-policy (3.7.2.1) unstable; urgency=low
314 * Bug fix: "debian-policy: s/control are/&a/; s/stats/status/;
315 s/and/an/; s/'/"/; s/rewind/unwind/; s/fact/& that/; s/like
316 like/look like/;", thanks to Justin Pryzby (Closes: #372147).
317 * Bug fix: "debian-policy: Minor typo in footnote 53", thanks to Jordà
318 Polo (Closes: #372497).
319 * Bug fix: "debian-policy: Typo in 9.1.1: "'..' character"
320 should be "'.' character"", thanks to Matt Zagrabelny
322 * Bug fix: "debian-policy: More typos in upgrading-checklist.txt",
323 thanks to Kevin B. McCarty (Closes: #366466).
324 * Bug fix: "typo: package remains in and "Installed' state", thanks
325 to Sam Hocevar \(Debian packages\) (Closes: #369413).
326 * Bug fix: "debian-policy: Cleanup build-dependencies", thanks to Stefan
327 Huehner (Closes: #366032).
328 * Bug fix: "debian-policy: 2.2 should be named 'categories'", thanks to
329 Thomas Weber (Closes: #369912).
330 * Bug fix: "debian-policy: old postinst abort-upgrade, not new", thanks
331 to Justin Pryzby. The fix was thanks to Margarita Manterola
333 * Bug fix: "policy: please say which control fields can line-wrap",
334 thanks to Peter Samuelson (Closes: #372731).
335 * Bug fix: "debian/copyright should be mentioned in source section",
336 thanks to Ian Jackson (Closes: #369011).
337 * Bug fix: "GNU office not on Temple Place anymore", thanks to Dan
338 Jacobson (Closes: #366889).
340 -- Manoj Srivastava <srivasta@debian.org> Tue, 20 Jun 2006 00:18:19 -0500
342 debian-policy (3.7.2.0) unstable; urgency=low
344 * Revert the cgi-lib change.
345 * Bug fix: "Clarification for difference between Build-Depends and
346 Build-Depends-Indep (Section 7.6)", thanks to Christoph Berg
347 Note that this is not part of policy, just an informative footnote.
349 * Bug fix: "debian-policy: Typo in policy 5.6.3: semantic meaning",
350 thanks to Thijs Kinkhorst (Closes: #365907).
352 -- Manoj Srivastava <srivasta@debian.org> Wed, 3 May 2006 18:07:19 -0500
354 debian-policy (3.7.1.0) unstable; urgency=low
356 * Bug fix: "[PROPOSAL] 11.9: document handling of directories permission
357 when upgrading", thanks to Bill Allombert (Closes: #136318).
358 * Bug fix: "[DISCUSS] documentation of the "-fPIC" constraint", thanks
359 to Loïc Minier. Clarified when it may be reasonable to violate the standard
360 directive that shared libraries must be compiled with -fPIC, and
361 static libraries without, added the protocol to be followed when
362 doing so. (Closes: #329762).
363 * Bug fix: "Minor typo in upgrading checklist", thanks to David
364 Weinehall (Closes: #364982).
365 * Bug fix: "Typo in upgrading-checklist", thanks to David Weinehall
367 * Bug fix: "typo in debian policy section 10.9.1", thanks to Miguel Gea
368 Milvaques (Closes: #365058).
369 * Bug fix: "debian-policy: The section 11.8.5 needs some
370 clarifications", thanks to Robert Luberda (Closes: #365356).
371 * Bug fix: "11.8.7: X11R7 puts headers in /usr/include/X11", thanks to
372 Drew Parsons (Closes: #365510).
373 * Bug fix: "debian-policy: typo in policy-process:
374 "Guideliens"", thanks to Lars Wirzenius (Closes: #360518).
375 * Bug fix: "debian-policy: repeated word in section 10.4", thanks to
376 Russ Allbery (Closes: #364985).
377 * Bug fix: "typo in debian-policy", thanks to Miguel Gea Milvaques
380 -- Manoj Srivastava <srivasta@debian.org> Wed, 3 May 2006 11:17:42 -0500
382 debian-policy (3.7.0.0) unstable; urgency=low
384 * Bug fix: "[PENDING AMENDMENT 20/01/2000] Splitting cgi-bin", thanks to
385 Brian White. (Closes: #32263).
386 * Bug fix: "debian-policy: [PROPOSAL] Should update to Filesystem
387 Hierarchy Standard FHS 2.3", thanks to Tobias Burnus
388 (Closes: #230217, #212434, #344158).
389 * Bug fix: "[AMENDMENT 11/04/2006] Permit multi-line fields in
390 debian/control", thanks to John R. Daily. Mention that all fields,
391 except the Uploaders, are supposed to be a single logical line, which
392 may be spread over multiple physical lines (newline followed by space
393 is elided). Also mention that anything parsing the control file must
394 allow for a multi-line uploaders field. (Closes: #148194).
395 * Bug fix: "[AMENDMENT 12/04/2004] frown on programs in PATH with
396 language extentions", thanks to Joey Hess. (Closes: #190753).
397 * Bug fix: "init script stop example should use --oknodo", thanks to
398 Matt Kraai. Removed the example entirely. (Closes: #346598).
399 * Bug fix: "policy 12.5: Please recommend a sane practice WRT different
400 gpl versions (was: Re: RFC/RFS: beef - a flexible BrainFuck
401 interpreter)", thanks to Justin Pryzby. The subject leaves something
402 to be desired, but polic should not attempt to enumerate all common
403 licenses. (Closes: #355263).
404 * Bug fix: "debian-policy: Conflicting Architecture definitions", thanks
405 to Hans Ulrich Niedermann. Punt to dpkg-architecture to providing
406 legal architecture strings, since that's what is used by everyone
407 anyway. The version in policy was wrong, but that s=does not seem to
408 have hindered anyone, which indicates that this policy directive was
409 uneeded. Now the dpkg-architecture list is deemed authoritative, which
410 it is, but the format for the string is defined by policy, and the
411 current list of architecture strings is in an informative foot note.
413 * Bug fix: "[AMENDMENT 06/04/2006] Make use of invoke-rc.d, if
414 available, mandatory", thanks to Lars Wirzenius. (Closes: #361137).
415 * Bug fix: "no longer current regarding X font paths", thanks to Joey
416 Hess (Closes: #362247).
417 * Bug fix: "debian-policy: please prohibit circular dependencies, or
418 mention that dependencies won't be respected during prerm remove",
419 thanks to Justin Pryzby. Well, we did not prohibit circular
420 dependencies. But we do now have a warning that In case of circular
421 dependencies, since installation or removal order honoring the
422 dependency order can't be established, dependency loops are broken at
423 some random point, and some packages may not be able to rely on their
424 dependencies being present when being installed or removed, depending
425 on which side of the break of the circular dependcy loop they happen
426 to be on. (Closes: #362975).
427 * Bug fix: "8.6.4. Providing a `shlibs' file: s/should create/must
428 provide/", thanks to Christoph Berg. Clarified the wording.
430 * Bug fix: "debian-policy: Chapter 6 - Package maintainer scripts:
431 redundant info about exit status", thanks to Daniel Bonniot
433 * Bug fix: "debian-policy: Refers to upgrading-checklist.txt instead of
434 upgrading-checklist.txt.gz", thanks to Matt Kraai (Closes: #349775).
435 * Bug fix: "debian-policy: dpkg-gencontrol now uses -isp by default",
436 thanks to Guillem Jover (Closes: #359817).
437 * Bug fix: "[PROPOSAL] unclear recommendation for debconf w/
438 dpkg-statoverride", thanks to Eduard Bloch (Closes: #199849).
439 * debian-policy: please support Watch file as recommendation, thanks to
440 Bluefuture (Closes: #342611).
441 * Bug fix: "[PROPOSED] Mandate http servers to provide httpd-cgi as
442 relevenat", thanks to Uwe Hermann. This is already supported by the
443 http servers out there. (Closes: #117916).
445 -- Manoj Srivastava <srivasta@debian.org> Tue, 25 Apr 2006 23:56:16 -0500
447 debian-policy (3.6.2.2) unstable; urgency=low
450 * Bug fix: "policy is out of date re tasks and tasksel", thanks to Joey
451 Hess. Removed the section from policy. (Closes: #344310).
452 * Bug fix: "debian-policy: Please remove virtual package cron-daemon",
453 thanks to Steve Greenland (Closes: #257726).
454 * Bug fix: "debian-policy: incorrect tar example deb manipulation",
455 thanks to Bob Proulx (Closes: #224770).
456 * Bug fix: "Probable typo in 10.1 install -s miss INSTALL =", thanks to
457 Bill Allombert (Closes: #341992).
458 * Bug fix: "debian-policy: postinst abort-remove (6.7) not present in
459 summary (6.4)", thanks to Ferenc Wagner (Closes: #338493).
460 * Bug fix: "UTF-8 footnote is out of date (pre-sarge)", thanks to Martin
461 Michlmayr (Closes: #337539).
462 * Bug fix: "debian-policy: Typo in perl-policy", thanks to Tibor Csögör
464 * Bug fix: "debian-policy: Outdated FSF postal address in Copyright
465 Notice", thanks to Jean-Marc Ranger (Closes: #334819).
466 * Bug fix: "debian-policy: §6.5 (3)(1): missing "Error
467 unwind:" for "new-postrm abort-upgrade"", thanks to
468 Henning Makholm (Closes: #321792).
469 * Bug fix: "debian-policy: typo in §5.6.3: co-maintaintainers", thanks
470 to Henning Makholm (Closes: #321790).
471 * Bug fix: "debian-policy: typos in sect 9.3.1: "ends .sh",
472 "rather that"", thanks to Thijs Kinkhorst (Closes: #343933).
473 * Bug fix: "debian-policy: Unclear wording of ldconfig requirements in
474 section 8.1.1", thanks to Ben Finney (Closes: #318214).
475 * Bug fix: "debian-policy: Typo in 8.6.2: ${shlib:Depends} must be
476 ${shlibs:Depends}", thanks to Thijs Kinkhorst (Closes: #318147).
477 * Bug fix: "debian-policy: gzipped fhs-2.3 documentation is corrupt",
478 thanks to Gabor Gombas (Closes: #340189).
479 * Bug fix: "Section 6.3 should reference 3.10.1", thanks to Marc 'HE'
480 Brockschmidt (Closes: #326633).
481 * Bug fix: "debian-policy: section 2.2 refers to no-longer existant
482 non-US repository sections", thanks to Martin-Eric Racine
485 -- Manoj Srivastava <srivasta@debian.org> Sun, 25 Dec 2005 08:47:52 -0600
487 debian-policy (3.6.2.1) unstable; urgency=low
489 * Bug fix: "debian-policy: Typo in upgrading-checklist.txt.gz", thanks
490 to Romain Francoise. Added the missing /. (Closes: #314569).
491 * Bug fix: "x-session-manager already in use, so please add to
492 virtual-package-names-list.txt", thanks to Christopher Martin
494 * Bug fix: "[ACCEPTED] SRFI 22 names for Scheme implementations", thanks
495 to Jorgen Schaefer (Closes: #310113).
496 * Bug fix: "debian-policy: please add x-display-manager to
497 virtual-package-names-list.txt", thanks to Jon Dowland (Closes: #294633).
499 -- Manoj Srivastava <srivasta@debian.org> Sat, 18 Jun 2005 00:48:14 -0500
501 debian-policy (3.6.2.0) unstable; urgency=low
504 * Bug fix: "policy 11.5.3 refers to using the menu package to register
505 docs", thanks to Joey Hess (Closes: #222553).
506 * Bug fix: "[PROPOSAL] Document Uploaders: field in policy", thanks to
507 Andrew Pollock. Andreas Metzler provided the wording, though it was
508 modified during inclusion. (Closes: #203145).
509 * Bug fix: "debian-policy: Minor grammatical correction in section 9.4",
510 thanks to Eric Evans. I rejected the proposed change, instead I went
511 over the whole policy document and removed all he/she/him/her
512 constructs before the gender police jump all over me. (Closes: #273122).
513 * Bug fix: "XSI:ism in prerm and postinst", thanks to David Weinehall
515 * Bug fix: "debian-policy: please clarify section 12.7.", thanks to
516 Adrian Bunk. Added a clarifying footnote that makes it clear that
517 section 12.3 does not allow one to ignore section 12.7 (Closes: #276953).
519 * Bug fix: "debian-policy: should not ship generated files in source
520 archive, and should clean them from the tree", thanks to Branden
521 Robinson (Closes: #284967).
522 * Bug fix: "debian-policy: Detailed description of maintainer script
523 calls (Section 6.5) is incomplete", thanks to Nikolaus Schulz
524 and Thomas Hood. What happens when error unwinding itself runs into
525 problems is perhaps not discussed as completely as it should be.
527 * Bug fix: "9.3.3.2 "command -v" example needs tweaking",
528 thanks to Thomas Hood. Instead of the massively complex shenanigans
529 suggested in the bug report, just use which. which lives in an
530 essential package, so can be used in the preinst of packages.
532 * Bug fix: "debian-policy: please clarify/loosen the policy on rewriting
533 history", thanks to Frank Küster. Since this was not really a
534 directive, but merely an expression of an opinion, moved it into an
535 informative footnote. (Closes: #290270).
536 * Bug fix: "debian-policy: virtual package request: mpd-client", thanks
537 to Eric Wong (Closes: #270020).
538 * Bug fix: "[ACCEPTED 2005/02/04]: "libexec", or use of "lib" for
539 binaries in lib* packages", thanks to Junichi Uekawa
541 * Bug fix: "debian-policy: virtual package: flexmem", thanks to Bartosz
542 Fenski aka fEnIo (Closes: #239359).
543 * Bug fix: "Please clarify Section 2.5. required <-> essential",
544 thanks to Adrian Bunk. Clarified the section. (Closes: #216104).
545 * Bug fix: "debian-policy: Please remove virtual package
546 aspell-dictionary", thanks to Brian Nelson (Closes: #295939).
547 * Bug fix: "[AMENDMENT 18/02/2002] Where to place web-accessible
548 images", thanks to Tollef Fog Heen (Closes: #89867).
549 * Bug fix: "debian-policy: erroneous enumeration in prebuilt policy.*
550 files", thanks to Nikolaus Schulz. I am hoping that this shall go away
551 when we rebuild. (Closes: #286553).
552 * Bug fix: "please make names of alternate versions links", thanks to
553 Robert Cheramy. Added HTTPPATH elements that should provide the URL's
554 as well as the hyperlinks. (Closes: #308886).
555 * Bug fix: "www.debian.org: Misspelling in Policy Manual", thanks to
556 Roberto C. Sanchez Various spelling errors were also corrected in a
557 spell check run. (Closes: #309162).
559 -- Manoj Srivastava <srivasta@debian.org> Thu, 16 Jun 2005 20:27:17 -0500
561 debian-policy (3.6.1.1) unstable; urgency=low
564 * [AMENDMENT 15/09/2003] Move documentation of behavior of ancient dpkg
565 in 6.6 to a footnote. closes: Bug#209855
566 * Fix the outdated link for the mime subpolicy. closes: Bug#212153
567 * Fix a missing comma in the list of sections closes: Bug#215524
568 * Fix spelling of sysv-rc closes: Bug#215558
569 * [AMENDMENT 28/03/2004] ${perl:Depends} documentation
570 incomplete. Added an informative foot note stating that dependencies
571 caused by versioned uses and on separately packaged modules are not
572 included in this variable and must be explicitly included.
574 * Clarified that section 3.2.1 refers to the date based postion of the
575 version number, if not already clear from the context. This allows
576 developers leeway in selecting date based version numbers for their
577 packages, without loosing the advantages of the format specified in
578 this section. closes: Bug#248618
579 * Bug fix: "Broken link to virtual-package-names-list.txt in section
580 3.6", thanks to Carlos O'Donell (Closes: #248786).
581 * Bug fix: "Broken link to debconf_specification.txt.gz in section
582 3.10.1 of the Debian Policy manual.", thanks to Carlos O'Donell and
583 Scott C.MacCallum <scm@madoshi.com> (Closes: #248788, 247761).
584 * Bug fix: "missing commas in subsections list", thanks to Filippo
585 Giunchedi (Closes: #236614).
586 * Bug fix: "debian-policy: policy-process, broken URL", thanks to Manoj
587 Srivastava (Closes: #244969).
588 * Bug fix: "bad reference to debconf-devel(8) has to be (7)", thanks to
589 Kevin Price (Closes: #247143).
590 * Bug fix: "debian-policy: Small wording change", thanks to Mike Paul
592 * Bug fix: "debian-policy: broken URL: CSH Programming Considered
593 Harmful", thanks to Steven Augart (Closes: #253324).
594 * Bug fix: "New virtual package: cron-daemon", thanks to Adam Byrtek
597 * Fixed detection of invoke-rc.d's existence, closes: #218530.
598 * Generalized the dpkg-shlibdeps example and added a current example in a
599 footnote, set proper section ids and linked the d-sd section better,
601 * Clarified the section about the Architecture field and added footnotes
602 to indicate recommended actions, closes: #51832.
603 * Updated PGP references, closes: #68827.
604 * Linked f-Format in the list of fields of the .dsc file, not mandatory
605 according to my skimming of dpkg-source, closes: #70742.
606 * Fixed the command line required to output the copyright file,
608 * Removed the long obsolete notion of specific directory names within
609 source tarballs, closes: #79210.
611 * sgml-dtd was moved, fix FTBFS. Closes: #241683
612 * fix link to WM specification. Closes: #235484
613 * manpage -> man page. Closes: #232364, #238958
614 * language adjustment. Closes: #227762
615 * added virtual packages stardict-dictionary, inetd-superserver.
616 Closes: #185943, #237049
618 -- Manoj Srivastava <srivasta@debian.org> Fri, 25 Jun 2004 16:07:38 -0500
620 debian-policy (3.6.1.0) unstable; urgency=low
623 * Removed obsolete section on obsolete constructs and libraries,
626 * Change reference to the debconf introduction from kitenet to a debian
627 hosted server. closes: Bug#187297
628 * Added myspell-dictionary to the virtual packages list closes: Bug#203728
629 * Fix the restart action in the init.d/bind example; it now uses
630 --oknodo so that the action does not fail when the service is not
631 running. closes: Bug#187250
632 * invoke-rc.d and update-rc.d are now in the sysv-rc package instead of
633 the sysvinit package. Fixed a reference in policy. closes: Bug#200440
634 * Note that postinst abort-remove is called if there is an error while
635 removing the package. closes: Bug#188030
636 * [AMENDMENT 2003/08/03] Make Debconf the standard for prompting the
637 user closes: Bug#176506
639 -- Manoj Srivastava <srivasta@debian.org> Tue, 19 Aug 2003 07:28:10 -0500
641 debian-policy (3.6.0) unstable; urgency=low
644 * Restructured Policy, closes: #189306.
645 + Many packaging manual appendices that were integrated into policy
646 sections are now empty, and replaced with links to the Policy.
647 In particular, the appendices that included the list of control
648 fields were updated (new fields like Closes, Changed-By were added)
649 and the list of fields for each of control, .changes and .dsc files
650 is now in Policy, and they're marked mandatory, recommended or
651 optional based on the current practice and the behaviour of the
652 deb-building toolchain.
653 + Elimination of needlessly deep section levels, primarily in the
654 chapter Debian Archive, from which two new chapters were split out,
655 Binary packages and Source packages. What remained was reordered
656 properly, that is, some sect1s became sects etc.
657 + Several sections that were redundant, crufty or simply not designed
658 with any sort of vision, were rearranged according to the formula that
659 everything should be either in the same place or properly interlinked.
660 Some things remained split up between different chapters when they
661 talked about different aspects of files: their content, their syntax,
662 and their placement in the file system. In particular, see the new
663 sections about changelog files.
665 * Added Games/Simulation to menu subpolicy closes: Bug#194974
666 * Added Apps/Education to menu subpolicy closes: Bug#194972
667 * [ACCEPTED]: Debian changelogs should be UTF-8 encoded. Changed the
668 wording from a should to a may; since a should would make an unknown
669 number of packages insta buggy. A reuest makes all these wishlist
670 bugs; we can raise the severity in a later version of policy.
672 * Added LANG=C before the debiandoc2X invocations, this ensures that the
673 resulting documents do not get converted to the locale on the building
674 machine. This answers some of the issues mentioned in Bug#175064
675 * [AMENDMENT 02/05/2003] encourage packagers to systematically prevent
676 mis-linked libraries closes: Bug#191369
677 * [AMENDMENT 6/6/2003] build-depends-indep need not be satisfied
678 during clean target. closes: Bug#191411, Bug#178809
679 * Fixed the fact that section 7.5.1 does not describe dpkg's true
680 behavior. Now added a footnote that explains that replaces is a one
681 way relationship. closes: Bug#183195
682 * Could no longer find the misspelling "seciton", thus this must have
683 been fixed in a previous change in the manual. closes: Bug#193903
684 * Fixed an incorect /usr/share/common-licences/GPL reference, ensured a
685 consistent spelling across the manuals. closes: Bug#189516
686 * Removed an extraneous > in menu policy. closes: Bug#187615
687 * Fixed typos, and part of the report that was deemed valid; the other
688 changes suggested were incorrect, or style issues. closes: Bug#169744
689 * updated the section numbers in the upgrading checklist
690 for the restructuring
692 -- Josip Rodin <joy-packages@debian.org> Wed, 9 Jul 2003 18:01:35 +0200
694 debian-policy (3.5.10.0) unstable; urgency=low
697 * Fixed date, typos and added indentation in the virtual packages list,
699 * Changed the formatting of the link to the authors section to avoid
700 confusion in the debiandoc2txt output, closes: #185985.
701 * Fixed various typos, closes: #189274, #187418, #187422, #189654.
702 * Removed broken link to csh.whynot on CPAN, closes: #187567.
703 * Updated archive section list, closes: #187420.
704 * Stop attaching byhand tarballs, cf. bug #184082.
706 * Clarify x-terminal-emulator virtual package eligibility, in an
707 extention to an informative footnote. closes: Bug#165063
708 * Add 40 points, not 20, when the window manager is compliant with "The
709 Window Manager Specification Project". closes: Bug#167004
710 * Fixed reference to the debconf URL (we can change the URL as it
711 changes again, and I don't think any additional load would accrue
712 since people using the old URL were redirected to auric anyway).
714 * Inserted the word only in the package name section. closes: Bug#184368
715 * Amended the section about Prompting in maintainer scripts. Added a
716 footnote (quoting from the Jargon File) to explain what "by hand"
717 means in a computer context. closes: Bug#184507
719 -- Josip Rodin <joy-packages@debian.org> Sat, 10 May 2003 19:13:50 +0200
721 debian-policy (3.5.9.0) unstable; urgency=low
724 * Added missing bits of information about Description: fields from
725 the old Packaging manual, closes: #172022
726 * Fixed a stale reference to the "base system maintainer" to
727 base-passwd maintainer, closes: #174927
728 * Fixed an accidental change from /usr/share/package to /usr/share/doc in
729 the paragraph about not depending on /usr/share/doc/package,
731 * Fixed several errors reported by Guenther Palfinger, with some help from
732 Richard Braakman, closes: #177205, #177206, #177207, #177208, #177209
733 * Added versions to links and docbook-xml source-dependencies, hopefully
734 fixes the bug with potato, and even if it doesn't, I don't care :)
736 * Fixed typos in the debconf spec noticed by Jay Bonci, closes: #178455
737 * Clarified that using Build-Depends for build-dependencies is not a "may"
738 but a "should", added proper linking among various sections dealing with
739 the dependencies so that there is no confusion, closes: #87510
740 If any one of those poor, misguided people ;) still thinks that the
741 requirement should be a "must" (in _our_ meaning, not RFC "MUST"),
742 please file a new bug, as it's quite unproductive to have to sift
743 through a 152-page bug log which mostly goes back-and-forth with
744 explanations how policy should work, occasionally sprinkled with
746 * When asked to restart a service that isn't already running, the init
747 script should start it, closes: #60979
748 * Rephrased section on configuration files to remove confusing use of
749 "should", closes: #170019
750 * Rearranged the shared library information properly, closes: #109166
751 This change also centralizes the info on how to ship static libraries
752 in one place (hopefully not too ambiguous), closes: #93975
753 * Allow examples to be placed in /usr/share/doc/package/ in packages
754 that are meant to provide examples, closes: #69864
755 * Removed several references to the Policy manual etc in the stuff
756 imported from old packaging manual, closes: #181923
757 * Fixed too greedy wildcard match in the logrotate example,
760 -- Manoj Srivastava <srivasta@acm.org> Fri, 7 Mar 2003 12:35:16 -0600
762 debian-policy (3.5.8.0) unstable; urgency=low
765 * Added example for why one may call ldconfig anywhere in the
766 postsint. closes: Bug#120585
767 * Add the modifications about base system, as opposed to the soon to be
768 obsolete base section (I assume it is) closes: Bug#53582
769 * Rearranged the virtual packages list. closes: Bug#72980
770 * This is basically an attempt to ratify the current practice of using
771 debhelper in the clean target. Currently, policy does not require
772 debhelper to be installed when the clean target is run, even though it
773 is in the build-depends field. This was a simple oversight.
775 * No longer depend on fileutils. closes: Bug#167425
776 * Added the Apps/Science menu section closes: Bug#162812
777 * Applied text patch from Joey Hess to the debconf spec simply make it
778 conform to the reality of how some things work now. This is part of an
779 effort to make debconf and cdebconf better substitutes for each
780 other. Since it was not an XML patch, no special markup is present in
781 the new content, except where I made guesses. closes: Bug#160776
782 * Clarify section 13.3. closes: Bug#160248
783 * Removed the undocumented(7) hack requirement. closes: Bug#39830
785 * Removed the obsolete notion of documenting changes within the copyright
786 file, closes: Bug#65764
788 -- Manoj Srivastava <srivasta@debian.org> Fri, 15 Nov 2002 00:36:54 -0600
790 debian-policy (3.5.7.1) unstable; urgency=low
792 * Fix the debconf spec to (postinst -> postrm) closes: Bug#129375, Bug#160839
793 * Fix update-rc.d example, mention that changing run-levels or priority
794 may require removing and re-creating the symbolic links. closes: Bug#149709
795 * Fix the groff and col -b interaction closes: Bug#164755
796 * Added section numbers to upgrading checklist closes: Bug#160914
797 * Fixed typo KB_Backspace -> KB_BackSpace
798 * Clarify wording in the section about ChangeLog files to allow for
799 symbolic links in /usr/share/doc/ directory (was already allowed in a
800 previous section of policy 13.6) closes: Bug#111137
801 * Removed a spurious + from text. closes: Bug#160908
802 * Added a note in the debconf spec to consult debconf-devel(8) for
803 details. closes: Bug#133030
804 * Added a reference to the local copy of the FHS. closes: Bug#122928
805 * Updated reference to ash (dash). This implements the non controversial
808 -- Manoj Srivastava <srivasta@debian.org> Sat, 26 Oct 2002 13:12:49 -0500
810 debian-policy (3.5.7.0) unstable; urgency=low
812 * Fixed some broken hrefs in links
813 * No longer use local debiandoc stuff (it's been fixed upstream)
814 * Added table of contents (index.html) to policy-process.sgml, fixing
815 the new error reported to bug #137521 closes: Bug#137521
816 * Fixed a couple of typos closes: Bug#139832
817 * Ran through the policy document looking for long instances of text in
818 the <tt> tag, and changed it to <file> where appropriate. This is
819 since the <file> tag can handle line breaking, but the <t> flag does
820 not. closes: Bug#139820
821 * Change the requirement to ask permission to make devices to merely
822 requiring a notification. closes: Bug#106280
823 * Added a build dependson docbook utils. closes: Bug#154660
824 * Since this is being built with a newer version of debiandoc-sgml, this
825 should display better with lynx. closes: Bug#153704
826 * Add in the crypto-in-main amendment. closes: Bug#81852, Bug#144411
827 * we no longer have task packages, instead, we define tasks using a
828 special field in the control file (and these should be added only
829 after discussion on the mailing lists) closes: Bug#97755
830 * Clarify wording in the section for packages providing fonts.
832 * Fix the doc base file for policy process closes: Bug#137521, Bug#147554
834 * using set -e is not dubious advice. Rejecting this. closes: Bug#139969
835 * Make the directory one is building under ./debian/ be up to the
836 maintainer, instead of mandating ./debian/tmp/ closes: Bug#144297
837 * Add a standards version closes: Bug#145067
838 * Added virtual package debconf-2.0 closes: Bug#151328
839 * Added The Window Manager Specification Project support to the default
840 window manager selection mechanism closes: Bug#155680
841 * The confusion between /var/mail and /var/spool/mail seems to have been
842 disambiguated. closes: Bug#114949
843 * Mention the new Build-Depend-Indep semantic and the new
844 build-indep/build-arch rules in upgrading checklist closes: Bug#116134
845 * Made package naming rules in policy consistent. I did not eliminate
846 the duplication, since I don't want to make major changes to the flow,
847 since we are supposed to be re-writing policy anyway. closes: Bug#131441
848 * Clarified wording about cases where we may have concrete and virtual
849 packages with the same name. closes: Bug#134977
850 * Fixed typo 'be be' closes: Bug#138681
851 * Fixed typo in appendix G -- example of diversion closes: Bug#140697
852 * fix typo shlib: -> shlibs: closes: Bug#141903
853 * Provide a link between two sections dealing with virtual packages.
855 * Fixed xtifr's email address in the menu policy closes: Bug#152965
856 * Allow shared library names to be have a hyphen between library name
857 and soversion if the library name ends in a number. closes: Bug#100472
858 * Permit some libraries to only install static libs. closes: Bug#100346
859 * Remove the debug option, add noopt closes: Bug#157131, Bug#113525
860 * provide dhcp-client virtual package. closes: Bug#154142
861 * We do not need bits in policy that ``should not be enforced''.
863 * We are building this with the latest debianndoc-sgml. closes: Bug#146703
864 * Finish incorporating all of the accepted changes in Bug#72335, and
865 this closes: Bug#141307, Bug#156546
866 * Added virtual package aspell-dictionary closes: Bug#139067
867 * Added virtual package radius-server closes: Bug#118608
868 * Clarifying manual pages is not a policy issue. closes: Bug#112828
869 * Corrected the ldconfig handling instructions. closes: Bug#111025
870 * Not a policy issue. closes: Bug#106826
871 * Removed the /usr/doc/ symlink clause. closes: Bug#47298, Bug#69311
873 -- Manoj Srivastava <srivasta@debian.org> Sat, 31 Aug 2002 02:18:02 -0500
875 debian-policy (3.5.6.1) unstable; urgency=low
877 * Set the cotact information for the FHS contact, and add mention of the
878 FHS mailing list. closes: Bug#137172
879 * ftp://ftp.debian.org/debian/doc/package-developer/ certainly seems to
880 exist, and does contain the menu policy. closes: Bug#110711, Bug#121977
881 * Added java related virtual packages closes: Bug#110713
882 * Fixed confusion in appar4ently contradictory wording about /etc/init.d
883 scripts: clarified to emphasize that the init.d files _are_
884 configuration files, and they _must_ have local changes preserved,
885 either (if they are present in the .deb) by marking them as conffiles
886 or, if they do not exist in the .deb file, by any other means. This
887 does not change any requirements, and should have no affect on any
888 conformant packages. closes: Bug#132621
889 * Fixed error in doc-base file closes: Bug#137521
890 * fixed typo in virtual packages list closes: Bug#110446
891 * Fixed typo in upgrading checklist. closes: Bug#110705
892 * Fixed typo (dependencies) in the policy closes: Bug#122931
893 * Fixed grammar errors in the policy closes: Bug#126131
894 * While I am cleaning out bugs, these are old and the reporter no longer
895 wnats to pursue them, and there was never a consensus reached. If
896 there is interest, new bugs can be filed. closes: Bug#51411, Bug#51412
897 * Added the virtual package dict-client closes: Bug#122996
898 * Added the virtual package foomatic-data closes: Bug#123570
899 * Added the virtual packages {x-}audio-mixer closes: Bug#131781
901 -- Manoj Srivastava <srivasta@debian.org> Thu, 14 Mar 2002 12:16:53 -0600
903 debian-policy (3.5.6.0) unstable; urgency=low
905 * Change footnote about urgency values to the now-current list: low,
906 medium, high, emergency.
907 * Correct note about /etc/default files being conffiles/config files,
908 which I mucked up (sorry Joey) [10.3.2]
909 * [AMENDMENT 2001/06/26] Downgrade emacs/tex to optional
910 closes: Bug#102204, Bug#53849
911 * [AMENDMENT 2001/06/26] Next stage in usr/doc -> usr/share/doc transition
914 * [AMENDMENT 09/06/2001] Clarifying FHS policy closes: Bug#98291, Bug#60461
915 * Spelling correction closes: Bug#105625
916 * [AMMENDMENT 28/06/2001] Restrict http access to /usr/share/doc
918 * [AMENDMENT 23/5/2001] Optional build-arch and build-indep targets for
919 debian/rules closes: Bug#72335
920 * The old packaging manual is included in the policy document as an
921 informative appendix. It is not part of Debian Technical Policy, and
922 its presence is a temporary measure until dpkg documentation includes
923 the information provided. closes: Bug#105535
924 * Added information about optional blank lines in the chagelog format.
927 -- Manoj Srivastava <srivasta@debian.org> Tue, 24 Jul 2001 21:43:22 -0500
929 debian-policy (3.5.5.0) unstable; urgency=low
931 * Fixed up incorrect entries in the changelog (there was an erroneous
932 3.5.0.1 revision which never happened; it has now been correctly
933 merged with the 3.5.3.0 changelog entry)
934 * Add section numbers to upgrading-checklist for all revisions from
936 * Complete rewrite (and renumbering) of sections 9.1 and 9,2
937 * This time *really* include the HTML version of the FHS
938 * Added doc-base support for all of the HTML files
939 * Added several more files to the byhand list and rewrote chunks of
940 debian/rules to do this
941 * Add patched versions of debiandoc-sgml stuff to source package until
942 patches are incorporated upstream
943 * Versioned Build-Depend on debiandoc-sgml for fixed Text.pm
944 * Improved mkdir example in 10.1.2 closes: Bug#92744
945 * Made the "where examples live" entry in the upgrading-checklist
946 clearer (add "for use by scripts")
947 * Add a dpkg-statoverride description section closes: Bug#89473
948 * Fix the ldconfig usage description (remove "only if")
950 * Clarification of package priority issues vis-a-vis the X Windows
951 system closes: Bug#91249
952 * Enhanced x-terminal-emulator policy closes: Bug#91252
953 * Minor changes to X app-defaults policy closes: Bug#91259
954 * Clarification of X policy in respect to FHS closes: Bug#91260
955 * OpenMotif has the same rules as OSF/Motif closes: Bug#91261
956 * The X Font policy rewrite closes: Bug#91257
957 * The "man" program is no longer guaranteed to read header information
958 to find alternative manpage names closes: Bug#94995
959 * Correction to meaning of Standards-Version closes: Bug#97072
960 * Split section 12.8 (X Window System) into subsections for readability
961 * Plug-ins != shared libraries (at last) closes: Bug#66023
962 * Add packaging manual remnants to policy document as appendices, and
963 mention this in control file closes: Bug#95906
964 * Clarification in Perl policy closes: Bug#98712
966 -- Julian Gilbey <jdg@debian.org> Fri, 1 Jun 2001 10:37:52 +0100
968 debian-policy (3.5.4.0) unstable; urgency=low
970 * [ACCEPTED 2/4/01] /var/mail and /var/spool/mail closes: Bug#42052
971 * [AMENDMENT 26/04/2001] include Perl Policy closes: Bug#83977
972 * Also incorporates all the improvements that Julian has made to to the
973 grammar and flow of the policy manual. The following are mostly
975 * Removed reference to non-extant dpkg documentation
976 * Fixed the confusing self referential language. closes: Bug#85503
977 * Correct ambiguous kanguage about declaring build dependencies.
979 * Improved the woding of the footnote about shlibdeps.
982 -- Manoj Srivastava <srivasta@debian.org> Sat, 28 Apr 2001 13:30:21 -0500
984 debian-policy (3.5.3.0) unstable; urgency=low
986 * Removed recommendation on packaging-manual
987 closes: Bug#86507, #93620, #93705
988 * Also now Conflicts and Replaces packaging-manual
989 * Remove FSSTND from binary package, although retain it in the source
990 package for the time being
991 * Get the version.ent non-compression thingy right this time!
992 * Also install FHS stuff byhand (as requested by webmasters)
993 * Corrected GPL name and location closes: Bug#88788, #93047
994 * Correct bug severities closes: Bug#91276
995 * Correct typos etc. in policy-process
996 * Rename all .text files as .txt
997 * Fixed the "to to" typo in policy closes: Bug#87007
998 * Changed packaging manual ==> dpkg documentation closes: Bug#88651
999 * [ACCEPTED 14/03/2001] Deprecate confusing closes: Bug#87828
1000 Build-Depends arch syntax
1001 * [AMENDMENT 29/03/2001] Clarification of example closes: Bug#87711
1003 * Undo all renaming to text, since the change had not been propogated to
1004 the rules file, which broke badly. This shall have to wait for a later
1006 * Richard Braakman and Michael Dorman have expressed their resignation
1007 from policy maintenance duties.
1008 * fixed the date thinko in upgrading checklist. Thanks to Sébastien
1009 Montagne <sebastien.montagne@netcourrier.com> closes: Bug#84236
1011 -- Manoj Srivastava <srivasta@debian.org> Sun, 15 Apr 2001 13:36:19 -0500
1013 debian-policy (3.5.2.0) unstable; urgency=low
1015 * Add XFree86 app-defaults ammendment closes: Bug#83069
1017 -- Julian Gilbey <jdg@debian.org> Sun, 18 Feb 2001 14:11:49 +0000
1019 debian-policy (3.5.1.0) unstable; urgency=low
1021 * Removed deprecated virtual package names closes: Bug#84641
1022 * Changed rmdir postrm example (suggestion on -policy list)
1023 * Removed Richard Braakman from list of maintainers at his request
1024 * Corrected typos and grammatical errors found by Sean Perry
1025 closes: Bug#85501, #85504, #85505, #85506
1026 closes: Bug#85508, #85510, #85511, #85514
1027 closes: Bug#84631, #84636, #85497, #85982
1028 closes: Bug#85986, #85993, #86001
1029 * No longer include the old proposal document closes: Bug#84079
1030 * Update footnote about dpkg-shlibdeps now that it uses objdump; bump up
1031 minor version number for this
1032 * Updated dpkg-shlibdeps example to use up-to-date package names (and
1033 correct dpkg-shlibdeps command line syntax)
1034 * Clarify error conditions for package installation
1035 (Bug#61801 from packaging-manual)
1036 * Add the "main" section of each distribution (got left out by
1037 accident!) (Bug#64304, #75955 from packaging-manual)
1038 * Clean version numbering string (Bug#73064 from packaging-manual)
1039 * Install HTML version of FHS closes: Bug#83487
1040 * Removed bashism from debian/rules
1042 -- Julian Gilbey <jdg@debian.org> Thu, 15 Feb 2001 12:13:00 +0000
1044 debian-policy (3.5.0.0) unstable; urgency=low
1046 * There have been numerous changes since the last major change, and
1047 peole have had tiome now to review the recent changes, so I am
1048 updating the policy minor version to reflect the quantity and
1049 magnitude of changes since 3.2.1
1050 * More spelling corrections, thanks to "Christian T. Steigies"
1052 * Added mention of DEB_BUILD_OPTIONS in upgrading checklist.
1054 * Fixed some typos. closes: Bug#83960
1055 * Policy now mentions preinst scripts. closes: Bug#80342
1056 * [AMENDMENT 2000/12/26] allow/document use of Debian Configuration
1057 management system (debconf) closes: Bug#80347
1058 * Yet more typo fixes closes: Bug#82743
1059 * Document the fact that X font utilities have moved to the package
1060 xutils closes: Bug#82966
1061 * Fixed the date in the virtual package list closes: Bug#83438
1062 * Cleaned up some ephemeral informative foornotes of the polic. Thanks
1063 to Branden Robinson <branden@debian.org> closes: Bug#83065
1064 * Corrected reference to the mime policy. closes: Bug#79891
1065 * Corrected reference to the menu policy. closes: Bug#75925
1066 * Added a note to the effect that the example make snippet used to
1067 illustrate the DEB_BUILD_OPTIONS environment variable is merely
1068 informative, and expanded the example to dismiss any confusion about
1069 potential failure due to accidentally trying to strip scripts.
1072 -- Manoj Srivastava <srivasta@debian.org> Sun, 28 Jan 2001 21:59:16 -0600
1074 debian-policy (3.2.1.2) unstable; urgency=low
1076 * The minimal change in version number is so that people can test and
1077 root out the bugs in this document before we make everyone change to
1079 * Document the Enhances relationship
1080 * Removed the restriction that one, and exactly one, person must
1081 maintain a package. closes: Bug#51879
1082 * Fixed a typo, and added the nogroup name, in uid/gid section of
1083 policy. closes: Bug#53496
1084 * Fixed a misstatement in policy about not needing to depend on packages
1085 in the base system (not true -- the Essential tag is significant)
1087 * Clarified update-rc.d stuff closes: Bug#55048
1089 * We have already included the material for shlibdep changes, and most
1090 of this is not relevant to policy anyway. closes: Bug#55730
1091 * makedev--> MAKEDEV closes: Bug#57154
1092 * Added restrictions on the files in /usr/share/doc/
1094 * Changed location of a paragraph about copyright files into the section
1095 that deals with copyright files. closes: Bug#65765
1096 * init script configuration variables closes: Bug#66912
1097 * Clarifed language about packages sharing a conffile need to be marked
1098 as conflicting closes: Bug#76028
1100 -- Manoj Srivastava <srivasta@debian.org> Thu, 18 Jan 2001 01:43:58 -0600
1102 debian-policy (3.2.1.1) unstable; urgency=low
1104 * Don't compress version.ent in the doc directory (it gets bigger!)
1105 * Incorporate the packaging manual into the policy document. The minimal
1106 change in version number is because I suspect that this version is
1108 closes: Bug#62943, Bug#72949
1109 * Fixed typo in menu-policy. closes: Bug#70442
1110 * Fixed typo in policy manual closes: Bug#70634, Bug#70643
1111 * Removed extraneous > from policy closes: Bug#77645
1112 * Fixed two typos in upgrading checklist closes: Bug#78809, Bug#78822
1113 * Fixed spelling of utility closes: Bug#82458
1114 * [ACCEPTED 2000/09/08] Free pkgs depending on non-US should go into
1115 non-US/{main,contrib} closes: Bug#69229
1116 * Added rsh-server and telnet server to the virtual packages list
1118 * Fixed outdated references to the FHS. closes: Bug#77650
1120 -- Manoj Srivastava <srivasta@debian.org> Tue, 16 Jan 2001 23:53:31 -0600
1122 debian-policy (3.2.1.0) unstable; urgency=low
1124 * [AMENDMENT 15/01/2000] revision of the "to build with X support or
1125 not" policy. closes: Bug#53759
1126 * [ACCEPTED 2000/06/06] Must/Should/May in policy This is only a
1127 clarifying change, and was not intended to change the intent of
1128 policy. closes: Bug#64437
1129 * [ACCEPTED 03/05/2000] About the use of conffiles. closes: Bug#61308
1130 * [AMENDMENT 10/05/2000] s/mail\.mail/root\.mail/ closes: Bug#62668
1131 * [ACCEPTED 04/05/2000] Update for new non-US layout closes: Bug#62946
1132 * [ACCEPTED 04/05/2000] s/debian-devel/debian-legal/ closes: Bug#62947
1133 * [ACCEPTED 04/05/2000] s/bash/base-files/ closes: Bug#62948
1134 * Typo: 1744s/tty/ttyS/ closes: Bug#64516
1135 * proposal for mp3-encoder virtual package closes: Bug#64004
1136 * proposal for mp3-decoder virtual package closes: Bug#64006
1137 * new virtual package time-daemon closes: Bug#69031
1138 * [PATCH] typos in menu-policy.sgml closes: Bug#69424
1139 * [PATCH] typos and awkwardness in policy.sgml closes: Bug#69426
1140 * the example for using nostrip in DEB_BUILD_OPTIONS is
1141 incorrect. closes: Bug#69487
1142 * [PATCH] more corrections closes: Bug#69670
1143 * [AMENDMENT 26/10/99] Amend non-free definition closes: Bug#46522
1144 * [AMMENDMENT 29/10/99] /bin/sh needs echo -n closes: Bug#48247
1145 * [AMENDMENT 1999/11/23] Clarify meaning of Essential: yes
1147 * [ACCEPTED] Request for new virtual packages: rsh-client and
1148 telnet-client closes: Bug#58759
1150 -- Manoj Srivastava <srivasta@debian.org> Thu, 24 Aug 2000 02:06:30 -0500
1152 debian-policy (3.2.0.0) unstable; urgency=low
1154 * Fixed bugs in debian-policy package:
1155 * We have had doc-base support for a while now. closes: Bug#15709
1156 * packaging manual: Added additional clarification on dpkg
1157 behaviour. closes: Bug#17369
1158 * [PROPOSAL] Do not make hardlinks to conffiles closes: Bug#22935
1159 * [PROPOSED]: clarification needed about diversions.
1160 fixed usage for dpkg-divert closes: Bug#29522
1161 * [OLD PROPOSAL] debian-policy has an unclear statement
1162 on dependancies and priorities closes: Bug#39398
1163 * [ACCEPTED 10/26/99] changelog.html.gz sanitization. closes: Bug#40934
1164 * [AMENDED 07/09/1999] policy on -g, a proposal closes: Bug#43787
1165 * Fixed missing </chapt> tag. closes: Bug#51091
1166 * Correct typo in section 2.3.5 closes: Bug#52225
1167 * Documented that the library before the symlink hack
1168 (which dependend on file system specific kinks to work)
1169 is no longer required by newer versions of dpkg. closes: Bug#53405
1170 * [ACCEPTED 02/01/2000] policy for usage of "xserver"
1171 alternative closes: Bug#53755
1172 * [ACCEPTED 02/01/2000] additions to virtual package
1173 list closes: Bug#53756
1174 * [ACCEPTED 02/01/2000] policy for "x-terminal-emulator"
1175 virtual package and alternative closes: Bug#53757
1176 * [ACCEPTED 02/01/2000] policy for "x-window-manager"
1177 virtual package and alternative closes: Bug#53758
1178 * [ACCEPTED 02/01/2000] revision of X application-defaults
1179 policy closes: Bug#53760
1180 * [ACCEPTED 02/01/2000] revision of the Motif/LessTif
1181 policy closes: Bug#53761
1182 * [ACCEPTED 02/01/2000] applying the FHS to packages
1183 that use X closes: Bug#53762
1184 * [ACCEPTED 02/01/2000] policy for X font packages closes: Bug#53763
1185 * Moved the documents into the Debian/ section, since
1186 that is where they belong, really. closes: Bug#54777
1187 * Fixed the ftp location in the manuals. closes: Bug#56407
1188 * Fixed missing urlname entity in the sgml docs (where
1189 was it defined before anyway?) closes: Bug#56692
1190 * Fixed bugs in packaging-manual package:
1191 * Fixed typo where dpkg-genchanges was used instead of
1192 dpkg-gencontrol. closes: Bug#58771
1194 * Added policy-process to document current procedures.
1195 * Added a dependency on fileutiles >=4.0, since the package would fail
1196 to install with older fileutils.
1197 * Installed FHS version 2.1
1198 * Policy recommends packaging manual and vice versa
1199 * Added FHS details to copyright file
1200 * Updaed the upgrade checklist. Minor changes to the ./debian/rules
1202 * Added footnotes in the packaging manual warning about the upcoming
1203 dpkg-shlibdeps change as in Bug#55730
1205 -- Manoj Srivastava <srivasta@debian.org> Sun, 30 Jul 2000 17:43:02 -0500
1207 debian-policy (3.1.1.3) unstable; urgency=low
1209 * Fixed an upgrade bug when /usr/doc happens to be a symlink, and does
1210 not point to /usr/share/doc. A couple of people were bitten by this.
1212 -- Manoj Srivastava <srivasta@debian.org> Mon, 28 Feb 2000 22:27:05 -0600
1214 debian-policy (3.1.1.2) unstable; urgency=low
1216 * Correct missing </chapt> in packaging.sgml (closes: #51091)
1217 * Correct typo in policy 2.3.5 (closes: #52225)
1219 -- Julian Gilbey <jdg@debian.org> Mon, 20 Dec 1999 20:39:57 +0000
1222 debian-policy (3.1.1.1) unstable; urgency=low
1224 * Correction to typo in packaging manual, section 6.2.
1225 * Correction to typo in packaging manual, section 12.2.5 (closes:
1227 * More corrections to packaging manual typos (closes: #50857)
1229 -- Julian Gilbey <jdg@debian.org> Mon, 22 Nov 1999 19:23:31 +0000
1231 debian-policy (3.1.1.0) unstable; urgency=low
1233 * Correct description of negated architectures in Build-Depends
1234 description in Packaging manual (closes: #49901)
1236 -- Julian Gilbey <jdg@debian.org> Tue, 16 Nov 1999 15:03:48 +0000
1238 debian-policy (3.1.0.0) unstable; urgency=low
1240 * Add instructions on /usr/doc -> /usr/share/doc symlinks (closes:
1241 #45561, #42447, #48570)
1242 * Added source dependencies (closes: #41232)
1243 * Deprecated /etc/rc.boot (closes: #32448, #32449)
1244 * Update-rc.d now only legal way to automatically access /etc/rc?.d
1245 directoried (closes: #41547)
1246 * FHS compliant location of examples (closes: #42849)
1247 * Added ispell-dictionary to virtual-packages.list (following new
1248 suggestions: no objections => accept) (closes: #8221)
1249 * Added man-browser to virtual-packages.list (closes: #24695)
1250 * Added ident-server to virtual-packages.list (closes: #45307)
1251 * Alphabeticised virtual packages list ;)
1252 * Corrected GPL reference in proposal.sgml
1253 * Clarification of "extra" priority (closes: #33076)
1254 * Remove buggy and seriously problematic licenses from list of contrib
1255 package criteria (closes: #45318)
1256 * Move docs to /usr/share/doc with a compatibility symlink (closes:
1258 * Update to FHS 2.1 draft #3 (for /var/state etc. changes).
1259 * Correct /var/lib/games -> /var/games (closes: #42358)
1260 * Added MIME subpolicy (closes: #46516)
1261 * Added support for VISUAL (closes: #41121)
1262 * Clarify non-dependence on /usr/local (closes: #44922)
1263 * Modified description of mail spool locking (closes: #43651)
1264 * Clarified wording of conffiles and configuration files (closes:
1266 * Changed description of release numbers (closes: #44620)
1267 * Added changelog.html -> changelog requirement (closes: $40934)
1268 * packaging-manual now correctly installs its docs (closes: #44643)
1269 * The packaging manual now discusses version numbers based on dates
1271 * Mention ls -f for testing order in which files appear on disk (closes:
1273 * Change order of '.' and '+' in description of version numbers (closes:
1275 * s/fields/field names/ in section 4.1 of packaging manual for clarity
1276 * Add Build-Depends-Indep: field to control file
1278 -- Julian Gilbey <jdg@debian.org> Thu, 4 Nov 1999 23:50:37 +0000
1280 debian-policy (3.0.1.1) unstable; urgency=low
1282 * Typo corrected in packaging manual. closes: Bug#40180
1283 * Chnaged rules file to create ps and pdf files.
1285 -- Manoj Srivastava <srivasta@debian.org> Mon, 16 Aug 1999 01:21:09 -0500
1287 debian-policy (3.0.1.0) unstable; urgency=low
1289 * A few typos and omissions corrected
1290 * Added the pop3-server to the virtual packages list, as decided on the
1292 * Fix the self reference to a location on the web site. closes: Bug#39408
1293 * Added the clarification that the .la files are essential for the
1294 packages using libtool's libltdl library, in which case the
1295 .la files must go in the run-time library package. (this is why this
1296 is version 3.0.1.0, and not 3.0.0.1)
1297 * The virtual package list has new directions (this has been true for a
1298 while, I am just closing the bug now). closes: Bug#26159
1299 * Since this package now contains the FHS, this closes: Bug#25533
1300 * The General resolution prototcol handling of the logos closes: Bug#26915
1301 * Inclusion of the Menu policy in the main policy document closes: Bug#30036
1302 * Since proposal submitting guidelines are now in the policy package,
1303 this closes: Bug#38612
1304 * Changed a /usr/doc reference to /usr/share/doc which had beeen missed
1305 before. closes: Bug#40864
1307 -- Manoj Srivastava <srivasta@debian.org> Thu, 15 Jul 1999 13:35:11 -0500
1309 debian-policy (3.0.0.0) unstable; urgency=low
1311 * This is a test version of the policy package, and shall not be
1312 officially uploaded.
1313 * Merged in the packaging manual sources (we still have two separate
1315 * Multiple minor packaging tweaks.
1316 * [ACCEPTED 1998/05/01] Policy clarification about Standards-Version
1317 Added the clarifying paragraph (and the rationale in a footnote).
1319 * [ACCEPTED 1999/04/05] Policy note that GPL moved to
1320 /usr/share/common-licenses. Again, also added the rationale as a
1321 footnote. closes: Bug#28747
1322 * [ACCEPTED 1999/05/04] Libtool archive (*.la) files in -dev' packages
1323 closes: Bug#37257, Bug#37338
1324 * [ACCEPTED 1999/04/28] Logrotation. Standardizer on logrotate.
1326 * [ACCEPTED 1999/05/23] Rewrite of section 5.7 (Programs for the X
1327 Window System) closes: Bug#38212
1328 * [ACCEPTED 1999/05/15] Separate menu policy (like virtual package list)
1330 * [ACCEPTED 1999/05/09] Utmp group proposal
1332 * [ACCEPTED 1999/05/09] Adopt the FHS in place of FSSTND
1333 Changed all references to the proper FHS versions. This was a first
1334 scan, so some references may still need to be changed. closes: Bug#37345
1335 * Updated the upgrading checklist.
1336 * updated the proposal for policy update to reflect the latest
1338 -- Manoj Srivastava <srivasta@debian.org> Wed, 30 Jun 1999 22:49:15 -0500
1340 debian-policy (2.5.1.0) unstable; urgency=low
1342 * Removed double '>' marks from the policy document. closes: Bug#35095
1343 * Corrected canonical source for "Csh Programming Considered Harmful"
1344 closes: Bug#36286 Bug#32499
1345 * Fixed typo in invocation of update-rc.d. closes: Bug#34988 Bug#34543
1346 * Fixed misspelling of accessible. Ran ispell over the rest of the
1347 document (painful because of the large number of technical terms in
1348 there). closes: Bug#34233
1349 * Make the binary package contain the version.ent as well. closes: Bug#31033
1350 * Fixed typo s/as is/is/. closes: Bug#30302
1351 * AMENDMENT 23/04/1999: changed /etc/nntpserver recommendation to
1352 /etc/news/server. closes: Bug#21875
1353 * Added the current list of policy maintainers. closes: Bug#30148
1355 -- Manoj Srivastava <srivasta@debian.org> Tue, 27 Apr 1999 11:10:29 -0500
1357 debian-policy (2.5.0.0) unstable; urgency=low
1359 * AMENDMENT: Added in changes in Bug #25911, which rearranged sections
1360 to create a new section 4, namely, files. Section 3.3 ("Files") should
1361 become Section 4. The Sections that are currently Section 4 and
1362 Section 5 should be moved down to become Section 5 and Section 6
1365 What is now Section 5.5 ("Log files") should be moved to be a
1366 subsection of the new Section 4 ("Files"), becoming section 4.8,
1367 placing it after "Configuration files", moving the would-be Section
1368 4.8 ("Permissions and owners") to Section 4.9. All subsections of the
1369 current Section 5 after 5.5 should be accordingly moved down to fill
1372 This, along with the next amendment, justifies bumping up the version
1373 number. closes: BUG#25911
1375 * AMENDMENT: Added in changes in Bug #21185, about the naming and
1376 compression of changelog files. Now, if the upstream changelog file is
1377 HTML formatted, it should be accessible as
1378 /usr/doc/<package>/changelog.html.gz It also allows for this to be a
1379 symlink, if the upstream file name does not conform to Debian
1380 conventions. closes: BUG#21185
1382 * AMENDMENT: Added in changes in Bug #7890, to make clear that the HTML
1383 documents should be supplied in _some_ package, not necessarily in the
1384 main binary package (at the discretion of the maintainer).
1387 * AMENDMENT: Added in changes in Bug #26461, which corrects the policy
1388 to refer to /usr/doc/<package>/copyright, rather than
1389 /usr/doc/copyright/<package>. closes: BUG#26461
1391 * AMENDMENT: Added in changes in Bug #25385, which allow the
1392 architecture specification strings to be of the form <arch>-<os>,
1393 where os is one of linux, gnu. Previously, only linux was allowed, now
1394 we also cater to the hurd. closes: BUG#25385
1396 * The responsibility of the contents of this package has now passed to
1397 the debian-policy mailing list. The packaging details are now being
1398 managed by a group of maintainers that do ot won the contents.
1400 * Make the package optional, not extra.
1402 * Re did the SGML markup. Normalized the document, and undid the omitted
1403 and shor tags. Personally, I use too many DTD's in real life to be so
1404 converssant with each one to be clever with tag omissions, and, since
1405 I have a smart editor, omitting tags does not byuy one much. In the
1406 process, I discovered a few errors in the markup (one of my
1407 predecessors hasd the unfortunate habit of treating <p> as a "create
1408 some space here" tag, and more often than not put it at the end of a
1409 paragraph, rather than using is as a container element (which is what
1412 * Re did the control files, making them more robust
1414 * re did the rules file, making it more general, and easier to maintain
1415 by putting in a layer of abstractions.
1418 -- Manoj Srivastava <srivasta@debian.org> Thu, 29 Oct 1998 15:16:52 -0600
1420 debian-policy (2.4.1.4) unstable; urgency=low
1422 * New Maintainer <debian-policy@lists.debian.org>
1424 -- Philip Hands <phil@hands.com> Sat, 5 Sep 1998 02:41:35 +0100
1426 debian-policy (2.4.1.3) unstable; urgency=low
1428 * New maintainer (with changes from Adam P. Harris' proposed NMU)
1429 * policy.sgml: some awkward phrasings fixed (closes Bug#22006)
1430 * policy.sgml: s/depreciated/deprecated (closes Bug#21831)
1431 * debian/control: added conflict doc-base (<< 0.6), which I still am not
1432 sure why we need this but hey (closes Bug#21554)
1433 * policy.sgml: use new <url> tag where appropriate
1434 * policy.sgml, debian/control: always dynamically self reference the
1435 current version of policy, that is, do not hard code policy revision
1437 * debian/rules: use dpkg-gencontrol -isp
1438 * bugs fixed in some unknown previous version (closes Bug#23177)
1440 -- Philip Hands <phil@hands.com> Tue, 11 Aug 1998 09:54:17 +0100
1442 debian-policy (2.4.1.2) frozen unstable; urgency=low
1444 * non-maintainer release
1445 * rebuild package to fix truncated Chapter 3 (Bug#23408, not marked as
1446 important but should be, since a gaping hole in policy is very
1448 * bumped version of policy, within the document, to this version number,
1449 but not the date, indicating nothing really changed since then
1450 * no content changes
1451 * debian/rules: clean is a little cleaner
1453 -- Adam P. Harris <aph@debian.org> Tue, 16 Jun 1998 03:15:22 -0400
1455 debian-policy (2.4.1.1) frozen unstable; urgency=low
1459 -- Christian Schwarz <schwarz@debian.org> Thu, 14 May 1998 21:54:50 +0200
1461 debian-policy (2.4.1.0) frozen unstable; urgency=low
1463 * Changes to the Debian Policy Manual:
1465 - Updated section 3.1.2 Site-specific programs
1466 and section 3.8 Keyboard configuration:
1467 + improved wording (fixes:bug#20129)
1469 - Updated section 2.1.7 Subsections:
1470 + fixed typos (fixes:bug#18145)
1472 - Updated section 3.3.5 Symbolic links:
1473 + symbolic links within a toplevel directory should be relative,
1474 symbolic links between toplevel directories should be absolute
1475 (cf., Policy Weekly Issue#6, topic 2)
1477 - Updated section 3.4 System run levels:
1478 + Intro: mention /etc/rcS.d (links to boot time scripts)
1479 + Notes: include rationale why /etc/init.d scripts have to be tagged
1480 as conffiles (fixes:bug#16199)
1481 + Example: changed example init.d script to handle force-reload
1482 and restart options and to comply with the console message
1483 standard (fixes:bug#19216)
1485 - Updated section 4.8 Emacs lisp programs:
1486 + Replaced old section about lisp programs with a reference to
1487 the file debian-emacs-policy.gz, installed by the emacsen-common
1490 - Updated section 4.9 Games:
1491 + manpages for games should be installed in /usr/man/man6
1492 (cf., Policy Weekly Issue#6, topic 3)
1494 - Removed one example reference to the current standards version
1495 - Include manual's date as plain text in the .sgml source so that
1496 a recompiled manual uses the same release date
1498 * Changes to the authoritative list of virtual package names:
1499 - Removed obsolete virtual package `emacs'
1501 * New version numbering scheme:
1503 - The version numbers are independent of dpkg now, but all policy
1504 manuals (the Debian Policy Manual, the Debian Packaging Manual, and
1505 the Debian Developer's Reference) share the same version numbering
1508 - The first three digits of the version number specify the
1509 `Standards-Version.' This number is incremented with each policy
1510 change. The fourth digit represents the `patch-level,' which may
1511 differ between the manuals.
1513 If only the patch-level digit is incremented, no changes in policy
1514 have been made, except bug fixes and clarifications. Packages only
1515 have to specify the first three digits of the version number in the
1516 `Standards-Version' field of their source packages.
1518 * Packaging changes:
1520 - Uploaded to frozen and unstable. This is a documentation-only
1521 package and the changes to the manual are relevant for hamm.
1523 - Fixed FSF's address in copyright file (detected by Lintian)
1525 -- Christian Schwarz <schwarz@debian.org> Tue, 14 Apr 1998 10:08:09 +0200
1527 debian-policy (2.4.0.0) unstable; urgency=low
1529 * Changes to the Debian Policy Manual:
1531 - Updated section 3.3.4 Scripts:
1532 + /bin/sh may be any POSIX compatible shell
1533 + scripts including bashisms have to specify /bin/bash as
1535 + scripts which create files in world-writable directories
1536 (e.g., in /tmp) should use tempfile or mktemp for creating
1539 - Updated section 3.3.5 Symbolic Links:
1540 + symbolic links referencing compressed files must have the same
1541 file extension as the referenced file
1543 - Updated section 3.3.6 Device files:
1544 + /dev/tty* serial devices should be used instead of /dev/cu*
1546 - Updated section 3.4.2 Writing the scripts [in /etc/init.d]:
1547 + all /etc/init.d scripts have to provide the following options:
1548 start, stop, restart, force-reload
1549 + the reload option is optional and must never stop and restart
1552 - Updated section 3.5 Cron jobs:
1553 + cron jobs that need to be executed more often than daily should
1554 be installed into /etc/cron.d
1556 - Updated section 3.7 Menus:
1557 + removed section about how to register HTML docs to `menu'
1558 (the corresponding section in 4.4, Web servers and applications,
1559 has been removed in policy 2.2.0.0 already, so this one was
1562 - New section 3.8 Keyboard configuration:
1563 + details about how the backspace and delete keys should be
1566 - New section 3.9 Environment variables:
1567 + no program must depend on environment variables to get a
1568 reasonable default configuration
1570 - New section 4.6 News system configuration:
1571 + /etc/news/organization and /etc/news/server should be supported
1572 by all news servers and clients
1574 - Updated section 4.7 Programs for the X Windows system:
1575 + programs requiring a non-free Motif library should be provided
1576 as foo-smotif and foo-dmotif package
1577 + if lesstif works reliably for such program, it should be linked
1578 against lesstif and not against a non-free Motif library
1580 - Updated section 4.9 Games:
1581 + games for X Windows have to be installed in /usr/games, just as
1584 - Lots of typos fixed (thanks to Ray Dassen for the patch!)
1586 * Changes to the authoritative list of virtual package names:
1587 - added `libc-dev' and `emacsen'
1589 * Merged `/usr/doc/debian-policy/changelog-policy.gz' into this
1592 * Included `Policy checklist for upgrading your packages' from the
1593 Policy Home Page as /usr/doc/debian-policy/upgrading-checklist.text.gz
1595 * Added support for doc-base to register the Policy Manual to the
1596 online documentation systems dwww and dhelp (fixes:#15710)
1598 * Upgraded to standards version 2.4.0.0 (no changes)
1600 -- Christian Schwarz <schwarz@debian.org> Fri, 30 Jan 1998 21:58:25 +0100
1602 debian-policy (2.3.0.1) unstable; urgency=low
1604 * Changes in the Debian Policy Manual:
1605 - X library package is now called xlib6g
1606 * Changes in the authoritative list of virtual package names:
1607 - Added emacs, c-compiler, fortran77-compiler, lambdamoo-core,
1609 * Conflict with old dpkg-dev version that included policy manual
1611 * Removed `tentative-opt-draft' from package since people considered
1612 the draft official policy (which is not the case)
1613 * Don't use debstd anymore
1615 -- Christian Schwarz <schwarz@debian.org> Tue, 21 Oct 1997 23:03:52 +0200
1617 debian-policy (2.3.0.0) unstable; urgency=low
1619 * Changes in the Debian Policy Manual:
1620 - reworked chapter `The Debian Archive' to cover new
1621 contrib/non-free policy
1622 - call "contrib" and "non-free" a `section' (not `distribution')
1623 - refer to license files (GPL, LGPL, etc.) as uncompressed files
1624 - changed `/etc/news/server' into `/etc/nntpserver' in example of
1625 maintainer scripts (fixes #11517)
1626 - new section about `Daemons'
1627 - updated section about `Configuration files'
1628 - MUAs and MTAs have to use liblockfile
1629 - fixed typos and grammatical errors
1630 * Changes in the authoritative list of virtual package names:
1631 - renamed tcl/tk virtual package names to `tclsh' and `wish'
1632 * Paper about libc6 migration:
1633 - fixed typos (fixes #11641), thanks to James Troup for the patch!
1634 * SGML source code included in package
1635 * don't use `2-up' style for PostScript version (fixes #11095)
1637 -- Christian Schwarz <schwarz@debian.org> Mon, 2 Sep 1997 00:54:31 +0200
1639 debian-policy (2.2.0.0) unstable; urgency=low
1641 * Changes in the Debian Policy Manual:
1642 - completely reworked structure
1643 - moved sections about new maintainers, upload procedure, interim
1644 releases, and mailing lists into the Developers Reference Manual
1645 - moved a few (small) sections into the Debian Packaging Manual
1646 - removed all those ugly footnotes
1647 - new example for "reload" in section about console messages
1648 - mention Artistic License (fixes #9793)
1649 - don't mention dpkg's version number in Policy Manual
1650 - rewrote abstract and section introductions
1651 - mention "orphaned packages"
1652 - maintainer is responsible for a package license to comply with the
1653 distributions' policy
1654 - putting a package into base section requires discussion on debian-devel
1655 - rewrote sections about "pre-depends", "essential" and, "base" packages
1656 - added note that non-us' maintainers have to live outside the US
1657 - added crypto-hook statement (fixes #7257)
1658 - added section about arch spec strings
1659 - rewrote section about "Site specific programs" (/usr/local)
1660 - included Ian's suggestions for user IDs
1661 - added section about "menus"
1662 - removed section about "web menus" since this will be superseded with
1663 the new documentation policy soon
1664 - incorporated "Debian Free Software Guidelines" (fixes #9024)
1665 - removed note that linking with -g produces large a.out binary (fixes
1667 - added section about editors and pagers
1668 - added note about Package priorities and dependencies
1669 - added section about cron jobs (fixes #8814)
1670 - added section about device files
1671 - don't install shared libraries as executable (fixes #7129)
1672 - app-defaults files may not be conffiles (cf. #2717)
1673 - lots of minor changes not worth mentioning here (typos, formulations,
1675 * Changes in the authoritative list of virtual package names
1676 - Removed obsolete virtual packages: xR6shlib, xlibraries,
1677 compress, emacs, sgmls, inews, gs_x, gs_svga, gs_both, xpmR6
1678 - Added new section about obsolete names
1679 * Added Helmut Geyer's paper about libc5-libc6 migration
1680 * Fixed package's description
1682 -- Christian Schwarz <schwarz@debian.org> Sun, 13 Jul 1997 13:25:51 +0200
1684 debian-policy (2.1.3.3) frozen unstable; urgency=low
1686 * Mention Artistic License in section 2.5 (bug #9755)
1688 -- Christian Schwarz <schwarz@debian.org> Wed, 14 May 1997 16:53:15 +0200
1690 debian-policy (2.1.3.2) frozen unstable; urgency=low
1692 * Fixed an email address, an URL, and several typos in chapter 6 (#9358)
1693 * Added new virtual package "wordlist" to list (requested by Joey Hess)
1694 * Changed wording in section about "non-free" packages as suggested
1695 by Kai Henningsen (#7076)
1697 -- Christian Schwarz <schwarz@debian.org> Mon, 5 May 1997 20:05:39 +0200
1699 debian-policy (2.1.3.1) frozen unstable; urgency=low
1701 * Fixed bug in chapter 7: `-ur' should read `-us' (#8874)
1702 * Fixed bug in chapter 7: `-rwhatever' also needed for rebuild (#8874)
1703 * Create a PS and HTML version of the Policy Manual and upload it
1705 * Install virtual-package-names-list.text in /usr/doc/debian-policy
1706 and upload it "byhand" too.
1708 -- Christian Schwarz <schwarz@debian.org> Tue, 29 Apr 1997 18:02:14 +0200
1710 debian-policy (2.1.3.0) unstable; urgency=low
1713 * New Policy Manager: Christian Schwarz <schwarz@debian.org>
1714 * Added section 2.4 about the "non-us" distribution.
1715 * Added section 3.1.1 about the "Package" field in the control file.
1716 * Added section 3.2.1 about "Binaries": two programs with different
1717 functionality must not have the same name.
1718 * Changed headline of section 3.2.6 into "Debian changelog and upstream
1719 changelog" as suggested by Santiago Vila Doncel <sanvila@unex.es>.
1720 * Added log-rotating example to section 3.2.9 that tests with `-sf',
1721 as suggested by Boris D. Beletsky <borik@isracom.co.il>.
1722 * Added section 3.13: "Webstandard 3.0" by Christoph Lameter.
1723 * Added section 3.14: "Standard for Console Messages" by Christian Schwarz.
1724 * Split section 4.1 into 4.1.1 (Options for binaries) and 4.1.2 (Options
1726 * Added note to 4.1.2: Libraries should be compiled with `-D_REENTRANT'
1727 to make them compatible with LinuxThreads, by Rob Browning
1728 <osiris@cs.utexas.edu>.
1729 * Added note to 4.1.2: Libraries should be stripped with
1730 "strip --strip-unneeded", by Guy Maor <maor@ece.utexas.edu>.
1731 * Section 5.2: Policy changelog is now
1732 "/usr/doc/debian-policy/changelog-policy.gz". This fixes bug #6130.
1733 * Section 6.2 renamed to "Uploading your first Debian package". This
1736 -- Christian Schwarz <schwarz@debian.org> Sat, 15 Mar 1997 18:08:56 +0100
1738 debian-manuals (2.1.2.2) frozen unstable;
1740 * Fixed even more typographical and grammatical errors in Policy and
1742 * Corrected the contact email addresses again.
1743 * Added a paragraph to Policy 6.3 on taking over an old package (Guy Maor)
1744 * Added a paragraph to Programmer 4.2.14 on listing distributions to load
1745 a package into. (Guy Maor)
1746 * Further clarification of use of absolute pathnames in scripts in
1749 -- David Morris <bweaver@worf.netins.net> Tue, 3 Dec 1996 23:28:04 -0600
1751 debian-manuals (2.1.2.1) frozen unstable;
1753 * Many editorial and formatting revisions with suggestions from Ian Jackson,
1755 * correction of chiark address in Policy 6.2
1756 * footnote in Programmers chapter 2 pointing to deb(5) manpage for
1757 description of deb file format.
1758 * addition of more dpkg examples in Programmer chapter 2
1759 * Replace paragraph in Policy 4.1 outlining compiling parameters for
1761 * Added paragraph in Programmer 6.1 on paths in maintainer scripts
1763 * Cleaned up language and formatting of Programmer's 12.2, shlibs
1764 * Corrected contact addresses for listmaster and override-change
1766 -- David Morris <bweaver@worf.netins.net> Wed, 27 Nov 1996 08:17:16 -0600
1768 debian-manuals (2.1.2.0) frozen unstable;
1770 * Mostly editorial changes in Policy Manual.
1771 * Added summary of distribution criteria to Introduction
1772 * Added section headings for copyright criteria
1773 * Fixed typos (Bugs #4485, #4622)
1774 * Added paragraph in Compilation Options related to use of shared and
1775 static libraries. (Bug #5299)
1776 * Paragraph added about where to find PGP and other export restricted
1777 packages in section on Procedure
1778 * Change in List administrator and in the contact address for becoming
1779 a package maintainer
1780 * A paragraph added related to who to contact for package maintainer changes.
1781 * Changed where to send upload announcements: uploads destined for unstable,
1782 frozen, or experimental go to debian-devel-changes.
1784 * Made some mostly editorial changes to Programmers Manual.
1785 * Added a recommendation to debmake in Introduction.
1786 * A further interpretation of the various Distributions is added with
1787 the intent of helping people decide which one to choose. (section 4.2.14)
1788 * Section 12 on Shared Libraries expanded with further technical information
1789 on various shlib files
1790 * Section in 2.2 on format of shlib file moved to new subsection within 12.
1791 * Paragraph on adding a symlink without version number added to Shared
1792 Library Section (Guy Maor, Bug #5299)
1794 -- David Morris <bweaver@worf.netins.net> Fri, 22 Nov 1996 23:41:39 -0600
1796 debian-manuals (2.1.1.0) unstable;
1798 * Hard links are forbidden in source packages (they didn't work anyway,
1799 and can't easily be made to work reliably).
1800 * Do not use dpkg-divert or update-alternatives without consultation.
1802 * Do not need to declare dependencies on Essential packages.
1803 * Restrictions on Pre-Depends stated in policy manual.
1804 * debian/substvars file is now almost always auto-generated.
1805 * Shared libraries must be installed stripped.
1806 * Essential and Pre-Depends put together in policy manual.
1808 * Explained component-wise (file-wise) vs. package-wise dependencies.
1810 -- Ian Jackson <ian@chiark.greenend.org.uk> Thu, 12 Sep 1996 01:00:41 +0100
1812 debian-manuals (2.1.0.0) unstable;
1814 * Upstream changelog must be installed too (was just recommended).
1816 * Modification to use dpkg-shlibdeps added to conversion instructions.
1817 * Packages which are buggy and orphaned but which are preserved for
1818 compatibility go in contrib.
1820 * Programmers' manual source package section refers to conversion
1821 instructions in policy manual.
1822 * Make it clear that recommending a non-free or contrib package puts a
1825 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sun, 1 Sep 1996 17:47:18 +0100
1827 debian-manuals (2.0.1.0) unstable;
1829 * varargs.h and libtermcap are obsolete - use stdarg.h and ncurses.
1830 * Shared library link/library ordering corrected (aargh).
1831 * When to byte-compile Elisp files.
1832 * Missing final newlines not represented by dpkg-source.
1834 * Must post upload announcements to debian-changes.
1835 * Moved some sections into new `configuring and building' chapter.
1838 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sat, 31 Aug 1996 20:07:22 +0100
1840 debian-manuals (2.0.0.0) unstable;
1842 * Footnote added OK'ing copyrights which require name changes.
1843 * More detail about changelog format names.
1845 * Problematic licence restrictions are formatted as lists.
1846 * Mentioned 822-date utility as way to generate RFC822 format dates.
1850 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Mon, 26 Aug 1996 14:27:34 +0100
1852 debian-manuals (0.2.1.1) unstable;
1854 * Can't overwrite directories in one package with files in another.
1856 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sat, 24 Aug 1996 18:44:54 +0100
1858 debian-manuals (0.2.1.0) unstable;
1860 * Policy says when and how to include original source in upload.
1862 * Need -sa on dpkg-genchanges/dpkg-buildpackage when converting.
1864 * Use minor patchlevel for meaning changes which don't affect packages.
1865 * More verbosity about netiquette.
1866 * Reorganised participation and upload policy: merged with mailing lists.
1868 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Fri, 23 Aug 1996 12:48:09 +0100
1870 debian-manuals (0.2.0.1) experimental;
1872 * Said that system administrators' manual does not exist.
1874 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Fri, 23 Aug 1996 04:05:36 +0100
1876 debian-manuals (0.2.0.0) experimental;
1880 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Wed, 21 Aug 1996 15:07:53 +0100