1 debian-policy (3.6.2.1) unstable; urgency=low
4 * Bug fix: "policy 11.5.3 refers to using the menu package to register
5 docs", thanks to Joey Hess (Closes: #222553).
6 * Bug fix: "[PROPOSAL] Document Uploaders: field in policy", thanks to
7 Andrew Pollock. Andreas Metzler provided the wording, though it was
8 modified during inclusion. (Closes: #203145).
9 * Bug fix: "debian-policy: Minor grammatical correction in section 9.4",
10 thanks to Eric Evans. I rejected the proposed change, instead I went
11 over the whole policy document and removed all he/she/him/her
12 constructs before the gender police jump all over me. (Closes: #273122).
13 * Bug fix: "XSI:ism in prerm and postinst", thanks to David Weinehall
15 * Bug fix: "debian-policy: please clarify section 12.7.", thanks to
16 Adrian Bunk. Added a clarifying footnote that makes it clear that
17 section 12.3 does not allow one to ignore section 12.7 (Closes: #276953).
19 * Bug fix: "debian-policy: should not ship generated files in source
20 archive, and should clean them from the tree", thanks to Branden
21 Robinson (Closes: #284967).
22 * Bug fix: "debian-policy: Detailed description of maintainer script
23 calls (Section 6.5) is incomplete", thanks to Nikolaus Schulz
24 and Thomas Hood. What happens when error unwinding itself runs into
25 problems is perhaps not discussed as completely as it should be.
27 * Bug fix: "9.3.3.2 "command -v" example needs tweaking",
28 thanks to Thomas Hood. Instead of the massively complex shenanigans
29 suggested in the bug report, just use which. which lives in an
30 essential package, so can be used in the preinst of packages.
32 * Bug fix: "debian-policy: please clarify/loosen the policy on rewriting
33 history", thanks to Frank Küster. Since this was not really a
34 directive, but merely an expression of an opinion, moved it into an
35 informative footnote. (Closes: #290270).
36 * Bug fix: "debian-policy: virtual package request: mpd-client", thanks
37 to Eric Wong (Closes: #270020).
38 * Bug fix: "[ACCEPTED 2005/02/04]: "libexec", or use of "lib" for
39 binaries in lib* packages", thanks to Junichi Uekawa
41 * Bug fix: "debian-policy: virtual package: flexmem", thanks to Bartosz
42 Fenski aka fEnIo (Closes: #239359).
43 * Bug fix: "Please clarify Section 2.5. required <-> essential",
44 thanks to Adrian Bunk. Clarified the section. (Closes: #216104).
48 debian-policy (3.6.1.1) unstable; urgency=low
51 * [AMENDMENT 15/09/2003] Move documentation of behavior of ancient dpkg
52 in 6.6 to a footnote. closes: Bug#209855
53 * Fix the outdated link for the mime subpolicy. closes: Bug#212153
54 * Fix a missing comma in the list of sections closes: Bug#215524
55 * Fix spelling of sysv-rc closes: Bug#215558
56 * [AMENDMENT 28/03/2004] ${perl:Depends} documentation
57 incomplete. Added an informative foot note stating that dependencies
58 caused by versioned uses and on separately packaged modules are not
59 included in this variable and must be explicitly included.
61 * Clarified that section 3.2.1 refers to the date based postion of the
62 version number, if not already clear from the context. This allows
63 developers leeway in selecting date based version numbers for their
64 packages, without loosing the advantages of the format specified in
65 this section. closes: Bug#248618
66 * Bug fix: "Broken link to virtual-package-names-list.txt in section
67 3.6", thanks to Carlos O'Donell (Closes: #248786).
68 * Bug fix: "Broken link to debconf_specification.txt.gz in section
69 3.10.1 of the Debian Policy manual.", thanks to Carlos O'Donell and
70 Scott C.MacCallum <scm@madoshi.com> (Closes: #248788, 247761).
71 * Bug fix: "missing commas in subsections list", thanks to Filippo
72 Giunchedi (Closes: #236614).
73 * Bug fix: "debian-policy: policy-process, broken URL", thanks to Manoj
74 Srivastava (Closes: #244969).
75 * Bug fix: "bad reference to debconf-devel(8) has to be (7)", thanks to
76 Kevin Price (Closes: #247143).
77 * Bug fix: "debian-policy: Small wording change", thanks to Mike Paul
79 * Bug fix: "debian-policy: broken URL: CSH Programming Considered
80 Harmful", thanks to Steven Augart (Closes: #253324).
81 * Bug fix: "New virtual package: cron-daemon", thanks to Adam Byrtek
84 * Fixed detection of invoke-rc.d's existence, closes: #218530.
85 * Generalized the dpkg-shlibdeps example and added a current example in a
86 footnote, set proper section ids and linked the d-sd section better,
88 * Clarified the section about the Architecture field and added footnotes
89 to indicate recommended actions, closes: #51832.
90 * Updated PGP references, closes: #68827.
91 * Linked f-Format in the list of fields of the .dsc file, not mandatory
92 according to my skimming of dpkg-source, closes: #70742.
93 * Fixed the command line required to output the copyright file,
95 * Removed the long obsolete notion of specific directory names within
96 source tarballs, closes: #79210.
98 * sgml-dtd was moved, fix FTBFS. Closes: #241683
99 * fix link to WM specification. Closes: #235484
100 * manpage -> man page. Closes: #232364, #238958
101 * language adjustment. Closes: #227762
102 * added virtual packages stardict-dictionary, inetd-superserver.
103 Closes: #185943, #237049
105 -- Manoj Srivastava <srivasta@debian.org> Fri, 25 Jun 2004 16:07:38 -0500
107 debian-policy (3.6.1.0) unstable; urgency=low
110 * Removed obsolete section on obsolete constructs and libraries,
113 * Change reference to the debconf introduction from kitenet to a debian
114 hosted server. closes: Bug#187297
115 * Added myspell-dictionary to the virtual packages list closes: Bug#203728
116 * Fix the restart action in the init.d/bind example; it now uses
117 --oknodo so that the action does not fail when the service is not
118 running. closes: Bug#187250
119 * invoke-rc.d and update-rc.d are now in the sysv-rc package instead of
120 the sysvinit package. Fixed a reference in policy. closes: Bug#200440
121 * Note that postinst abort-remove is called if there is an error while
122 removing the package. closes: Bug#188030
123 * [AMENDMENT 2003/08/03] Make Debconf the standard for prompting the
124 user closes: Bug#176506
126 -- Manoj Srivastava <srivasta@debian.org> Tue, 19 Aug 2003 07:28:10 -0500
128 debian-policy (3.6.0) unstable; urgency=low
131 * Restructured Policy, closes: #189306.
132 + Many packaging manual appendices that were integrated into policy
133 sections are now empty, and replaced with links to the Policy.
134 In particular, the appendices that included the list of control
135 fields were updated (new fields like Closes, Changed-By were added)
136 and the list of fields for each of control, .changes and .dsc files
137 is now in Policy, and they're marked mandatory, recommended or
138 optional based on the current practice and the behaviour of the
139 deb-building toolchain.
140 + Elimination of needlessly deep section levels, primarily in the
141 chapter Debian Archive, from which two new chapters were split out,
142 Binary packages and Source packages. What remained was reordered
143 properly, that is, some sect1s became sects etc.
144 + Several sections that were redundant, crufty or simply not designed
145 with any sort of vision, were rearranged according to the formula that
146 everything should be either in the same place or properly interlinked.
147 Some things remained split up between different chapters when they
148 talked about different aspects of files: their content, their syntax,
149 and their placement in the file system. In particular, see the new
150 sections about changelog files.
152 * Added Games/Simulation to menu subpolicy closes: Bug#194974
153 * Added Apps/Education to menu subpolicy closes: Bug#194972
154 * [ACCEPTED]: Debian changelogs should be UTF-8 encoded. Changed the
155 wording from a should to a may; since a should would make an unknown
156 number of packages insta buggy. A reuest makes all these wishlist
157 bugs; we can raise the severity in a later version of policy.
159 * Added LANG=C before the debiandoc2X invocations, this ensures that the
160 resulting documents do not get converted to the locale on the building
161 machine. This answers some of the issues mentioned in Bug#175064
162 * [AMENDMENT 02/05/2003] encourage packagers to systematically prevent
163 mis-linked libraries closes: Bug#191369
164 * [AMENDMENT 6/6/2003] build-depends-indep need not be satisfied
165 during clean target. closes: Bug#191411, Bug#178809
166 * Fixed the fact that section 7.5.1 does not describe dpkg's true
167 behavior. Now added a footnote that explains that replaces is a one
168 way relationship. closes: Bug#183195
169 * Could no longer find the misspelling "seciton", thus this must have
170 been fixed in a previous change in the manual. closes: Bug#193903
171 * Fixed an incorect /usr/share/common-licences/GPL reference, ensured a
172 consistent spelling across the manuals. closes: Bug#189516
173 * Removed an extraneous > in menu policy. closes: Bug#187615
174 * Fixed typos, and part of the report that was deemed valid; the other
175 changes suggested were incorrect, or style issues. closes: Bug#169744
176 * updated the section numbers in the upgrading checklist
177 for the restructuring
179 -- Josip Rodin <joy-packages@debian.org> Wed, 9 Jul 2003 18:01:35 +0200
181 debian-policy (3.5.10.0) unstable; urgency=low
184 * Fixed date, typos and added indentation in the virtual packages list,
186 * Changed the formatting of the link to the authors section to avoid
187 confusion in the debiandoc2txt output, closes: #185985.
188 * Fixed various typos, closes: #189274, #187418, #187422, #189654.
189 * Removed broken link to csh.whynot on CPAN, closes: #187567.
190 * Updated archive section list, closes: #187420.
191 * Stop attaching byhand tarballs, cf. bug #184082.
193 * Clarify x-terminal-emulator virtual package eligibility, in an
194 extention to an informative footnote. closes: Bug#165063
195 * Add 40 points, not 20, when the window manager is compliant with "The
196 Window Manager Specification Project". closes: Bug#167004
197 * Fixed reference to the debconf URL (we can change the URL as it
198 changes again, and I don't think any additional load would accrue
199 since people using the old URL were redirected to auric anyway).
201 * Inserted the word only in the package name section. closes: Bug#184368
202 * Amended the section about Prompting in maintainer scripts. Added a
203 footnote (quoting from the Jargon File) to explain what "by hand"
204 means in a computer context. closes: Bug#184507
206 -- Josip Rodin <joy-packages@debian.org> Sat, 10 May 2003 19:13:50 +0200
208 debian-policy (3.5.9.0) unstable; urgency=low
211 * Added missing bits of information about Description: fields from
212 the old Packaging manual, closes: #172022
213 * Fixed a stale reference to the "base system maintainer" to
214 base-passwd maintainer, closes: #174927
215 * Fixed an accidental change from /usr/share/package to /usr/share/doc in
216 the paragraph about not depending on /usr/share/doc/package,
218 * Fixed several errors reported by Guenther Palfinger, with some help from
219 Richard Braakman, closes: #177205, #177206, #177207, #177208, #177209
220 * Added versions to links and docbook-xml source-dependencies, hopefully
221 fixes the bug with potato, and even if it doesn't, I don't care :)
223 * Fixed typos in the debconf spec noticed by Jay Bonci, closes: #178455
224 * Clarified that using Build-Depends for build-dependencies is not a "may"
225 but a "should", added proper linking among various sections dealing with
226 the dependencies so that there is no confusion, closes: #87510
227 If any one of those poor, misguided people ;) still thinks that the
228 requirement should be a "must" (in _our_ meaning, not RFC "MUST"),
229 please file a new bug, as it's quite unproductive to have to sift
230 through a 152-page bug log which mostly goes back-and-forth with
231 explanations how policy should work, occasionally sprinkled with
233 * When asked to restart a service that isn't already running, the init
234 script should start it, closes: #60979
235 * Rephrased section on configuration files to remove confusing use of
236 "should", closes: #170019
237 * Rearranged the shared library information properly, closes: #109166
238 This change also centralizes the info on how to ship static libraries
239 in one place (hopefully not too ambiguous), closes: #93975
240 * Allow examples to be placed in /usr/share/doc/package/ in packages
241 that are meant to provide examples, closes: #69864
242 * Removed several references to the Policy manual etc in the stuff
243 imported from old packaging manual, closes: #181923
244 * Fixed too greedy wildcard match in the logrotate example,
247 -- Manoj Srivastava <srivasta@acm.org> Fri, 7 Mar 2003 12:35:16 -0600
249 debian-policy (3.5.8.0) unstable; urgency=low
252 * Added example for why one may call ldconfig anywhere in the
253 postsint. closes: Bug#120585
254 * Add the modifications about base system, as opposed to the soon to be
255 obsolete base section (I assume it is) closes: Bug#53582
256 * Rearranged the virtual packages list. closes: Bug#72980
257 * This is basically an attempt to ratify the current practice of using
258 debhelper in the clean target. Currently, policy does not require
259 debhelper to be installed when the clean target is run, even though it
260 is in the build-depends field. This was a simple oversight.
262 * No longer depend on fileutils. closes: Bug#167425
263 * Added the Apps/Science menu section closes: Bug#162812
264 * Applied text patch from Joey Hess to the debconf spec simply make it
265 conform to the reality of how some things work now. This is part of an
266 effort to make debconf and cdebconf better substitutes for each
267 other. Since it was not an XML patch, no special markup is present in
268 the new content, except where I made guesses. closes: Bug#160776
269 * Clarify section 13.3. closes: Bug#160248
270 * Removed the undocumented(7) hack requirement. closes: Bug#39830
272 * Removed the obsolete notion of documenting changes within the copyright
273 file, closes: Bug#65764
275 -- Manoj Srivastava <srivasta@debian.org> Fri, 15 Nov 2002 00:36:54 -0600
277 debian-policy (3.5.7.1) unstable; urgency=low
279 * Fix the debconf spec to (postinst -> postrm) closes: Bug#129375, Bug#160839
280 * Fix update-rc.d example, mention that changing run-levels or priority
281 may require removing and re-creating the symbolic links. closes: Bug#149709
282 * Fix the groff and col -b interaction closes: Bug#164755
283 * Added section numbers to upgrading checklist closes: Bug#160914
284 * Fixed typo KB_Backspace -> KB_BackSpace
285 * Clarify wording in the section about ChangeLog files to allow for
286 symbolic links in /usr/share/doc/ directory (was already allowed in a
287 previous section of policy 13.6) closes: Bug#111137
288 * Removed a spurious + from text. closes: Bug#160908
289 * Added a note in the debconf spec to consult debconf-devel(8) for
290 details. closes: Bug#133030
291 * Added a reference to the local copy of the FHS. closes: Bug#122928
292 * Updated reference to ash (dash). This implements the non controversial
295 -- Manoj Srivastava <srivasta@debian.org> Sat, 26 Oct 2002 13:12:49 -0500
297 debian-policy (3.5.7.0) unstable; urgency=low
299 * Fixed some broken hrefs in links
300 * No longer use local debiandoc stuff (it's been fixed upstream)
301 * Added table of contents (index.html) to policy-process.sgml, fixing
302 the new error reported to bug #137521 closes: Bug#137521
303 * Fixed a couple of typos closes: Bug#139832
304 * Ran through the policy document looking for long instances of text in
305 the <tt> tag, and changed it to <file> where appropriate. This is
306 since the <file> tag can handle line breaking, but the <t> flag does
307 not. closes: Bug#139820
308 * Change the requirement to ask permission to make devices to merely
309 requiring a notification. closes: Bug#106280
310 * Added a build dependson docbook utils. closes: Bug#154660
311 * Since this is being built with a newer version of debiandoc-sgml, this
312 should display better with lynx. closes: Bug#153704
313 * Add in the crypto-in-main amendment. closes: Bug#81852, Bug#144411
314 * we no longer have task packages, instead, we define tasks using a
315 special field in the control file (and these should be added only
316 after discussion on the mailing lists) closes: Bug#97755
317 * Clarify wording in the section for packages providing fonts.
319 * Fix the doc base file for policy process closes: Bug#137521, Bug#147554
321 * using set -e is not dubious advice. Rejecting this. closes: Bug#139969
322 * Make the directory one is building under ./debian/ be up to the
323 maintainer, instead of mandating ./debian/tmp/ closes: Bug#144297
324 * Add a standards version closes: Bug#145067
325 * Added virtual package debconf-2.0 closes: Bug#151328
326 * Added The Window Manager Specification Project support to the default
327 window manager selection mechanism closes: Bug#155680
328 * The confusion between /var/mail and /var/spool/mail seems to have been
329 disambiguated. closes: Bug#114949
330 * Mention the new Build-Depend-Indep semantic and the new
331 build-indep/build-arch rules in upgrading checklist closes: Bug#116134
332 * Made package naming rules in policy consistent. I did not eliminate
333 the duplication, since I don't want to make major changes to the flow,
334 since we are supposed to be re-writing policy anyway. closes: Bug#131441
335 * Clarified wording about cases where we may have concrete and virtual
336 packages with the same name. closes: Bug#134977
337 * Fixed typo 'be be' closes: Bug#138681
338 * Fixed typo in appendix G -- example of diversion closes: Bug#140697
339 * fix typo shlib: -> shlibs: closes: Bug#141903
340 * Provide a link between two sections dealing with virtual packages.
342 * Fixed xtifr's email address in the menu policy closes: Bug#152965
343 * Allow shared library names to be have a hyphen between library name
344 and soversion if the library name ends in a number. closes: Bug#100472
345 * Permit some libraries to only install static libs. closes: Bug#100346
346 * Remove the debug option, add noopt closes: Bug#157131, Bug#113525
347 * provide dhcp-client virtual package. closes: Bug#154142
348 * We do not need bits in policy that ``should not be enforced''.
350 * We are building this with the latest debianndoc-sgml. closes: Bug#146703
351 * Finish incorporating all of the accepted changes in Bug#72335, and
352 this closes: Bug#141307, Bug#156546
353 * Added virtual package aspell-dictionary closes: Bug#139067
354 * Added virtual package radius-server closes: Bug#118608
355 * Clarifying manual pages is not a policy issue. closes: Bug#112828
356 * Corrected the ldconfig handling instructions. closes: Bug#111025
357 * Not a policy issue. closes: Bug#106826
358 * Removed the /usr/doc/ symlink clause. closes: Bug#47298, Bug#69311
360 -- Manoj Srivastava <srivasta@debian.org> Sat, 31 Aug 2002 02:18:02 -0500
362 debian-policy (3.5.6.1) unstable; urgency=low
364 * Set the cotact information for the FHS contact, and add mention of the
365 FHS mailing list. closes: Bug#137172
366 * ftp://ftp.debian.org/debian/doc/package-developer/ certainly seems to
367 exist, and does contain the menu policy. closes: Bug#110711, Bug#121977
368 * Added java related virtual packages closes: Bug#110713
369 * Fixed confusion in appar4ently contradictory wording about /etc/init.d
370 scripts: clarified to emphasize that the init.d files _are_
371 configuration files, and they _must_ have local changes preserved,
372 either (if they are present in the .deb) by marking them as conffiles
373 or, if they do not exist in the .deb file, by any other means. This
374 does not change any requirements, and should have no affect on any
375 conformant packages. closes: Bug#132621
376 * Fixed error in doc-base file closes: Bug#137521
377 * fixed typo in virtual packages list closes: Bug#110446
378 * Fixed typo in upgrading checklist. closes: Bug#110705
379 * Fixed typo (dependencies) in the policy closes: Bug#122931
380 * Fixed grammar errors in the policy closes: Bug#126131
381 * While I am cleaning out bugs, these are old and the reporter no longer
382 wnats to pursue them, and there was never a consensus reached. If
383 there is interest, new bugs can be filed. closes: Bug#51411, Bug#51412
384 * Added the virtual package dict-client closes: Bug#122996
385 * Added the virtual package foomatic-data closes: Bug#123570
386 * Added the virtual packages {x-}audio-mixer closes: Bug#131781
388 -- Manoj Srivastava <srivasta@debian.org> Thu, 14 Mar 2002 12:16:53 -0600
390 debian-policy (3.5.6.0) unstable; urgency=low
392 * Change footnote about urgency values to the now-current list: low,
393 medium, high, emergency.
394 * Correct note about /etc/default files being conffiles/config files,
395 which I mucked up (sorry Joey) [10.3.2]
396 * [AMENDMENT 2001/06/26] Downgrade emacs/tex to optional
397 closes: Bug#102204, Bug#53849
398 * [AMENDMENT 2001/06/26] Next stage in usr/doc -> usr/share/doc transition
401 * [AMENDMENT 09/06/2001] Clarifying FHS policy closes: Bug#98291, Bug#60461
402 * Spelling correction closes: Bug#105625
403 * [AMMENDMENT 28/06/2001] Restrict http access to /usr/share/doc
405 * [AMENDMENT 23/5/2001] Optional build-arch and build-indep targets for
406 debian/rules closes: Bug#72335
407 * The old packaging manual is included in the policy document as an
408 informative appendix. It is not part of Debian Technical Policy, and
409 its presence is a temporary measure until dpkg documentation includes
410 the information provided. closes: Bug#105535
411 * Added information about optional blank lines in the chagelog format.
414 -- Manoj Srivastava <srivasta@debian.org> Tue, 24 Jul 2001 21:43:22 -0500
416 debian-policy (3.5.5.0) unstable; urgency=low
418 * Fixed up incorrect entries in the changelog (there was an erroneous
419 3.5.0.1 revision which never happened; it has now been correctly
420 merged with the 3.5.3.0 changelog entry)
421 * Add section numbers to upgrading-checklist for all revisions from
423 * Complete rewrite (and renumbering) of sections 9.1 and 9,2
424 * This time *really* include the HTML version of the FHS
425 * Added doc-base support for all of the HTML files
426 * Added several more files to the byhand list and rewrote chunks of
427 debian/rules to do this
428 * Add patched versions of debiandoc-sgml stuff to source package until
429 patches are incorporated upstream
430 * Versioned Build-Depend on debiandoc-sgml for fixed Text.pm
431 * Improved mkdir example in 10.1.2 closes: Bug#92744
432 * Made the "where examples live" entry in the upgrading-checklist
433 clearer (add "for use by scripts")
434 * Add a dpkg-statoverride description section closes: Bug#89473
435 * Fix the ldconfig usage description (remove "only if")
437 * Clarification of package priority issues vis-a-vis the X Windows
438 system closes: Bug#91249
439 * Enhanced x-terminal-emulator policy closes: Bug#91252
440 * Minor changes to X app-defaults policy closes: Bug#91259
441 * Clarification of X policy in respect to FHS closes: Bug#91260
442 * OpenMotif has the same rules as OSF/Motif closes: Bug#91261
443 * The X Font policy rewrite closes: Bug#91257
444 * The "man" program is no longer guaranteed to read header information
445 to find alternative manpage names closes: Bug#94995
446 * Correction to meaning of Standards-Version closes: Bug#97072
447 * Split section 12.8 (X Window System) into subsections for readability
448 * Plug-ins != shared libraries (at last) closes: Bug#66023
449 * Add packaging manual remnants to policy document as appendices, and
450 mention this in control file closes: Bug#95906
451 * Clarification in Perl policy closes: Bug#98712
453 -- Julian Gilbey <jdg@debian.org> Fri, 1 Jun 2001 10:37:52 +0100
455 debian-policy (3.5.4.0) unstable; urgency=low
457 * [ACCEPTED 2/4/01] /var/mail and /var/spool/mail closes: Bug#42052
458 * [AMENDMENT 26/04/2001] include Perl Policy closes: Bug#83977
459 * Also incorporates all the improvements that Julian has made to to the
460 grammar and flow of the policy manual. The following are mostly
462 * Removed reference to non-extant dpkg documentation
463 * Fixed the confusing self referential language. closes: Bug#85503
464 * Correct ambiguous kanguage about declaring build dependencies.
466 * Improved the woding of the footnote about shlibdeps.
469 -- Manoj Srivastava <srivasta@debian.org> Sat, 28 Apr 2001 13:30:21 -0500
471 debian-policy (3.5.3.0) unstable; urgency=low
473 * Removed recommendation on packaging-manual
474 closes: Bug#86507, #93620, #93705
475 * Also now Conflicts and Replaces packaging-manual
476 * Remove FSSTND from binary package, although retain it in the source
477 package for the time being
478 * Get the version.ent non-compression thingy right this time!
479 * Also install FHS stuff byhand (as requested by webmasters)
480 * Corrected GPL name and location closes: Bug#88788, #93047
481 * Correct bug severities closes: Bug#91276
482 * Correct typos etc. in policy-process
483 * Rename all .text files as .txt
484 * Fixed the "to to" typo in policy closes: Bug#87007
485 * Changed packaging manual ==> dpkg documentation closes: Bug#88651
486 * [ACCEPTED 14/03/2001] Deprecate confusing closes: Bug#87828
487 Build-Depends arch syntax
488 * [AMENDMENT 29/03/2001] Clarification of example closes: Bug#87711
490 * Undo all renaming to text, since the change had not been propogated to
491 the rules file, which broke badly. This shall have to wait for a later
493 * Richard Braakman and Michael Dorman have expressed their resignation
494 from policy maintenance duties.
495 * fixed the date thinko in upgrading checklist. Thanks to Sébastien
496 Montagne <sebastien.montagne@netcourrier.com> closes: Bug#84236
498 -- Manoj Srivastava <srivasta@debian.org> Sun, 15 Apr 2001 13:36:19 -0500
500 debian-policy (3.5.2.0) unstable; urgency=low
502 * Add XFree86 app-defaults ammendment closes: Bug#83069
504 -- Julian Gilbey <jdg@debian.org> Sun, 18 Feb 2001 14:11:49 +0000
506 debian-policy (3.5.1.0) unstable; urgency=low
508 * Removed deprecated virtual package names closes: Bug#84641
509 * Changed rmdir postrm example (suggestion on -policy list)
510 * Removed Richard Braakman from list of maintainers at his request
511 * Corrected typos and grammatical errors found by Sean Perry
512 closes: Bug#85501, #85504, #85505, #85506
513 closes: Bug#85508, #85510, #85511, #85514
514 closes: Bug#84631, #84636, #85497, #85982
515 closes: Bug#85986, #85993, #86001
516 * No longer include the old proposal document closes: Bug#84079
517 * Update footnote about dpkg-shlibdeps now that it uses objdump; bump up
518 minor version number for this
519 * Updated dpkg-shlibdeps example to use up-to-date package names (and
520 correct dpkg-shlibdeps command line syntax)
521 * Clarify error conditions for package installation
522 (Bug#61801 from packaging-manual)
523 * Add the "main" section of each distribution (got left out by
524 accident!) (Bug#64304, #75955 from packaging-manual)
525 * Clean version numbering string (Bug#73064 from packaging-manual)
526 * Install HTML version of FHS closes: Bug#83487
527 * Removed bashism from debian/rules
529 -- Julian Gilbey <jdg@debian.org> Thu, 15 Feb 2001 12:13:00 +0000
531 debian-policy (3.5.0.0) unstable; urgency=low
533 * There have been numerous changes since the last major change, and
534 peole have had tiome now to review the recent changes, so I am
535 updating the policy minor version to reflect the quantity and
536 magnitude of changes since 3.2.1
537 * More spelling corrections, thanks to "Christian T. Steigies"
539 * Added mention of DEB_BUILD_OPTIONS in upgrading checklist.
541 * Fixed some typos. closes: Bug#83960
542 * Policy now mentions preinst scripts. closes: Bug#80342
543 * [AMENDMENT 2000/12/26] allow/document use of Debian Configuration
544 management system (debconf) closes: Bug#80347
545 * Yet more typo fixes closes: Bug#82743
546 * Document the fact that X font utilities have moved to the package
547 xutils closes: Bug#82966
548 * Fixed the date in the virtual package list closes: Bug#83438
549 * Cleaned up some ephemeral informative foornotes of the polic. Thanks
550 to Branden Robinson <branden@debian.org> closes: Bug#83065
551 * Corrected reference to the mime policy. closes: Bug#79891
552 * Corrected reference to the menu policy. closes: Bug#75925
553 * Added a note to the effect that the example make snippet used to
554 illustrate the DEB_BUILD_OPTIONS environment variable is merely
555 informative, and expanded the example to dismiss any confusion about
556 potential failure due to accidentally trying to strip scripts.
559 -- Manoj Srivastava <srivasta@debian.org> Sun, 28 Jan 2001 21:59:16 -0600
561 debian-policy (3.2.1.2) unstable; urgency=low
563 * The minimal change in version number is so that people can test and
564 root out the bugs in this document before we make everyone change to
566 * Document the Enhances relationship
567 * Removed the restriction that one, and exactly one, person must
568 maintain a package. closes: Bug#51879
569 * Fixed a typo, and added the nogroup name, in uid/gid section of
570 policy. closes: Bug#53496
571 * Fixed a misstatement in policy about not needing to depend on packages
572 in the base system (not true -- the Essential tag is significant)
574 * Clarified update-rc.d stuff closes: Bug#55048
576 * We have already included the material for shlibdep changes, and most
577 of this is not relevant to policy anyway. closes: Bug#55730
578 * makedev--> MAKEDEV closes: Bug#57154
579 * Added restrictions on the files in /usr/share/doc/
581 * Changed location of a paragraph about copyright files into the section
582 that deals with copyright files. closes: Bug#65765
583 * init script configuration variables closes: Bug#66912
584 * Clarifed language about packages sharing a conffile need to be marked
585 as conflicting closes: Bug#76028
587 -- Manoj Srivastava <srivasta@debian.org> Thu, 18 Jan 2001 01:43:58 -0600
589 debian-policy (3.2.1.1) unstable; urgency=low
591 * Don't compress version.ent in the doc directory (it gets bigger!)
592 * Incorporate the packaging manual into the policy document. The minimal
593 change in version number is because I suspect that this version is
595 closes: Bug#62943, Bug#72949
596 * Fixed typo in menu-policy. closes: Bug#70442
597 * Fixed typo in policy manual closes: Bug#70634, Bug#70643
598 * Removed extraneous > from policy closes: Bug#77645
599 * Fixed two typos in upgrading checklist closes: Bug#78809, Bug#78822
600 * Fixed spelling of utility closes: Bug#82458
601 * [ACCEPTED 2000/09/08] Free pkgs depending on non-US should go into
602 non-US/{main,contrib} closes: Bug#69229
603 * Added rsh-server and telnet server to the virtual packages list
605 * Fixed outdated references to the FHS. closes: Bug#77650
607 -- Manoj Srivastava <srivasta@debian.org> Tue, 16 Jan 2001 23:53:31 -0600
609 debian-policy (3.2.1.0) unstable; urgency=low
611 * [AMENDMENT 15/01/2000] revision of the "to build with X support or
612 not" policy. closes: Bug#53759
613 * [ACCEPTED 2000/06/06] Must/Should/May in policy This is only a
614 clarifying change, and was not intended to change the intent of
615 policy. closes: Bug#64437
616 * [ACCEPTED 03/05/2000] About the use of conffiles. closes: Bug#61308
617 * [AMENDMENT 10/05/2000] s/mail\.mail/root\.mail/ closes: Bug#62668
618 * [ACCEPTED 04/05/2000] Update for new non-US layout closes: Bug#62946
619 * [ACCEPTED 04/05/2000] s/debian-devel/debian-legal/ closes: Bug#62947
620 * [ACCEPTED 04/05/2000] s/bash/base-files/ closes: Bug#62948
621 * Typo: 1744s/tty/ttyS/ closes: Bug#64516
622 * proposal for mp3-encoder virtual package closes: Bug#64004
623 * proposal for mp3-decoder virtual package closes: Bug#64006
624 * new virtual package time-daemon closes: Bug#69031
625 * [PATCH] typos in menu-policy.sgml closes: Bug#69424
626 * [PATCH] typos and awkwardness in policy.sgml closes: Bug#69426
627 * the example for using nostrip in DEB_BUILD_OPTIONS is
628 incorrect. closes: Bug#69487
629 * [PATCH] more corrections closes: Bug#69670
630 * [AMENDMENT 26/10/99] Amend non-free definition closes: Bug#46522
631 * [AMMENDMENT 29/10/99] /bin/sh needs echo -n closes: Bug#48247
632 * [AMENDMENT 1999/11/23] Clarify meaning of Essential: yes
634 * [ACCEPTED] Request for new virtual packages: rsh-client and
635 telnet-client closes: Bug#58759
637 -- Manoj Srivastava <srivasta@debian.org> Thu, 24 Aug 2000 02:06:30 -0500
639 debian-policy (3.2.0.0) unstable; urgency=low
641 * Fixed bugs in debian-policy package:
642 * We have had doc-base support for a while now. closes: Bug#15709
643 * packaging manual: Added additional clarification on dpkg
644 behaviour. closes: Bug#17369
645 * [PROPOSAL] Do not make hardlinks to conffiles closes: Bug#22935
646 * [PROPOSED]: clarification needed about diversions.
647 fixed usage for dpkg-divert closes: Bug#29522
648 * [OLD PROPOSAL] debian-policy has an unclear statement
649 on dependancies and priorities closes: Bug#39398
650 * [ACCEPTED 10/26/99] changelog.html.gz sanitization. closes: Bug#40934
651 * [AMENDED 07/09/1999] policy on -g, a proposal closes: Bug#43787
652 * Fixed missing </chapt> tag. closes: Bug#51091
653 * Correct typo in section 2.3.5 closes: Bug#52225
654 * Documented that the library before the symlink hack
655 (which dependend on file system specific kinks to work)
656 is no longer required by newer versions of dpkg. closes: Bug#53405
657 * [ACCEPTED 02/01/2000] policy for usage of "xserver"
658 alternative closes: Bug#53755
659 * [ACCEPTED 02/01/2000] additions to virtual package
660 list closes: Bug#53756
661 * [ACCEPTED 02/01/2000] policy for "x-terminal-emulator"
662 virtual package and alternative closes: Bug#53757
663 * [ACCEPTED 02/01/2000] policy for "x-window-manager"
664 virtual package and alternative closes: Bug#53758
665 * [ACCEPTED 02/01/2000] revision of X application-defaults
666 policy closes: Bug#53760
667 * [ACCEPTED 02/01/2000] revision of the Motif/LessTif
668 policy closes: Bug#53761
669 * [ACCEPTED 02/01/2000] applying the FHS to packages
670 that use X closes: Bug#53762
671 * [ACCEPTED 02/01/2000] policy for X font packages closes: Bug#53763
672 * Moved the documents into the Debian/ section, since
673 that is where they belong, really. closes: Bug#54777
674 * Fixed the ftp location in the manuals. closes: Bug#56407
675 * Fixed missing urlname entity in the sgml docs (where
676 was it defined before anyway?) closes: Bug#56692
677 * Fixed bugs in packaging-manual package:
678 * Fixed typo where dpkg-genchanges was used instead of
679 dpkg-gencontrol. closes: Bug#58771
681 * Added policy-process to document current procedures.
682 * Added a dependency on fileutiles >=4.0, since the package would fail
683 to install with older fileutils.
684 * Installed FHS version 2.1
685 * Policy recommends packaging manual and vice versa
686 * Added FHS details to copyright file
687 * Updaed the upgrade checklist. Minor changes to the ./debian/rules
689 * Added footnotes in the packaging manual warning about the upcoming
690 dpkg-shlibdeps change as in Bug#55730
692 -- Manoj Srivastava <srivasta@debian.org> Sun, 30 Jul 2000 17:43:02 -0500
694 debian-policy (3.1.1.3) unstable; urgency=low
696 * Fixed an upgrade bug when /usr/doc happens to be a symlink, and does
697 not point to /usr/share/doc. A couple of people were bitten by this.
699 -- Manoj Srivastava <srivasta@debian.org> Mon, 28 Feb 2000 22:27:05 -0600
701 debian-policy (3.1.1.2) unstable; urgency=low
703 * Correct missing </chapt> in packaging.sgml (closes: #51091)
704 * Correct typo in policy 2.3.5 (closes: #52225)
706 -- Julian Gilbey <jdg@debian.org> Mon, 20 Dec 1999 20:39:57 +0000
709 debian-policy (3.1.1.1) unstable; urgency=low
711 * Correction to typo in packaging manual, section 6.2.
712 * Correction to typo in packaging manual, section 12.2.5 (closes:
714 * More corrections to packaging manual typos (closes: #50857)
716 -- Julian Gilbey <jdg@debian.org> Mon, 22 Nov 1999 19:23:31 +0000
718 debian-policy (3.1.1.0) unstable; urgency=low
720 * Correct description of negated architectures in Build-Depends
721 description in Packaging manual (closes: #49901)
723 -- Julian Gilbey <jdg@debian.org> Tue, 16 Nov 1999 15:03:48 +0000
725 debian-policy (3.1.0.0) unstable; urgency=low
727 * Add instructions on /usr/doc -> /usr/share/doc symlinks (closes:
728 #45561, #42447, #48570)
729 * Added source dependencies (closes: #41232)
730 * Deprecated /etc/rc.boot (closes: #32448, #32449)
731 * Update-rc.d now only legal way to automatically access /etc/rc?.d
732 directoried (closes: #41547)
733 * FHS compliant location of examples (closes: #42849)
734 * Added ispell-dictionary to virtual-packages.list (following new
735 suggestions: no objections => accept) (closes: #8221)
736 * Added man-browser to virtual-packages.list (closes: #24695)
737 * Added ident-server to virtual-packages.list (closes: #45307)
738 * Alphabeticised virtual packages list ;)
739 * Corrected GPL reference in proposal.sgml
740 * Clarification of "extra" priority (closes: #33076)
741 * Remove buggy and seriously problematic licenses from list of contrib
742 package criteria (closes: #45318)
743 * Move docs to /usr/share/doc with a compatibility symlink (closes:
745 * Update to FHS 2.1 draft #3 (for /var/state etc. changes).
746 * Correct /var/lib/games -> /var/games (closes: #42358)
747 * Added MIME subpolicy (closes: #46516)
748 * Added support for VISUAL (closes: #41121)
749 * Clarify non-dependence on /usr/local (closes: #44922)
750 * Modified description of mail spool locking (closes: #43651)
751 * Clarified wording of conffiles and configuration files (closes:
753 * Changed description of release numbers (closes: #44620)
754 * Added changelog.html -> changelog requirement (closes: $40934)
755 * packaging-manual now correctly installs its docs (closes: #44643)
756 * The packaging manual now discusses version numbers based on dates
758 * Mention ls -f for testing order in which files appear on disk (closes:
760 * Change order of '.' and '+' in description of version numbers (closes:
762 * s/fields/field names/ in section 4.1 of packaging manual for clarity
763 * Add Build-Depends-Indep: field to control file
765 -- Julian Gilbey <jdg@debian.org> Thu, 4 Nov 1999 23:50:37 +0000
767 debian-policy (3.0.1.1) unstable; urgency=low
769 * Typo corrected in packaging manual. closes: Bug#40180
770 * Chnaged rules file to create ps and pdf files.
772 -- Manoj Srivastava <srivasta@debian.org> Mon, 16 Aug 1999 01:21:09 -0500
774 debian-policy (3.0.1.0) unstable; urgency=low
776 * A few typos and omissions corrected
777 * Added the pop3-server to the virtual packages list, as decided on the
779 * Fix the self reference to a location on the web site. closes: Bug#39408
780 * Added the clarification that the .la files are essential for the
781 packages using libtool's libltdl library, in which case the
782 .la files must go in the run-time library package. (this is why this
783 is version 3.0.1.0, and not 3.0.0.1)
784 * The virtual package list has new directions (this has been true for a
785 while, I am just closing the bug now). closes: Bug#26159
786 * Since this package now contains the FHS, this closes: Bug#25533
787 * The General resolution prototcol handling of the logos closes: Bug#26915
788 * Inclusion of the Menu policy in the main policy document closes: Bug#30036
789 * Since proposal submitting guidelines are now in the policy package,
790 this closes: Bug#38612
791 * Changed a /usr/doc reference to /usr/share/doc which had beeen missed
792 before. closes: Bug#40864
794 -- Manoj Srivastava <srivasta@debian.org> Thu, 15 Jul 1999 13:35:11 -0500
796 debian-policy (3.0.0.0) unstable; urgency=low
798 * This is a test version of the policy package, and shall not be
800 * Merged in the packaging manual sources (we still have two separate
802 * Multiple minor packaging tweaks.
803 * [ACCEPTED 1998/05/01] Policy clarification about Standards-Version
804 Added the clarifying paragraph (and the rationale in a footnote).
806 * [ACCEPTED 1999/04/05] Policy note that GPL moved to
807 /usr/share/common-licenses. Again, also added the rationale as a
808 footnote. closes: Bug#28747
809 * [ACCEPTED 1999/05/04] Libtool archive (*.la) files in -dev' packages
810 closes: Bug#37257, Bug#37338
811 * [ACCEPTED 1999/04/28] Logrotation. Standardizer on logrotate.
813 * [ACCEPTED 1999/05/23] Rewrite of section 5.7 (Programs for the X
814 Window System) closes: Bug#38212
815 * [ACCEPTED 1999/05/15] Separate menu policy (like virtual package list)
817 * [ACCEPTED 1999/05/09] Utmp group proposal
819 * [ACCEPTED 1999/05/09] Adopt the FHS in place of FSSTND
820 Changed all references to the proper FHS versions. This was a first
821 scan, so some references may still need to be changed. closes: Bug#37345
822 * Updated the upgrading checklist.
823 * updated the proposal for policy update to reflect the latest
825 -- Manoj Srivastava <srivasta@debian.org> Wed, 30 Jun 1999 22:49:15 -0500
827 debian-policy (2.5.1.0) unstable; urgency=low
829 * Removed double '>' marks from the policy document. closes: Bug#35095
830 * Corrected canonical source for "Csh Programming Considered Harmful"
831 closes: Bug#36286 Bug#32499
832 * Fixed typo in invocation of update-rc.d. closes: Bug#34988 Bug#34543
833 * Fixed misspelling of accessible. Ran ispell over the rest of the
834 document (painful because of the large number of technical terms in
835 there). closes: Bug#34233
836 * Make the binary package contain the version.ent as well. closes: Bug#31033
837 * Fixed typo s/as is/is/. closes: Bug#30302
838 * AMENDMENT 23/04/1999: changed /etc/nntpserver recommendation to
839 /etc/news/server. closes: Bug#21875
840 * Added the current list of policy maintainers. closes: Bug#30148
842 -- Manoj Srivastava <srivasta@debian.org> Tue, 27 Apr 1999 11:10:29 -0500
844 debian-policy (2.5.0.0) unstable; urgency=low
846 * AMENDMENT: Added in changes in Bug #25911, which rearranged sections
847 to create a new section 4, namely, files. Section 3.3 ("Files") should
848 become Section 4. The Sections that are currently Section 4 and
849 Section 5 should be moved down to become Section 5 and Section 6
852 What is now Section 5.5 ("Log files") should be moved to be a
853 subsection of the new Section 4 ("Files"), becoming section 4.8,
854 placing it after "Configuration files", moving the would-be Section
855 4.8 ("Permissions and owners") to Section 4.9. All subsections of the
856 current Section 5 after 5.5 should be accordingly moved down to fill
859 This, along with the next amendment, justifies bumping up the version
860 number. closes: BUG#25911
862 * AMENDMENT: Added in changes in Bug #21185, about the naming and
863 compression of changelog files. Now, if the upstream changelog file is
864 HTML formatted, it should be accessible as
865 /usr/doc/<package>/changelog.html.gz It also allows for this to be a
866 symlink, if the upstream file name does not conform to Debian
867 conventions. closes: BUG#21185
869 * AMENDMENT: Added in changes in Bug #7890, to make clear that the HTML
870 documents should be supplied in _some_ package, not necessarily in the
871 main binary package (at the discretion of the maintainer).
874 * AMENDMENT: Added in changes in Bug #26461, which corrects the policy
875 to refer to /usr/doc/<package>/copyright, rather than
876 /usr/doc/copyright/<package>. closes: BUG#26461
878 * AMENDMENT: Added in changes in Bug #25385, which allow the
879 architecture specification strings to be of the form <arch>-<os>,
880 where os is one of linux, gnu. Previously, only linux was allowed, now
881 we also cater to the hurd. closes: BUG#25385
883 * The responsibility of the contents of this package has now passed to
884 the debian-policy mailing list. The packaging details are now being
885 managed by a group of maintainers that do ot won the contents.
887 * Make the package optional, not extra.
889 * Re did the SGML markup. Normalized the document, and undid the omitted
890 and shor tags. Personally, I use too many DTD's in real life to be so
891 converssant with each one to be clever with tag omissions, and, since
892 I have a smart editor, omitting tags does not byuy one much. In the
893 process, I discovered a few errors in the markup (one of my
894 predecessors hasd the unfortunate habit of treating <p> as a "create
895 some space here" tag, and more often than not put it at the end of a
896 paragraph, rather than using is as a container element (which is what
899 * Re did the control files, making them more robust
901 * re did the rules file, making it more general, and easier to maintain
902 by putting in a layer of abstractions.
905 -- Manoj Srivastava <srivasta@debian.org> Thu, 29 Oct 1998 15:16:52 -0600
907 debian-policy (2.4.1.4) unstable; urgency=low
909 * New Maintainer <debian-policy@lists.debian.org>
911 -- Philip Hands <phil@hands.com> Sat, 5 Sep 1998 02:41:35 +0100
913 debian-policy (2.4.1.3) unstable; urgency=low
915 * New maintainer (with changes from Adam P. Harris' proposed NMU)
916 * policy.sgml: some awkward phrasings fixed (closes Bug#22006)
917 * policy.sgml: s/depreciated/deprecated (closes Bug#21831)
918 * debian/control: added conflict doc-base (<< 0.6), which I still am not
919 sure why we need this but hey (closes Bug#21554)
920 * policy.sgml: use new <url> tag where appropriate
921 * policy.sgml, debian/control: always dynamically self reference the
922 current version of policy, that is, do not hard code policy revision
924 * debian/rules: use dpkg-gencontrol -isp
925 * bugs fixed in some unknown previous version (closes Bug#23177)
927 -- Philip Hands <phil@hands.com> Tue, 11 Aug 1998 09:54:17 +0100
929 debian-policy (2.4.1.2) frozen unstable; urgency=low
931 * non-maintainer release
932 * rebuild package to fix truncated Chapter 3 (Bug#23408, not marked as
933 important but should be, since a gaping hole in policy is very
935 * bumped version of policy, within the document, to this version number,
936 but not the date, indicating nothing really changed since then
938 * debian/rules: clean is a little cleaner
940 -- Adam P. Harris <aph@debian.org> Tue, 16 Jun 1998 03:15:22 -0400
942 debian-policy (2.4.1.1) frozen unstable; urgency=low
946 -- Christian Schwarz <schwarz@debian.org> Thu, 14 May 1998 21:54:50 +0200
948 debian-policy (2.4.1.0) frozen unstable; urgency=low
950 * Changes to the Debian Policy Manual:
952 - Updated section 3.1.2 Site-specific programs
953 and section 3.8 Keyboard configuration:
954 + improved wording (fixes:bug#20129)
956 - Updated section 2.1.7 Subsections:
957 + fixed typos (fixes:bug#18145)
959 - Updated section 3.3.5 Symbolic links:
960 + symbolic links within a toplevel directory should be relative,
961 symbolic links between toplevel directories should be absolute
962 (cf., Policy Weekly Issue#6, topic 2)
964 - Updated section 3.4 System run levels:
965 + Intro: mention /etc/rcS.d (links to boot time scripts)
966 + Notes: include rationale why /etc/init.d scripts have to be tagged
967 as conffiles (fixes:bug#16199)
968 + Example: changed example init.d script to handle force-reload
969 and restart options and to comply with the console message
970 standard (fixes:bug#19216)
972 - Updated section 4.8 Emacs lisp programs:
973 + Replaced old section about lisp programs with a reference to
974 the file debian-emacs-policy.gz, installed by the emacsen-common
977 - Updated section 4.9 Games:
978 + manpages for games should be installed in /usr/man/man6
979 (cf., Policy Weekly Issue#6, topic 3)
981 - Removed one example reference to the current standards version
982 - Include manual's date as plain text in the .sgml source so that
983 a recompiled manual uses the same release date
985 * Changes to the authoritative list of virtual package names:
986 - Removed obsolete virtual package `emacs'
988 * New version numbering scheme:
990 - The version numbers are independent of dpkg now, but all policy
991 manuals (the Debian Policy Manual, the Debian Packaging Manual, and
992 the Debian Developer's Reference) share the same version numbering
995 - The first three digits of the version number specify the
996 `Standards-Version.' This number is incremented with each policy
997 change. The fourth digit represents the `patch-level,' which may
998 differ between the manuals.
1000 If only the patch-level digit is incremented, no changes in policy
1001 have been made, except bug fixes and clarifications. Packages only
1002 have to specify the first three digits of the version number in the
1003 `Standards-Version' field of their source packages.
1005 * Packaging changes:
1007 - Uploaded to frozen and unstable. This is a documentation-only
1008 package and the changes to the manual are relevant for hamm.
1010 - Fixed FSF's address in copyright file (detected by Lintian)
1012 -- Christian Schwarz <schwarz@debian.org> Tue, 14 Apr 1998 10:08:09 +0200
1014 debian-policy (2.4.0.0) unstable; urgency=low
1016 * Changes to the Debian Policy Manual:
1018 - Updated section 3.3.4 Scripts:
1019 + /bin/sh may be any POSIX compatible shell
1020 + scripts including bashisms have to specify /bin/bash as
1022 + scripts which create files in world-writable directories
1023 (e.g., in /tmp) should use tempfile or mktemp for creating
1026 - Updated section 3.3.5 Symbolic Links:
1027 + symbolic links referencing compressed files must have the same
1028 file extension as the referenced file
1030 - Updated section 3.3.6 Device files:
1031 + /dev/tty* serial devices should be used instead of /dev/cu*
1033 - Updated section 3.4.2 Writing the scripts [in /etc/init.d]:
1034 + all /etc/init.d scripts have to provide the following options:
1035 start, stop, restart, force-reload
1036 + the reload option is optional and must never stop and restart
1039 - Updated section 3.5 Cron jobs:
1040 + cron jobs that need to be executed more often than daily should
1041 be installed into /etc/cron.d
1043 - Updated section 3.7 Menus:
1044 + removed section about how to register HTML docs to `menu'
1045 (the corresponding section in 4.4, Web servers and applications,
1046 has been removed in policy 2.2.0.0 already, so this one was
1049 - New section 3.8 Keyboard configuration:
1050 + details about how the backspace and delete keys should be
1053 - New section 3.9 Environment variables:
1054 + no program must depend on environment variables to get a
1055 reasonable default configuration
1057 - New section 4.6 News system configuration:
1058 + /etc/news/organization and /etc/news/server should be supported
1059 by all news servers and clients
1061 - Updated section 4.7 Programs for the X Windows system:
1062 + programs requiring a non-free Motif library should be provided
1063 as foo-smotif and foo-dmotif package
1064 + if lesstif works reliably for such program, it should be linked
1065 against lesstif and not against a non-free Motif library
1067 - Updated section 4.9 Games:
1068 + games for X Windows have to be installed in /usr/games, just as
1071 - Lots of typos fixed (thanks to Ray Dassen for the patch!)
1073 * Changes to the authoritative list of virtual package names:
1074 - added `libc-dev' and `emacsen'
1076 * Merged `/usr/doc/debian-policy/changelog-policy.gz' into this
1079 * Included `Policy checklist for upgrading your packages' from the
1080 Policy Home Page as /usr/doc/debian-policy/upgrading-checklist.text.gz
1082 * Added support for doc-base to register the Policy Manual to the
1083 online documentation systems dwww and dhelp (fixes:#15710)
1085 * Upgraded to standards version 2.4.0.0 (no changes)
1087 -- Christian Schwarz <schwarz@debian.org> Fri, 30 Jan 1998 21:58:25 +0100
1089 debian-policy (2.3.0.1) unstable; urgency=low
1091 * Changes in the Debian Policy Manual:
1092 - X library package is now called xlib6g
1093 * Changes in the authoritative list of virtual package names:
1094 - Added emacs, c-compiler, fortran77-compiler, lambdamoo-core,
1096 * Conflict with old dpkg-dev version that included policy manual
1098 * Removed `tentative-opt-draft' from package since people considered
1099 the draft official policy (which is not the case)
1100 * Don't use debstd anymore
1102 -- Christian Schwarz <schwarz@debian.org> Tue, 21 Oct 1997 23:03:52 +0200
1104 debian-policy (2.3.0.0) unstable; urgency=low
1106 * Changes in the Debian Policy Manual:
1107 - reworked chapter `The Debian Archive' to cover new
1108 contrib/non-free policy
1109 - call "contrib" and "non-free" a `section' (not `distribution')
1110 - refer to license files (GPL, LGPL, etc.) as uncompressed files
1111 - changed `/etc/news/server' into `/etc/nntpserver' in example of
1112 maintainer scripts (fixes #11517)
1113 - new section about `Daemons'
1114 - updated section about `Configuration files'
1115 - MUAs and MTAs have to use liblockfile
1116 - fixed typos and grammatical errors
1117 * Changes in the authoritative list of virtual package names:
1118 - renamed tcl/tk virtual package names to `tclsh' and `wish'
1119 * Paper about libc6 migration:
1120 - fixed typos (fixes #11641), thanks to James Troup for the patch!
1121 * SGML source code included in package
1122 * don't use `2-up' style for PostScript version (fixes #11095)
1124 -- Christian Schwarz <schwarz@debian.org> Mon, 2 Sep 1997 00:54:31 +0200
1126 debian-policy (2.2.0.0) unstable; urgency=low
1128 * Changes in the Debian Policy Manual:
1129 - completely reworked structure
1130 - moved sections about new maintainers, upload procedure, interim
1131 releases, and mailing lists into the Developers Reference Manual
1132 - moved a few (small) sections into the Debian Packaging Manual
1133 - removed all those ugly footnotes
1134 - new example for "reload" in section about console messages
1135 - mention Artistic License (fixes #9793)
1136 - don't mention dpkg's version number in Policy Manual
1137 - rewrote abstract and section introductions
1138 - mention "orphaned packages"
1139 - maintainer is responsible for a package license to comply with the
1140 distributions' policy
1141 - putting a package into base section requires discussion on debian-devel
1142 - rewrote sections about "pre-depends", "essential" and, "base" packages
1143 - added note that non-us' maintainers have to live outside the US
1144 - added crypto-hook statement (fixes #7257)
1145 - added section about arch spec strings
1146 - rewrote section about "Site specific programs" (/usr/local)
1147 - included Ian's suggestions for user IDs
1148 - added section about "menus"
1149 - removed section about "web menus" since this will be superseded with
1150 the new documentation policy soon
1151 - incorporated "Debian Free Software Guidelines" (fixes #9024)
1152 - removed note that linking with -g produces large a.out binary (fixes
1154 - added section about editors and pagers
1155 - added note about Package priorities and dependencies
1156 - added section about cron jobs (fixes #8814)
1157 - added section about device files
1158 - don't install shared libraries as executable (fixes #7129)
1159 - app-defaults files may not be conffiles (cf. #2717)
1160 - lots of minor changes not worth mentioning here (typos, formulations,
1162 * Changes in the authoritative list of virtual package names
1163 - Removed obsolete virtual packages: xR6shlib, xlibraries,
1164 compress, emacs, sgmls, inews, gs_x, gs_svga, gs_both, xpmR6
1165 - Added new section about obsolete names
1166 * Added Helmut Geyer's paper about libc5-libc6 migration
1167 * Fixed package's description
1169 -- Christian Schwarz <schwarz@debian.org> Sun, 13 Jul 1997 13:25:51 +0200
1171 debian-policy (2.1.3.3) frozen unstable; urgency=low
1173 * Mention Artistic License in section 2.5 (bug #9755)
1175 -- Christian Schwarz <schwarz@debian.org> Wed, 14 May 1997 16:53:15 +0200
1177 debian-policy (2.1.3.2) frozen unstable; urgency=low
1179 * Fixed an email address, an URL, and several typos in chapter 6 (#9358)
1180 * Added new virtual package "wordlist" to list (requested by Joey Hess)
1181 * Changed wording in section about "non-free" packages as suggested
1182 by Kai Henningsen (#7076)
1184 -- Christian Schwarz <schwarz@debian.org> Mon, 5 May 1997 20:05:39 +0200
1186 debian-policy (2.1.3.1) frozen unstable; urgency=low
1188 * Fixed bug in chapter 7: `-ur' should read `-us' (#8874)
1189 * Fixed bug in chapter 7: `-rwhatever' also needed for rebuild (#8874)
1190 * Create a PS and HTML version of the Policy Manual and upload it
1192 * Install virtual-package-names-list.text in /usr/doc/debian-policy
1193 and upload it "byhand" too.
1195 -- Christian Schwarz <schwarz@debian.org> Tue, 29 Apr 1997 18:02:14 +0200
1197 debian-policy (2.1.3.0) unstable; urgency=low
1200 * New Policy Manager: Christian Schwarz <schwarz@debian.org>
1201 * Added section 2.4 about the "non-us" distribution.
1202 * Added section 3.1.1 about the "Package" field in the control file.
1203 * Added section 3.2.1 about "Binaries": two programs with different
1204 functionality must not have the same name.
1205 * Changed headline of section 3.2.6 into "Debian changelog and upstream
1206 changelog" as suggested by Santiago Vila Doncel <sanvila@unex.es>.
1207 * Added log-rotating example to section 3.2.9 that tests with `-sf',
1208 as suggested by Boris D. Beletsky <borik@isracom.co.il>.
1209 * Added section 3.13: "Webstandard 3.0" by Christoph Lameter.
1210 * Added section 3.14: "Standard for Console Messages" by Christian Schwarz.
1211 * Split section 4.1 into 4.1.1 (Options for binaries) and 4.1.2 (Options
1213 * Added note to 4.1.2: Libraries should be compiled with `-D_REENTRANT'
1214 to make them compatible with LinuxThreads, by Rob Browning
1215 <osiris@cs.utexas.edu>.
1216 * Added note to 4.1.2: Libraries should be stripped with
1217 "strip --strip-unneeded", by Guy Maor <maor@ece.utexas.edu>.
1218 * Section 5.2: Policy changelog is now
1219 "/usr/doc/debian-policy/changelog-policy.gz". This fixes bug #6130.
1220 * Section 6.2 renamed to "Uploading your first Debian package". This
1223 -- Christian Schwarz <schwarz@debian.org> Sat, 15 Mar 1997 18:08:56 +0100
1225 debian-manuals (2.1.2.2) frozen unstable;
1227 * Fixed even more typographical and grammatical errors in Policy and
1229 * Corrected the contact email addresses again.
1230 * Added a paragraph to Policy 6.3 on taking over an old package (Guy Maor)
1231 * Added a paragraph to Programmer 4.2.14 on listing distributions to load
1232 a package into. (Guy Maor)
1233 * Further clarification of use of absolute pathnames in scripts in
1236 -- David Morris <bweaver@worf.netins.net> Tue, 3 Dec 1996 23:28:04 -0600
1238 debian-manuals (2.1.2.1) frozen unstable;
1240 * Many editorial and formatting revisions with suggestions from Ian Jackson,
1242 * correction of chiark address in Policy 6.2
1243 * footnote in Programmers chapter 2 pointing to deb(5) manpage for
1244 description of deb file format.
1245 * addition of more dpkg examples in Programmer chapter 2
1246 * Replace paragraph in Policy 4.1 outlining compiling parameters for
1248 * Added paragraph in Programmer 6.1 on paths in maintainer scripts
1250 * Cleaned up language and formatting of Programmer's 12.2, shlibs
1251 * Corrected contact addresses for listmaster and override-change
1253 -- David Morris <bweaver@worf.netins.net> Wed, 27 Nov 1996 08:17:16 -0600
1255 debian-manuals (2.1.2.0) frozen unstable;
1257 * Mostly editorial changes in Policy Manual.
1258 * Added summary of distribution criteria to Introduction
1259 * Added section headings for copyright criteria
1260 * Fixed typos (Bugs #4485, #4622)
1261 * Added paragraph in Compilation Options related to use of shared and
1262 static libraries. (Bug #5299)
1263 * Paragraph added about where to find PGP and other export restricted
1264 packages in section on Procedure
1265 * Change in List administrator and in the contact address for becoming
1266 a package maintainer
1267 * A paragraph added related to who to contact for package maintainer changes.
1268 * Changed where to send upload announcements: uploads destined for unstable,
1269 frozen, or experimental go to debian-devel-changes.
1271 * Made some mostly editorial changes to Programmers Manual.
1272 * Added a recommendation to debmake in Introduction.
1273 * A further interpretation of the various Distributions is added with
1274 the intent of helping people decide which one to choose. (section 4.2.14)
1275 * Section 12 on Shared Libraries expanded with further technical information
1276 on various shlib files
1277 * Section in 2.2 on format of shlib file moved to new subsection within 12.
1278 * Paragraph on adding a symlink without version number added to Shared
1279 Library Section (Guy Maor, Bug #5299)
1281 -- David Morris <bweaver@worf.netins.net> Fri, 22 Nov 1996 23:41:39 -0600
1283 debian-manuals (2.1.1.0) unstable;
1285 * Hard links are forbidden in source packages (they didn't work anyway,
1286 and can't easily be made to work reliably).
1287 * Do not use dpkg-divert or update-alternatives without consultation.
1289 * Do not need to declare dependencies on Essential packages.
1290 * Restrictions on Pre-Depends stated in policy manual.
1291 * debian/substvars file is now almost always auto-generated.
1292 * Shared libraries must be installed stripped.
1293 * Essential and Pre-Depends put together in policy manual.
1295 * Explained component-wise (file-wise) vs. package-wise dependencies.
1297 -- Ian Jackson <ian@chiark.greenend.org.uk> Thu, 12 Sep 1996 01:00:41 +0100
1299 debian-manuals (2.1.0.0) unstable;
1301 * Upstream changelog must be installed too (was just recommended).
1303 * Modification to use dpkg-shlibdeps added to conversion instructions.
1304 * Packages which are buggy and orphaned but which are preserved for
1305 compatibility go in contrib.
1307 * Programmers' manual source package section refers to conversion
1308 instructions in policy manual.
1309 * Make it clear that recommending a non-free or contrib package puts a
1312 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sun, 1 Sep 1996 17:47:18 +0100
1314 debian-manuals (2.0.1.0) unstable;
1316 * varargs.h and libtermcap are obsolete - use stdarg.h and ncurses.
1317 * Shared library link/library ordering corrected (aargh).
1318 * When to byte-compile Elisp files.
1319 * Missing final newlines not represented by dpkg-source.
1321 * Must post upload announcements to debian-changes.
1322 * Moved some sections into new `configuring and building' chapter.
1325 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sat, 31 Aug 1996 20:07:22 +0100
1327 debian-manuals (2.0.0.0) unstable;
1329 * Footnote added OK'ing copyrights which require name changes.
1330 * More detail about changelog format names.
1332 * Problematic licence restrictions are formatted as lists.
1333 * Mentioned 822-date utility as way to generate RFC822 format dates.
1337 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Mon, 26 Aug 1996 14:27:34 +0100
1339 debian-manuals (0.2.1.1) unstable;
1341 * Can't overwrite directories in one package with files in another.
1343 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sat, 24 Aug 1996 18:44:54 +0100
1345 debian-manuals (0.2.1.0) unstable;
1347 * Policy says when and how to include original source in upload.
1349 * Need -sa on dpkg-genchanges/dpkg-buildpackage when converting.
1351 * Use minor patchlevel for meaning changes which don't affect packages.
1352 * More verbosity about netiquette.
1353 * Reorganised participation and upload policy: merged with mailing lists.
1355 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Fri, 23 Aug 1996 12:48:09 +0100
1357 debian-manuals (0.2.0.1) experimental;
1359 * Said that system administrators' manual does not exist.
1361 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Fri, 23 Aug 1996 04:05:36 +0100
1363 debian-manuals (0.2.0.0) experimental;
1367 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Wed, 21 Aug 1996 15:07:53 +0100