1 debian-policy (3.5.6.2) unstable; urgency=low
3 * Fixed some broken hrefs in links
4 * No longer use local debiandoc stuff (it's been fixed upstream)
5 * Added table of contents (index.html) to policy-process.sgml, fixing
6 the new error reported to bug #137521 closes: Bug#137521
10 debian-policy (3.5.6.1) unstable; urgency=low
12 * Set the cotact information for the FHS contact, and add mention of the
13 FHS mailing list. closes: Bug#137172
14 * ftp://ftp.debian.org/debian/doc/package-developer/ certainly seems to
15 exist, and does contain the menu policy. closes: Bug#110711, Bug#121977
16 * Added java related virtual packages closes: Bug#110713
17 * Fixed confusion in appar4ently contradictory wording about /etc/init.d
18 scripts: clarified to emphasize that the init.d files _are_
19 configuration files, and they _must_ have local changes preserved,
20 either (if they are present in the .deb) by marking them as conffiles
21 or, if they do not exist in the .deb file, by any other means. This
22 does not change any requirements, and should have no affect on any
23 conformant packages. closes: Bug#132621
24 * Fixed error in doc-base file closes: Bug#137521
25 * fixed typo in virtual packages list closes: Bug#110446
26 * Fixed typo in upgrading checklist. closes: Bug#110705
27 * Fixed typo (dependencies) in the policy closes: Bug#122931
28 * Fixed grammar errors in the policy closes: Bug#126131
29 * While I am cleaning out bugs, these are old and the reporter no longer
30 wnats to pursue them, and there was never a consensus reached. If
31 there is interest, new bugs can be filed. closes: Bug#51411, Bug#51412
32 * Added the virtual package dict-client closes: Bug#122996
33 * Added the virtual package foomatic-data closes: Bug#123570
34 * Added the virtual packages {x-}audio-mixer closes: Bug#131781
36 -- Manoj Srivastava <srivasta@debian.org> Thu, 14 Mar 2002 12:16:53 -0600
38 debian-policy (3.5.6.0) unstable; urgency=low
40 * Change footnote about urgency values to the now-current list: low,
41 medium, high, emergency.
42 * Correct note about /etc/default files being conffiles/config files,
43 which I mucked up (sorry Joey) [10.3.2]
44 * [AMENDMENT 2001/06/26] Downgrade emacs/tex to optional
45 closes: Bug#102204, Bug#53849
46 * [AMENDMENT 2001/06/26] Next stage in usr/doc -> usr/share/doc transition
49 * [AMENDMENT 09/06/2001] Clarifying FHS policy closes: Bug#98291, Bug#60461
50 * Spelling correction closes: Bug#105625
51 * [AMMENDMENT 28/06/2001] Restrict http access to /usr/share/doc
53 * [AMENDMENT 23/5/2001] Optional build-arch and build-indep targets for
54 debian/rules closes: Bug#72335
55 * The old packaging manual is included in the policy document as an
56 informative appendix. It is not part of Debian Technical Policy, and
57 its presence is a temporary measure until dpkg documentation includes
58 the information provided. closes: Bug#105535
59 * Added information about optional blank lines in the chagelog format.
62 -- Manoj Srivastava <srivasta@debian.org> Tue, 24 Jul 2001 21:43:22 -0500
64 debian-policy (3.5.5.0) unstable; urgency=low
66 * Fixed up incorrect entries in the changelog (there was an erroneous
67 3.5.0.1 revision which never happened; it has now been correctly
68 merged with the 3.5.3.0 changelog entry)
69 * Add section numbers to upgrading-checklist for all revisions from
71 * Complete rewrite (and renumbering) of sections 9.1 and 9,2
72 * This time *really* include the HTML version of the FHS
73 * Added doc-base support for all of the HTML files
74 * Added several more files to the byhand list and rewrote chunks of
75 debian/rules to do this
76 * Add patched versions of debiandoc-sgml stuff to source package until
77 patches are incorporated upstream
78 * Versioned Build-Depend on debiandoc-sgml for fixed Text.pm
79 * Improved mkdir example in 10.1.2 closes: Bug#92744
80 * Made the "where examples live" entry in the upgrading-checklist
81 clearer (add "for use by scripts")
82 * Add a dpkg-statoverride description section closes: Bug#89473
83 * Fix the ldconfig usage description (remove "only if")
85 * Clarification of package priority issues vis-a-vis the X Windows
86 system closes: Bug#91249
87 * Enhanced x-terminal-emulator policy closes: Bug#91252
88 * Minor changes to X app-defaults policy closes: Bug#91259
89 * Clarification of X policy in respect to FHS closes: Bug#91260
90 * OpenMotif has the same rules as OSF/Motif closes: Bug#91261
91 * The X Font policy rewrite closes: Bug#91257
92 * The "man" program is no longer guaranteed to read header information
93 to find alternative manpage names closes: Bug#94995
94 * Correction to meaning of Standards-Version closes: Bug#97072
95 * Split section 12.8 (X Window System) into subsections for readability
96 * Plug-ins != shared libraries (at last) closes: Bug#66023
97 * Add packaging manual remnants to policy document as appendices, and
98 mention this in control file closes: Bug#95906
99 * Clarification in Perl policy closes: Bug#98712
101 -- Julian Gilbey <jdg@debian.org> Fri, 1 Jun 2001 10:37:52 +0100
103 debian-policy (3.5.4.0) unstable; urgency=low
105 * [ACCEPTED 2/4/01] /var/mail and /var/spool/mail closes: Bug#42052
106 * [AMENDMENT 26/04/2001] include Perl Policy closes: Bug#83977
107 * Also incorporates all the improvements that Julian has made to to the
108 grammar and flow of the policy manual. The following are mostly
110 * Removed reference to non-extant dpkg documentation
111 * Fixed the confusing self referential language. closes: Bug#85503
112 * Correct ambiguous kanguage about declaring build dependencies.
114 * Improved the woding of the footnote about shlibdeps.
117 -- Manoj Srivastava <srivasta@debian.org> Sat, 28 Apr 2001 13:30:21 -0500
119 debian-policy (3.5.3.0) unstable; urgency=low
121 * Removed recommendation on packaging-manual
122 closes: Bug#86507, #93620, #93705
123 * Also now Conflicts and Replaces packaging-manual
124 * Remove FSSTND from binary package, although retain it in the source
125 package for the time being
126 * Get the version.ent non-compression thingy right this time!
127 * Also install FHS stuff byhand (as requested by webmasters)
128 * Corrected GPL name and location closes: Bug#88788, #93047
129 * Correct bug severities closes: Bug#91276
130 * Correct typos etc. in policy-process
131 * Rename all .text files as .txt
132 * Fixed the "to to" typo in policy closes: Bug#87007
133 * Changed packaging manual ==> dpkg documentation closes: Bug#88651
134 * [ACCEPTED 14/03/2001] Deprecate confusing closes: Bug#87828
135 Build-Depends arch syntax
136 * [AMENDMENT 29/03/2001] Clarification of example closes: Bug#87711
138 * Undo all renaming to text, since the change had not been propogated to
139 the rules file, which broke badly. This shall have to wait for a later
141 * Richard Braakman and Michael Dorman have expressed their resignation
142 from policy maintenance duties.
143 * fixed the date thinko in upgrading checklist. Thanks to Sébastien
144 Montagne <sebastien.montagne@netcourrier.com> closes: Bug#84236
146 -- Manoj Srivastava <srivasta@debian.org> Sun, 15 Apr 2001 13:36:19 -0500
148 debian-policy (3.5.2.0) unstable; urgency=low
150 * Add XFree86 app-defaults ammendment closes: Bug#83069
152 -- Julian Gilbey <jdg@debian.org> Sun, 18 Feb 2001 14:11:49 +0000
154 debian-policy (3.5.1.0) unstable; urgency=low
156 * Removed deprecated virtual package names closes: Bug#84641
157 * Changed rmdir postrm example (suggestion on -policy list)
158 * Removed Richard Braakman from list of maintainers at his request
159 * Corrected typos and grammatical errors found by Sean Perry
160 closes: Bug#85501, #85504, #85505, #85506
161 closes: Bug#85508, #85510, #85511, #85514
162 closes: Bug#84631, #84636, #85497, #85982
163 closes: Bug#85986, #85993, #86001
164 * No longer include the old proposal document closes: Bug#84079
165 * Update footnote about dpkg-shlibdeps now that it uses objdump; bump up
166 minor version number for this
167 * Updated dpkg-shlibdeps example to use up-to-date package names (and
168 correct dpkg-shlibdeps command line syntax)
169 * Clarify error conditions for package installation
170 (Bug#61801 from packaging-manual)
171 * Add the "main" section of each distribution (got left out by
172 accident!) (Bug#64304, #75955 from packaging-manual)
173 * Clean version numbering string (Bug#73064 from packaging-manual)
174 * Install HTML version of FHS closes: Bug#83487
175 * Removed bashism from debian/rules
177 -- Julian Gilbey <jdg@debian.org> Thu, 15 Feb 2001 12:13:00 +0000
179 debian-policy (3.5.0.0) unstable; urgency=low
181 * There have been numerous changes since the last major change, and
182 peole have had tiome now to review the recent changes, so I am
183 updating the policy minor version to reflect the quantity and
184 magnitude of changes since 3.2.1
185 * More spelling corrections, thanks to "Christian T. Steigies"
187 * Added mention of DEB_BUILD_OPTIONS in upgrading checklist.
189 * Fixed some typos. closes: Bug#83960
190 * Policy now mentions preinst scripts. closes: Bug#80342
191 * [AMENDMENT 2000/12/26] allow/document use of Debian Configuration
192 management system (debconf) closes: Bug#80347
193 * Yet more typo fixes closes: Bug#82743
194 * Document the fact that X font utilities have moved to the package
195 xutils closes: Bug#82966
196 * Fixed the date in the virtual package list closes: Bug#83438
197 * Cleaned up some ephemeral informative foornotes of the polic. Thanks
198 to Branden Robinson <branden@debian.org> closes: Bug#83065
199 * Corrected reference to the mime policy. closes: Bug#79891
200 * Corrected reference to the menu policy. closes: Bug#75925
201 * Added a note to the effect that the example make snippet used to
202 illustrate the DEB_BUILD_OPTIONS environment variable is merely
203 informative, and expanded the example to dismiss any confusion about
204 potential failure due to accidentally trying to strip scripts.
207 -- Manoj Srivastava <srivasta@debian.org> Sun, 28 Jan 2001 21:59:16 -0600
209 debian-policy (3.2.1.2) unstable; urgency=low
211 * The minimal change in version number is so that people can test and
212 root out the bugs in this document before we make everyone change to
214 * Document the Enhances relationship
215 * Removed the restriction that one, and exactly one, person must
216 maintain a package. closes: Bug#51879
217 * Fixed a typo, and added the nogroup name, in uid/gid section of
218 policy. closes: Bug#53496
219 * Fixed a misstatement in policy about not needing to depend on packages
220 in the base system (not true -- the Essential tag is significant)
222 * Clarified update-rc.d stuff closes: Bug#55048
224 * We have already included the material for shlibdep changes, and most
225 of this is not relevant to policy anyway. closes: Bug#55730
226 * makedev--> MAKEDEV closes: Bug#57154
227 * Added restrictions on the files in /usr/share/doc/
229 * Changed location of a paragraph about copyright files into the section
230 that deals with copyright files. closes: Bug#65765
231 * init script configuration variables closes: Bug#66912
232 * Clarifed language about packages sharing a conffile need to be marked
233 as conflicting closes: Bug#76028
235 -- Manoj Srivastava <srivasta@debian.org> Thu, 18 Jan 2001 01:43:58 -0600
237 debian-policy (3.2.1.1) unstable; urgency=low
239 * Don't compress version.ent in the doc directory (it gets bigger!)
240 * Incorporate the packaging manual into the policy document. The minimal
241 change in version number is because I suspect that this version is
243 closes: Bug#62943, Bug#72949
244 * Fixed typo in menu-policy. closes: Bug#70442
245 * Fixed typo in policy manual closes: Bug#70634, Bug#70643
246 * Removed extraneous > from policy closes: Bug#77645
247 * Fixed two typos in upgrading checklist closes: Bug#78809, Bug#78822
248 * Fixed spelling of utility closes: Bug#82458
249 * [ACCEPTED 2000/09/08] Free pkgs depending on non-US should go into
250 non-US/{main,contrib} closes: Bug#69229
251 * Added rsh-server and telnet server to the virtual packages list
253 * Fixed outdated references to the FHS. closes: Bug#77650
255 -- Manoj Srivastava <srivasta@debian.org> Tue, 16 Jan 2001 23:53:31 -0600
257 debian-policy (3.2.1.0) unstable; urgency=low
259 * [AMENDMENT 15/01/2000] revision of the "to build with X support or
260 not" policy. closes: Bug#53759
261 * [ACCEPTED 2000/06/06] Must/Should/May in policy This is only a
262 clarifying change, and was not intended to change the intent of
263 policy. closes: Bug#64437
264 * [ACCEPTED 03/05/2000] About the use of conffiles. closes: Bug#61308
265 * [AMENDMENT 10/05/2000] s/mail\.mail/root\.mail/ closes: Bug#62668
266 * [ACCEPTED 04/05/2000] Update for new non-US layout closes: Bug#62946
267 * [ACCEPTED 04/05/2000] s/debian-devel/debian-legal/ closes: Bug#62947
268 * [ACCEPTED 04/05/2000] s/bash/base-files/ closes: Bug#62948
269 * Typo: 1744s/tty/ttyS/ closes: Bug#64516
270 * proposal for mp3-encoder virtual package closes: Bug#64004
271 * proposal for mp3-decoder virtual package closes: Bug#64006
272 * new virtual package time-daemon closes: Bug#69031
273 * [PATCH] typos in menu-policy.sgml closes: Bug#69424
274 * [PATCH] typos and awkwardness in policy.sgml closes: Bug#69426
275 * the example for using nostrip in DEB_BUILD_OPTIONS is
276 incorrect. closes: Bug#69487
277 * [PATCH] more corrections closes: Bug#69670
278 * [AMENDMENT 26/10/99] Amend non-free definition closes: Bug#46522
279 * [AMMENDMENT 29/10/99] /bin/sh needs echo -n closes: Bug#48247
280 * [AMENDMENT 1999/11/23] Clarify meaning of Essential: yes
282 * [ACCEPTED] Request for new virtual packages: rsh-client and
283 telnet-client closes: Bug#58759
285 -- Manoj Srivastava <srivasta@debian.org> Thu, 24 Aug 2000 02:06:30 -0500
287 debian-policy (3.2.0.0) unstable; urgency=low
289 * Fixed bugs in debian-policy package:
290 * We have had doc-base support for a while now. closes: Bug#15709
291 * packaging manual: Added additional clarification on dpkg
292 behaviour. closes: Bug#17369
293 * [PROPOSAL] Do not make hardlinks to conffiles closes: Bug#22935
294 * [PROPOSED]: clarification needed about diversions.
295 fixed usage for dpkg-divert closes: Bug#29522
296 * [OLD PROPOSAL] debian-policy has an unclear statement
297 on dependancies and priorities closes: Bug#39398
298 * [ACCEPTED 10/26/99] changelog.html.gz sanitization. closes: Bug#40934
299 * [AMENDED 07/09/1999] policy on -g, a proposal closes: Bug#43787
300 * Fixed missing </chapt> tag. closes: Bug#51091
301 * Correct typo in section 2.3.5 closes: Bug#52225
302 * Documented that the library before the symlink hack
303 (which dependend on file system specific kinks to work)
304 is no longer required by newer versions of dpkg. closes: Bug#53405
305 * [ACCEPTED 02/01/2000] policy for usage of "xserver"
306 alternative closes: Bug#53755
307 * [ACCEPTED 02/01/2000] additions to virtual package
308 list closes: Bug#53756
309 * [ACCEPTED 02/01/2000] policy for "x-terminal-emulator"
310 virtual package and alternative closes: Bug#53757
311 * [ACCEPTED 02/01/2000] policy for "x-window-manager"
312 virtual package and alternative closes: Bug#53758
313 * [ACCEPTED 02/01/2000] revision of X application-defaults
314 policy closes: Bug#53760
315 * [ACCEPTED 02/01/2000] revision of the Motif/LessTif
316 policy closes: Bug#53761
317 * [ACCEPTED 02/01/2000] applying the FHS to packages
318 that use X closes: Bug#53762
319 * [ACCEPTED 02/01/2000] policy for X font packages closes: Bug#53763
320 * Moved the documents into the Debian/ section, since
321 that is where they belong, really. closes: Bug#54777
322 * Fixed the ftp location in the manuals. closes: Bug#56407
323 * Fixed missing urlname entity in the sgml docs (where
324 was it defined before anyway?) closes: Bug#56692
325 * Fixed bugs in packaging-manual package:
326 * Fixed typo where dpkg-genchanges was used instead of
327 dpkg-gencontrol. closes: Bug#58771
329 * Added policy-process to document current procedures.
330 * Added a dependency on fileutiles >=4.0, since the package would fail
331 to install with older fileutils.
332 * Installed FHS version 2.1
333 * Policy recommends packaging manual and vice versa
334 * Added FHS details to copyright file
335 * Updaed the upgrade checklist. Minor changes to the ./debian/rules
337 * Added footnotes in the packaging manual warning about the upcoming
338 dpkg-shlibdeps change as in Bug#55730
340 -- Manoj Srivastava <srivasta@debian.org> Sun, 30 Jul 2000 17:43:02 -0500
342 debian-policy (3.1.1.3) unstable; urgency=low
344 * Fixed an upgrade bug when /usr/doc happens to be a symlink, and does
345 not point to /usr/share/doc. A couple of people were bitten by this.
347 -- Manoj Srivastava <srivasta@debian.org> Mon, 28 Feb 2000 22:27:05 -0600
349 debian-policy (3.1.1.2) unstable; urgency=low
351 * Correct missing </chapt> in packaging.sgml (closes: #51091)
352 * Correct typo in policy 2.3.5 (closes: #52225)
354 -- Julian Gilbey <jdg@debian.org> Mon, 20 Dec 1999 20:39:57 +0000
357 debian-policy (3.1.1.1) unstable; urgency=low
359 * Correction to typo in packaging manual, section 6.2.
360 * Correction to typo in packaging manual, section 12.2.5 (closes:
362 * More corrections to packaging manual typos (closes: #50857)
364 -- Julian Gilbey <jdg@debian.org> Mon, 22 Nov 1999 19:23:31 +0000
366 debian-policy (3.1.1.0) unstable; urgency=low
368 * Correct description of negated architectures in Build-Depends
369 description in Packaging manual (closes: #49901)
371 -- Julian Gilbey <jdg@debian.org> Tue, 16 Nov 1999 15:03:48 +0000
373 debian-policy (3.1.0.0) unstable; urgency=low
375 * Add instructions on /usr/doc -> /usr/share/doc symlinks (closes:
376 #45561, #42447, #48570)
377 * Added source dependencies (closes: #41232)
378 * Deprecated /etc/rc.boot (closes: #32448, #32449)
379 * Update-rc.d now only legal way to automatically access /etc/rc?.d
380 directoried (closes: #41547)
381 * FHS compliant location of examples (closes: #42849)
382 * Added ispell-dictionary to virtual-packages.list (following new
383 suggestions: no objections => accept) (closes: #8221)
384 * Added man-browser to virtual-packages.list (closes: #24695)
385 * Added ident-server to virtual-packages.list (closes: #45307)
386 * Alphabeticised virtual packages list ;)
387 * Corrected GPL reference in proposal.sgml
388 * Clarification of "extra" priority (closes: #33076)
389 * Remove buggy and seriously problematic licenses from list of contrib
390 package criteria (closes: #45318)
391 * Move docs to /usr/share/doc with a compatibility symlink (closes:
393 * Update to FHS 2.1 draft #3 (for /var/state etc. changes).
394 * Correct /var/lib/games -> /var/games (closes: #42358)
395 * Added MIME subpolicy (closes: #46516)
396 * Added support for VISUAL (closes: #41121)
397 * Clarify non-dependence on /usr/local (closes: #44922)
398 * Modified description of mail spool locking (closes: #43651)
399 * Clarified wording of conffiles and configuration files (closes:
401 * Changed description of release numbers (closes: #44620)
402 * Added changelog.html -> changelog requirement (closes: $40934)
403 * packaging-manual now correctly installs its docs (closes: #44643)
404 * The packaging manual now discusses version numbers based on dates
406 * Mention ls -f for testing order in which files appear on disk (closes:
408 * Change order of '.' and '+' in description of version numbers (closes:
410 * s/fields/field names/ in section 4.1 of packaging manual for clarity
411 * Add Build-Depends-Indep: field to control file
413 -- Julian Gilbey <jdg@debian.org> Thu, 4 Nov 1999 23:50:37 +0000
415 debian-policy (3.0.1.1) unstable; urgency=low
417 * Typo corrected in packaging manual. closes: Bug#40180
418 * Chnaged rules file to create ps and pdf files.
420 -- Manoj Srivastava <srivasta@debian.org> Mon, 16 Aug 1999 01:21:09 -0500
422 debian-policy (3.0.1.0) unstable; urgency=low
424 * A few typos and omissions corrected
425 * Added the pop3-server to the virtual packages list, as decided on the
427 * Fix the self reference to a location on the web site. closes: Bug#39408
428 * Added the clarification that the .la files are essential for the
429 packages using libtool's libltdl library, in which case the
430 .la files must go in the run-time library package. (this is why this
431 is version 3.0.1.0, and not 3.0.0.1)
432 * The virtual package list has new directions (this has been true for a
433 while, I am just closing the bug now). closes: Bug#26159
434 * Since this package now contains the FHS, this closes: Bug#25533
435 * The General resolution prototcol handling of the logos closes: Bug#26915
436 * Inclusion of the Menu policy in the main policy document closes: Bug#30036
437 * Since proposal submitting guidelines are now in the policy package,
438 this closes: Bug#38612
439 * Changed a /usr/doc reference to /usr/share/doc which had beeen missed
440 before. closes: Bug#40864
442 -- Manoj Srivastava <srivasta@debian.org> Thu, 15 Jul 1999 13:35:11 -0500
444 debian-policy (3.0.0.0) unstable; urgency=low
446 * This is a test version of the policy package, and shall not be
448 * Merged in the packaging manual sources (we still have two separate
450 * Multiple minor packaging tweaks.
451 * [ACCEPTED 1998/05/01] Policy clarification about Standards-Version
452 Added the clarifying paragraph (and the rationale in a footnote).
454 * [ACCEPTED 1999/04/05] Policy note that GPL moved to
455 /usr/share/common-licenses. Again, also added the rationale as a
456 footnote. closes: Bug#28747
457 * [ACCEPTED 1999/05/04] Libtool archive (*.la) files in -dev' packages
458 closes: Bug#37257, Bug#37338
459 * [ACCEPTED 1999/04/28] Logrotation. Standardizer on logrotate.
461 * [ACCEPTED 1999/05/23] Rewrite of section 5.7 (Programs for the X
462 Window System) closes: Bug#38212
463 * [ACCEPTED 1999/05/15] Separate menu policy (like virtual package list)
465 * [ACCEPTED 1999/05/09] Utmp group proposal
467 * [ACCEPTED 1999/05/09] Adopt the FHS in place of FSSTND
468 Changed all references to the proper FHS versions. This was a first
469 scan, so some references may still need to be changed. closes: Bug#37345
470 * Updated the upgrading checklist.
471 * updated the proposal for policy update to reflect the latest
473 -- Manoj Srivastava <srivasta@debian.org> Wed, 30 Jun 1999 22:49:15 -0500
475 debian-policy (2.5.1.0) unstable; urgency=low
477 * Removed double '>' marks from the policy document. closes: Bug#35095
478 * Corrected canonical source for "Csh Programming Considered Harmful"
479 closes: Bug#36286 Bug#32499
480 * Fixed typo in invocation of update-rc.d. closes: Bug#34988 Bug#34543
481 * Fixed misspelling of accessible. Ran ispell over the rest of the
482 document (painful because of the large number of technical terms in
483 there). closes: Bug#34233
484 * Make the binary package contain the version.ent as well. closes: Bug#31033
485 * Fixed typo s/as is/is/. closes: Bug#30302
486 * AMENDMENT 23/04/1999: changed /etc/nntpserver recommendation to
487 /etc/news/server. closes: Bug#21875
488 * Added the current list of policy maintainers. closes: Bug#30148
490 -- Manoj Srivastava <srivasta@debian.org> Tue, 27 Apr 1999 11:10:29 -0500
492 debian-policy (2.5.0.0) unstable; urgency=low
494 * AMENDMENT: Added in changes in Bug #25911, which rearranged sections
495 to create a new section 4, namely, files. Section 3.3 ("Files") should
496 become Section 4. The Sections that are currently Section 4 and
497 Section 5 should be moved down to become Section 5 and Section 6
500 What is now Section 5.5 ("Log files") should be moved to be a
501 subsection of the new Section 4 ("Files"), becoming section 4.8,
502 placing it after "Configuration files", moving the would-be Section
503 4.8 ("Permissions and owners") to Section 4.9. All subsections of the
504 current Section 5 after 5.5 should be accordingly moved down to fill
507 This, along with the next amendment, justifies bumping up the version
508 number. closes: BUG#25911
510 * AMENDMENT: Added in changes in Bug #21185, about the naming and
511 compression of changelog files. Now, if the upstream changelog file is
512 HTML formatted, it should be accessible as
513 /usr/doc/<package>/changelog.html.gz It also allows for this to be a
514 symlink, if the upstream file name does not conform to Debian
515 conventions. closes: BUG#21185
517 * AMENDMENT: Added in changes in Bug #7890, to make clear that the HTML
518 documents should be supplied in _some_ package, not necessarily in the
519 main binary package (at the discretion of the maintainer).
522 * AMENDMENT: Added in changes in Bug #26461, which corrects the policy
523 to refer to /usr/doc/<package>/copyright, rather than
524 /usr/doc/copyright/<package>. closes: BUG#26461
526 * AMENDMENT: Added in changes in Bug #25385, which allow the
527 architecture specification strings to be of the form <arch>-<os>,
528 where os is one of linux, gnu. Previously, only linux was allowed, now
529 we also cater to the hurd. closes: BUG#25385
531 * The responsibility of the contents of this package has now passed to
532 the debian-policy mailing list. The packaging details are now being
533 managed by a group of maintainers that do ot won the contents.
535 * Make the package optional, not extra.
537 * Re did the SGML markup. Normalized the document, and undid the omitted
538 and shor tags. Personally, I use too many DTD's in real life to be so
539 converssant with each one to be clever with tag omissions, and, since
540 I have a smart editor, omitting tags does not byuy one much. In the
541 process, I discovered a few errors in the markup (one of my
542 predecessors hasd the unfortunate habit of treating <p> as a "create
543 some space here" tag, and more often than not put it at the end of a
544 paragraph, rather than using is as a container element (which is what
547 * Re did the control files, making them more robust
549 * re did the rules file, making it more general, and easier to maintain
550 by putting in a layer of abstractions.
553 -- Manoj Srivastava <srivasta@debian.org> Thu, 29 Oct 1998 15:16:52 -0600
555 debian-policy (2.4.1.4) unstable; urgency=low
557 * New Maintainer <debian-policy@lists.debian.org>
559 -- Philip Hands <phil@hands.com> Sat, 5 Sep 1998 02:41:35 +0100
561 debian-policy (2.4.1.3) unstable; urgency=low
563 * New maintainer (with changes from Adam P. Harris' proposed NMU)
564 * policy.sgml: some awkward phrasings fixed (closes Bug#22006)
565 * policy.sgml: s/depreciated/deprecated (closes Bug#21831)
566 * debian/control: added conflict doc-base (<< 0.6), which I still am not
567 sure why we need this but hey (closes Bug#21554)
568 * policy.sgml: use new <url> tag where appropriate
569 * policy.sgml, debian/control: always dynamically self reference the
570 current version of policy, that is, do not hard code policy revision
572 * debian/rules: use dpkg-gencontrol -isp
573 * bugs fixed in some unknown previous version (closes Bug#23177)
575 -- Philip Hands <phil@hands.com> Tue, 11 Aug 1998 09:54:17 +0100
577 debian-policy (2.4.1.2) frozen unstable; urgency=low
579 * non-maintainer release
580 * rebuild package to fix truncated Chapter 3 (Bug#23408, not marked as
581 important but should be, since a gaping hole in policy is very
583 * bumped version of policy, within the document, to this version number,
584 but not the date, indicating nothing really changed since then
586 * debian/rules: clean is a little cleaner
588 -- Adam P. Harris <aph@debian.org> Tue, 16 Jun 1998 03:15:22 -0400
590 debian-policy (2.4.1.1) frozen unstable; urgency=low
594 -- Christian Schwarz <schwarz@debian.org> Thu, 14 May 1998 21:54:50 +0200
596 debian-policy (2.4.1.0) frozen unstable; urgency=low
598 * Changes to the Debian Policy Manual:
600 - Updated section 3.1.2 Site-specific programs
601 and section 3.8 Keyboard configuration:
602 + improved wording (fixes:bug#20129)
604 - Updated section 2.1.7 Subsections:
605 + fixed typos (fixes:bug#18145)
607 - Updated section 3.3.5 Symbolic links:
608 + symbolic links within a toplevel directory should be relative,
609 symbolic links between toplevel directories should be absolute
610 (cf., Policy Weekly Issue#6, topic 2)
612 - Updated section 3.4 System run levels:
613 + Intro: mention /etc/rcS.d (links to boot time scripts)
614 + Notes: include rationale why /etc/init.d scripts have to be tagged
615 as conffiles (fixes:bug#16199)
616 + Example: changed example init.d script to handle force-reload
617 and restart options and to comply with the console message
618 standard (fixes:bug#19216)
620 - Updated section 4.8 Emacs lisp programs:
621 + Replaced old section about lisp programs with a reference to
622 the file debian-emacs-policy.gz, installed by the emacsen-common
625 - Updated section 4.9 Games:
626 + manpages for games should be installed in /usr/man/man6
627 (cf., Policy Weekly Issue#6, topic 3)
629 - Removed one example reference to the current standards version
630 - Include manual's date as plain text in the .sgml source so that
631 a recompiled manual uses the same release date
633 * Changes to the authoritative list of virtual package names:
634 - Removed obsolete virtual package `emacs'
636 * New version numbering scheme:
638 - The version numbers are independent of dpkg now, but all policy
639 manuals (the Debian Policy Manual, the Debian Packaging Manual, and
640 the Debian Developer's Reference) share the same version numbering
643 - The first three digits of the version number specify the
644 `Standards-Version.' This number is incremented with each policy
645 change. The fourth digit represents the `patch-level,' which may
646 differ between the manuals.
648 If only the patch-level digit is incremented, no changes in policy
649 have been made, except bug fixes and clarifications. Packages only
650 have to specify the first three digits of the version number in the
651 `Standards-Version' field of their source packages.
655 - Uploaded to frozen and unstable. This is a documentation-only
656 package and the changes to the manual are relevant for hamm.
658 - Fixed FSF's address in copyright file (detected by Lintian)
660 -- Christian Schwarz <schwarz@debian.org> Tue, 14 Apr 1998 10:08:09 +0200
662 debian-policy (2.4.0.0) unstable; urgency=low
664 * Changes to the Debian Policy Manual:
666 - Updated section 3.3.4 Scripts:
667 + /bin/sh may be any POSIX compatible shell
668 + scripts including bashisms have to specify /bin/bash as
670 + scripts which create files in world-writable directories
671 (e.g., in /tmp) should use tempfile or mktemp for creating
674 - Updated section 3.3.5 Symbolic Links:
675 + symbolic links referencing compressed files must have the same
676 file extension as the referenced file
678 - Updated section 3.3.6 Device files:
679 + /dev/tty* serial devices should be used instead of /dev/cu*
681 - Updated section 3.4.2 Writing the scripts [in /etc/init.d]:
682 + all /etc/init.d scripts have to provide the following options:
683 start, stop, restart, force-reload
684 + the reload option is optional and must never stop and restart
687 - Updated section 3.5 Cron jobs:
688 + cron jobs that need to be executed more often than daily should
689 be installed into /etc/cron.d
691 - Updated section 3.7 Menus:
692 + removed section about how to register HTML docs to `menu'
693 (the corresponding section in 4.4, Web servers and applications,
694 has been removed in policy 2.2.0.0 already, so this one was
697 - New section 3.8 Keyboard configuration:
698 + details about how the backspace and delete keys should be
701 - New section 3.9 Environment variables:
702 + no program must depend on environment variables to get a
703 reasonable default configuration
705 - New section 4.6 News system configuration:
706 + /etc/news/organization and /etc/news/server should be supported
707 by all news servers and clients
709 - Updated section 4.7 Programs for the X Windows system:
710 + programs requiring a non-free Motif library should be provided
711 as foo-smotif and foo-dmotif package
712 + if lesstif works reliably for such program, it should be linked
713 against lesstif and not against a non-free Motif library
715 - Updated section 4.9 Games:
716 + games for X Windows have to be installed in /usr/games, just as
719 - Lots of typos fixed (thanks to Ray Dassen for the patch!)
721 * Changes to the authoritative list of virtual package names:
722 - added `libc-dev' and `emacsen'
724 * Merged `/usr/doc/debian-policy/changelog-policy.gz' into this
727 * Included `Policy checklist for upgrading your packages' from the
728 Policy Home Page as /usr/doc/debian-policy/upgrading-checklist.text.gz
730 * Added support for doc-base to register the Policy Manual to the
731 online documentation systems dwww and dhelp (fixes:#15710)
733 * Upgraded to standards version 2.4.0.0 (no changes)
735 -- Christian Schwarz <schwarz@debian.org> Fri, 30 Jan 1998 21:58:25 +0100
737 debian-policy (2.3.0.1) unstable; urgency=low
739 * Changes in the Debian Policy Manual:
740 - X library package is now called xlib6g
741 * Changes in the authoritative list of virtual package names:
742 - Added emacs, c-compiler, fortran77-compiler, lambdamoo-core,
744 * Conflict with old dpkg-dev version that included policy manual
746 * Removed `tentative-opt-draft' from package since people considered
747 the draft official policy (which is not the case)
748 * Don't use debstd anymore
750 -- Christian Schwarz <schwarz@debian.org> Tue, 21 Oct 1997 23:03:52 +0200
752 debian-policy (2.3.0.0) unstable; urgency=low
754 * Changes in the Debian Policy Manual:
755 - reworked chapter `The Debian Archive' to cover new
756 contrib/non-free policy
757 - call "contrib" and "non-free" a `section' (not `distribution')
758 - refer to license files (GPL, LGPL, etc.) as uncompressed files
759 - changed `/etc/news/server' into `/etc/nntpserver' in example of
760 maintainer scripts (fixes #11517)
761 - new section about `Daemons'
762 - updated section about `Configuration files'
763 - MUAs and MTAs have to use liblockfile
764 - fixed typos and grammatical errors
765 * Changes in the authoritative list of virtual package names:
766 - renamed tcl/tk virtual package names to `tclsh' and `wish'
767 * Paper about libc6 migration:
768 - fixed typos (fixes #11641), thanks to James Troup for the patch!
769 * SGML source code included in package
770 * don't use `2-up' style for PostScript version (fixes #11095)
772 -- Christian Schwarz <schwarz@debian.org> Mon, 2 Sep 1997 00:54:31 +0200
774 debian-policy (2.2.0.0) unstable; urgency=low
776 * Changes in the Debian Policy Manual:
777 - completely reworked structure
778 - moved sections about new maintainers, upload procedure, interim
779 releases, and mailing lists into the Developers Reference Manual
780 - moved a few (small) sections into the Debian Packaging Manual
781 - removed all those ugly footnotes
782 - new example for "reload" in section about console messages
783 - mention Artistic License (fixes #9793)
784 - don't mention dpkg's version number in Policy Manual
785 - rewrote abstract and section introductions
786 - mention "orphaned packages"
787 - maintainer is responsible for a package license to comply with the
788 distributions' policy
789 - putting a package into base section requires discussion on debian-devel
790 - rewrote sections about "pre-depends", "essential" and, "base" packages
791 - added note that non-us' maintainers have to live outside the US
792 - added crypto-hook statement (fixes #7257)
793 - added section about arch spec strings
794 - rewrote section about "Site specific programs" (/usr/local)
795 - included Ian's suggestions for user IDs
796 - added section about "menus"
797 - removed section about "web menus" since this will be superseded with
798 the new documentation policy soon
799 - incorporated "Debian Free Software Guidelines" (fixes #9024)
800 - removed note that linking with -g produces large a.out binary (fixes
802 - added section about editors and pagers
803 - added note about Package priorities and dependencies
804 - added section about cron jobs (fixes #8814)
805 - added section about device files
806 - don't install shared libraries as executable (fixes #7129)
807 - app-defaults files may not be conffiles (cf. #2717)
808 - lots of minor changes not worth mentioning here (typos, formulations,
810 * Changes in the authoritative list of virtual package names
811 - Removed obsolete virtual packages: xR6shlib, xlibraries,
812 compress, emacs, sgmls, inews, gs_x, gs_svga, gs_both, xpmR6
813 - Added new section about obsolete names
814 * Added Helmut Geyer's paper about libc5-libc6 migration
815 * Fixed package's description
817 -- Christian Schwarz <schwarz@debian.org> Sun, 13 Jul 1997 13:25:51 +0200
819 debian-policy (2.1.3.3) frozen unstable; urgency=low
821 * Mention Artistic License in section 2.5 (bug #9755)
823 -- Christian Schwarz <schwarz@debian.org> Wed, 14 May 1997 16:53:15 +0200
825 debian-policy (2.1.3.2) frozen unstable; urgency=low
827 * Fixed an email address, an URL, and several typos in chapter 6 (#9358)
828 * Added new virtual package "wordlist" to list (requested by Joey Hess)
829 * Changed wording in section about "non-free" packages as suggested
830 by Kai Henningsen (#7076)
832 -- Christian Schwarz <schwarz@debian.org> Mon, 5 May 1997 20:05:39 +0200
834 debian-policy (2.1.3.1) frozen unstable; urgency=low
836 * Fixed bug in chapter 7: `-ur' should read `-us' (#8874)
837 * Fixed bug in chapter 7: `-rwhatever' also needed for rebuild (#8874)
838 * Create a PS and HTML version of the Policy Manual and upload it
840 * Install virtual-package-names-list.text in /usr/doc/debian-policy
841 and upload it "byhand" too.
843 -- Christian Schwarz <schwarz@debian.org> Tue, 29 Apr 1997 18:02:14 +0200
845 debian-policy (2.1.3.0) unstable; urgency=low
848 * New Policy Manager: Christian Schwarz <schwarz@debian.org>
849 * Added section 2.4 about the "non-us" distribution.
850 * Added section 3.1.1 about the "Package" field in the control file.
851 * Added section 3.2.1 about "Binaries": two programs with different
852 functionality must not have the same name.
853 * Changed headline of section 3.2.6 into "Debian changelog and upstream
854 changelog" as suggested by Santiago Vila Doncel <sanvila@unex.es>.
855 * Added log-rotating example to section 3.2.9 that tests with `-sf',
856 as suggested by Boris D. Beletsky <borik@isracom.co.il>.
857 * Added section 3.13: "Webstandard 3.0" by Christoph Lameter.
858 * Added section 3.14: "Standard for Console Messages" by Christian Schwarz.
859 * Split section 4.1 into 4.1.1 (Options for binaries) and 4.1.2 (Options
861 * Added note to 4.1.2: Libraries should be compiled with `-D_REENTRANT'
862 to make them compatible with LinuxThreads, by Rob Browning
863 <osiris@cs.utexas.edu>.
864 * Added note to 4.1.2: Libraries should be stripped with
865 "strip --strip-unneeded", by Guy Maor <maor@ece.utexas.edu>.
866 * Section 5.2: Policy changelog is now
867 "/usr/doc/debian-policy/changelog-policy.gz". This fixes bug #6130.
868 * Section 6.2 renamed to "Uploading your first Debian package". This
871 -- Christian Schwarz <schwarz@debian.org> Sat, 15 Mar 1997 18:08:56 +0100
873 debian-manuals (2.1.2.2) frozen unstable;
875 * Fixed even more typographical and grammatical errors in Policy and
877 * Corrected the contact email addresses again.
878 * Added a paragraph to Policy 6.3 on taking over an old package (Guy Maor)
879 * Added a paragraph to Programmer 4.2.14 on listing distributions to load
880 a package into. (Guy Maor)
881 * Further clarification of use of absolute pathnames in scripts in
884 -- David Morris <bweaver@worf.netins.net> Tue, 3 Dec 1996 23:28:04 -0600
886 debian-manuals (2.1.2.1) frozen unstable;
888 * Many editorial and formatting revisions with suggestions from Ian Jackson,
890 * correction of chiark address in Policy 6.2
891 * footnote in Programmers chapter 2 pointing to deb(5) manpage for
892 description of deb file format.
893 * addition of more dpkg examples in Programmer chapter 2
894 * Replace paragraph in Policy 4.1 outlining compiling parameters for
896 * Added paragraph in Programmer 6.1 on paths in maintainer scripts
898 * Cleaned up language and formatting of Programmer's 12.2, shlibs
899 * Corrected contact addresses for listmaster and override-change
901 -- David Morris <bweaver@worf.netins.net> Wed, 27 Nov 1996 08:17:16 -0600
903 debian-manuals (2.1.2.0) frozen unstable;
905 * Mostly editorial changes in Policy Manual.
906 * Added summary of distribution criteria to Introduction
907 * Added section headings for copyright criteria
908 * Fixed typos (Bugs #4485, #4622)
909 * Added paragraph in Compilation Options related to use of shared and
910 static libraries. (Bug #5299)
911 * Paragraph added about where to find PGP and other export restricted
912 packages in section on Procedure
913 * Change in List administrator and in the contact address for becoming
915 * A paragraph added related to who to contact for package maintainer changes.
916 * Changed where to send upload announcements: uploads destined for unstable,
917 frozen, or experimental go to debian-devel-changes.
919 * Made some mostly editorial changes to Programmers Manual.
920 * Added a recommendation to debmake in Introduction.
921 * A further interpretation of the various Distributions is added with
922 the intent of helping people decide which one to choose. (section 4.2.14)
923 * Section 12 on Shared Libraries expanded with further technical information
924 on various shlib files
925 * Section in 2.2 on format of shlib file moved to new subsection within 12.
926 * Paragraph on adding a symlink without version number added to Shared
927 Library Section (Guy Maor, Bug #5299)
929 -- David Morris <bweaver@worf.netins.net> Fri, 22 Nov 1996 23:41:39 -0600
931 debian-manuals (2.1.1.0) unstable;
933 * Hard links are forbidden in source packages (they didn't work anyway,
934 and can't easily be made to work reliably).
935 * Do not use dpkg-divert or update-alternatives without consultation.
937 * Do not need to declare dependencies on Essential packages.
938 * Restrictions on Pre-Depends stated in policy manual.
939 * debian/substvars file is now almost always auto-generated.
940 * Shared libraries must be installed stripped.
941 * Essential and Pre-Depends put together in policy manual.
943 * Explained component-wise (file-wise) vs. package-wise dependencies.
945 -- Ian Jackson <ian@chiark.greenend.org.uk> Thu, 12 Sep 1996 01:00:41 +0100
947 debian-manuals (2.1.0.0) unstable;
949 * Upstream changelog must be installed too (was just recommended).
951 * Modification to use dpkg-shlibdeps added to conversion instructions.
952 * Packages which are buggy and orphaned but which are preserved for
953 compatibility go in contrib.
955 * Programmers' manual source package section refers to conversion
956 instructions in policy manual.
957 * Make it clear that recommending a non-free or contrib package puts a
960 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sun, 1 Sep 1996 17:47:18 +0100
962 debian-manuals (2.0.1.0) unstable;
964 * varargs.h and libtermcap are obsolete - use stdarg.h and ncurses.
965 * Shared library link/library ordering corrected (aargh).
966 * When to byte-compile Elisp files.
967 * Missing final newlines not represented by dpkg-source.
969 * Must post upload announcements to debian-changes.
970 * Moved some sections into new `configuring and building' chapter.
973 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sat, 31 Aug 1996 20:07:22 +0100
975 debian-manuals (2.0.0.0) unstable;
977 * Footnote added OK'ing copyrights which require name changes.
978 * More detail about changelog format names.
980 * Problematic licence restrictions are formatted as lists.
981 * Mentioned 822-date utility as way to generate RFC822 format dates.
985 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Mon, 26 Aug 1996 14:27:34 +0100
987 debian-manuals (0.2.1.1) unstable;
989 * Can't overwrite directories in one package with files in another.
991 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sat, 24 Aug 1996 18:44:54 +0100
993 debian-manuals (0.2.1.0) unstable;
995 * Policy says when and how to include original source in upload.
997 * Need -sa on dpkg-genchanges/dpkg-buildpackage when converting.
999 * Use minor patchlevel for meaning changes which don't affect packages.
1000 * More verbosity about netiquette.
1001 * Reorganised participation and upload policy: merged with mailing lists.
1003 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Fri, 23 Aug 1996 12:48:09 +0100
1005 debian-manuals (0.2.0.1) experimental;
1007 * Said that system administrators' manual does not exist.
1009 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Fri, 23 Aug 1996 04:05:36 +0100
1011 debian-manuals (0.2.0.0) experimental;
1015 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Wed, 21 Aug 1996 15:07:53 +0100