1 debian-policy (3.0.1.0) unstable; urgency=low
3 * A few typos and omissions corrected
4 * Added the pop3-server to the virtual packages list, as decided on the
6 * Fix the self reference to a location on the web site. closes: Bug#39408
7 * Added the clarification that the .la files are essential for the
8 packages using libtool's libltdl library, in which case the
9 .la files must go in the run-time library package. (this is why this
10 is version 3.0.1.0, and not 3.0.0.1)
12 -- Manoj Srivastava <srivasta@debian.org> Thu, 1 Jul 1999 14:48:25 -0500
14 debian-policy (3.0.0.0) unstable; urgency=low
16 * This is a test version of the policy package, and shall not be
18 * Merged in the packaging manual sources (we still have two separate
20 * Multiple minor packaging tweaks.
21 * [ACCEPTED 1998/05/01] Policy clarification about Standards-Version
22 Added the clarifying paragraph (and the rationale in a footnote).
24 * [ACCEPTED 1999/04/05] Policy note that GPL moved to
25 /usr/share/common-licenses. Again, also added the rationale as a
26 footnote. closes: Bug#28747
27 * [ACCEPTED 1999/05/04] Libtool archive (*.la) files in -dev' packages
28 closes: Bug#37257, Bug#37338
29 * [ACCEPTED 1999/04/28] Logrotation. Standardizer on logrotate.
31 * [ACCEPTED 1999/05/23] Rewrite of section 5.7 (Programs for the X
32 Window System) closes: Bug#38212
33 * [ACCEPTED 1999/05/15] Separate menu policy (like virtual package list)
35 * [ACCEPTED 1999/05/09] Utmp group proposal
37 * [ACCEPTED 1999/05/09] Adopt the FHS in place of FSSTND
38 Changed all references to the proper FHS versions. This was a first
39 scan, so some references may still need to be changed. closes: Bug#37345
40 * Updated the upgrading checklist.
41 * updated the proposal for policy update to reflect the latest
43 -- Manoj Srivastava <srivasta@debian.org> Wed, 30 Jun 1999 22:49:15 -0500
45 debian-policy (2.5.1.0) unstable; urgency=low
47 * Removed double '>' marks from the policy document. closes: Bug#35095
48 * Corrected canonical source for "Csh Programming Considered Harmful"
49 closes: Bug#36286 Bug#32499
50 * Fixed typo in invocation of update-rc.d. closes: Bug#34988 Bug#34543
51 * Fixed misspelling of accessible. Ran ispell over the rest of the
52 document (painful because of the large number of technical terms in
53 there). closes: Bug#34233
54 * Make the binary package contain the version.ent as well. closes: Bug#31033
55 * Fixed typo s/as is/is/. closes: Bug#30302
56 * AMENDMENT 23/04/1999: changed /etc/nntpserver recommendation to
57 /etc/news/server. closes: Bug#21875
58 * Added the current list of policy maintainers. closes: Bug#30148
60 -- Manoj Srivastava <srivasta@debian.org> Tue, 27 Apr 1999 11:10:29 -0500
62 debian-policy (2.5.0.0) unstable; urgency=low
64 * AMENDMENT: Added in changes in Bug #25911, which rearranged sections
65 to create a new section 4, namely, files. Section 3.3 ("Files") should
66 become Section 4. The Sections that are currently Section 4 and
67 Section 5 should be moved down to become Section 5 and Section 6
70 What is now Section 5.5 ("Log files") should be moved to be a
71 subsection of the new Section 4 ("Files"), becoming section 4.8,
72 placing it after "Configuration files", moving the would-be Section
73 4.8 ("Permissions and owners") to Section 4.9. All subsections of the
74 current Section 5 after 5.5 should be accordingly moved down to fill
77 This, along with the next amendment, justifies bumping up the version
78 number. closes: BUG#25911
80 * AMENDMENT: Added in changes in Bug #21185, about the naming and
81 compression of changelog files. Now, if the upstream changelog file is
82 HTML formatted, it should be accessible as
83 /usr/doc/<package>/changelog.html.gz It also allows for this to be a
84 symlink, if the upstream file name does not conform to Debian
85 conventions. closes: BUG#21185
87 * AMENDMENT: Added in changes in Bug #7890, to make clear that the HTML
88 documents should be supplied in _some_ package, not necessarily in the
89 main binary package (at the discretion of the maintainer).
92 * AMENDMENT: Added in changes in Bug #26461, which corrects the policy
93 to refer to /usr/doc/<package>/copyright, rather than
94 /usr/doc/copyright/<package>. closes: BUG#26461
96 * AMENDMENT: Added in changes in Bug #25385, which allow the
97 architecture specification strings to be of the form <arch>-<os>,
98 where os is one of linux, gnu. Previously, only linux was allowed, now
99 we also cater to the hurd. closes: BUG#25385
101 * The responsibility of the contents of this package has now passed to
102 the debian-policy mailing list. The packaging details are now being
103 managed by a group of maintainers that do ot won the contents.
105 * Make the package optional, not extra.
107 * Re did the SGML markup. Normalized the document, and undid the omitted
108 and shor tags. Personally, I use too many DTD's in real life to be so
109 converssant with each one to be clever with tag omissions, and, since
110 I have a smart editor, omitting tags does not byuy one much. In the
111 process, I discovered a few errors in the markup (one of my
112 predecessors hasd the unfortunate habit of treating <p> as a "create
113 some space here" tag, and more often than not put it at the end of a
114 paragraph, rather than using is as a container element (which is what
117 * Re did the control files, making them more robust
119 * re did the rules file, making it more general, and easier to maintain
120 by putting in a layer of abstractions.
123 -- Manoj Srivastava <srivasta@debian.org> Thu, 29 Oct 1998 15:16:52 -0600
125 debian-policy (2.4.1.4) unstable; urgency=low
127 * New Maintainer <debian-policy@lists.debian.org>
129 -- Philip Hands <phil@hands.com> Sat, 5 Sep 1998 02:41:35 +0100
131 debian-policy (2.4.1.3) unstable; urgency=low
133 * New maintainer (with changes from Adam P. Harris' proposed NMU)
134 * policy.sgml: some awkward phrasings fixed (closes Bug#22006)
135 * policy.sgml: s/depreciated/deprecated (closes Bug#21831)
136 * debian/control: added conflict doc-base (<< 0.6), which I still am not
137 sure why we need this but hey (closes Bug#21554)
138 * policy.sgml: use new <url> tag where appropriate
139 * policy.sgml, debian/control: always dynamically self reference the
140 current version of policy, that is, do not hard code policy revision
142 * debian/rules: use dpkg-gencontrol -isp
143 * bugs fixed in some unknown previous version (closes Bug#23177)
145 -- Philip Hands <phil@hands.com> Tue, 11 Aug 1998 09:54:17 +0100
147 debian-policy (2.4.1.2) frozen unstable; urgency=low
149 * non-maintainer release
150 * rebuild package to fix truncated Chapter 3 (Bug#23408, not marked as
151 important but should be, since a gaping hole in policy is very
153 * bumped version of policy, within the document, to this version number,
154 but not the date, indicating nothing really changed since then
156 * debian/rules: clean is a little cleaner
158 -- Adam P. Harris <aph@debian.org> Tue, 16 Jun 1998 03:15:22 -0400
160 debian-policy (2.4.1.1) frozen unstable; urgency=low
164 -- Christian Schwarz <schwarz@debian.org> Thu, 14 May 1998 21:54:50 +0200
166 debian-policy (2.4.1.0) frozen unstable; urgency=low
168 * Changes to the Debian Policy Manual:
170 - Updated section 3.1.2 Site-specific programs
171 and section 3.8 Keyboard configuration:
172 + improved wording (fixes:bug#20129)
174 - Updated section 2.1.7 Subsections:
175 + fixed typos (fixes:bug#18145)
177 - Updated section 3.3.5 Symbolic links:
178 + symbolic links within a toplevel directory should be relative,
179 symbolic links between toplevel directories should be absolute
180 (cf., Policy Weekly Issue#6, topic 2)
182 - Updated section 3.4 System run levels:
183 + Intro: mention /etc/rcS.d (links to boot time scripts)
184 + Notes: include rationale why /etc/init.d scripts have to be tagged
185 as conffiles (fixes:bug#16199)
186 + Example: changed example init.d script to handle force-reload
187 and restart options and to comply with the console message
188 standard (fixes:bug#19216)
190 - Updated section 4.8 Emacs lisp programs:
191 + Replaced old section about lisp programs with a reference to
192 the file debian-emacs-policy.gz, installed by the emacsen-common
195 - Updated section 4.9 Games:
196 + manpages for games should be installed in /usr/man/man6
197 (cf., Policy Weekly Issue#6, topic 3)
199 - Removed one example reference to the current standards version
200 - Include manual's date as plain text in the .sgml source so that
201 a recompiled manual uses the same release date
203 * Changes to the authoritative list of virtual package names:
204 - Removed obsolete virtual package `emacs'
206 * New version numbering scheme:
208 - The version numbers are independent of dpkg now, but all policy
209 manuals (the Debian Policy Manual, the Debian Packaging Manual, and
210 the Debian Developer's Reference) share the same version numbering
213 - The first three digits of the version number specify the
214 `Standards-Version.' This number is incremented with each policy
215 change. The fourth digit represents the `patch-level,' which may
216 differ between the manuals.
218 If only the patch-level digit is incremented, no changes in policy
219 have been made, except bug fixes and clarifications. Packages only
220 have to specify the first three digits of the version number in the
221 `Standards-Version' field of their source packages.
225 - Uploaded to frozen and unstable. This is a documentation-only
226 package and the changes to the manual are relevant for hamm.
228 - Fixed FSF's address in copyright file (detected by Lintian)
230 -- Christian Schwarz <schwarz@debian.org> Tue, 14 Apr 1998 10:08:09 +0200
232 debian-policy (2.4.0.0) unstable; urgency=low
234 * Changes to the Debian Policy Manual:
236 - Updated section 3.3.4 Scripts:
237 + /bin/sh may be any POSIX compatible shell
238 + scripts including bashisms have to specify /bin/bash as
240 + scripts which create files in world-writable directories
241 (e.g., in /tmp) should use tempfile or mktemp for creating
244 - Updated section 3.3.5 Symbolic Links:
245 + symbolic links referencing compressed files must have the same
246 file extension as the referenced file
248 - Updated section 3.3.6 Device files:
249 + /dev/tty* serial devices should be used instead of /dev/cu*
251 - Updated section 3.4.2 Writing the scripts [in /etc/init.d]:
252 + all /etc/init.d scripts have to provide the following options:
253 start, stop, restart, force-reload
254 + the reload option is optional and must never stop and restart
257 - Updated section 3.5 Cron jobs:
258 + cron jobs that need to be executed more often than daily should
259 be installed into /etc/cron.d
261 - Updated section 3.7 Menus:
262 + removed section about how to register HTML docs to `menu'
263 (the corresponding section in 4.4, Web servers and applications,
264 has been removed in policy 2.2.0.0 already, so this one was
267 - New section 3.8 Keyboard configuration:
268 + details about how the backspace and delete keys should be
271 - New section 3.9 Environment variables:
272 + no program must depend on environment variables to get a
273 reasonable default configuration
275 - New section 4.6 News system configuration:
276 + /etc/news/organization and /etc/news/server should be supported
277 by all news servers and clients
279 - Updated section 4.7 Programs for the X Windows system:
280 + programs requiring a non-free Motif library should be provided
281 as foo-smotif and foo-dmotif package
282 + if lesstif works reliably for such program, it should be linked
283 against lesstif and not against a non-free Motif library
285 - Updated section 4.9 Games:
286 + games for X Windows have to be installed in /usr/games, just as
289 - Lots of typos fixed (thanks to Ray Dassen for the patch!)
291 * Changes to the authoritative list of virtual package names:
292 - added `libc-dev' and `emacsen'
294 * Merged `/usr/doc/debian-policy/changelog-policy.gz' into this
297 * Included `Policy checklist for upgrading your packages' from the
298 Policy Home Page as /usr/doc/debian-policy/upgrading-checklist.text.gz
300 * Added support for doc-base to register the Policy Manual to the
301 online documentation systems dwww and dhelp (fixes:#15710)
303 * Upgraded to standards version 2.4.0.0 (no changes)
305 -- Christian Schwarz <schwarz@debian.org> Fri, 30 Jan 1998 21:58:25 +0100
307 debian-policy (2.3.0.1) unstable; urgency=low
309 * Changes in the Debian Policy Manual:
310 - X library package is now called xlib6g
311 * Changes in the authoritative list of virtual package names:
312 - Added emacs, c-compiler, fortran77-compiler, lambdamoo-core,
314 * Conflict with old dpkg-dev version that included policy manual
316 * Removed `tentative-opt-draft' from package since people considered
317 the draft official policy (which is not the case)
318 * Don't use debstd anymore
320 -- Christian Schwarz <schwarz@debian.org> Tue, 21 Oct 1997 23:03:52 +0200
322 debian-policy (2.3.0.0) unstable; urgency=low
324 * Changes in the Debian Policy Manual:
325 - reworked chapter `The Debian Archive' to cover new
326 contrib/non-free policy
327 - call "contrib" and "non-free" a `section' (not `distribution')
328 - refer to license files (GPL, LGPL, etc.) as uncompressed files
329 - changed `/etc/news/server' into `/etc/nntpserver' in example of
330 maintainer scripts (fixes #11517)
331 - new section about `Daemons'
332 - updated section about `Configuration files'
333 - MUAs and MTAs have to use liblockfile
334 - fixed typos and grammatical errors
335 * Changes in the authoritative list of virtual package names:
336 - renamed tcl/tk virtual package names to `tclsh' and `wish'
337 * Paper about libc6 migration:
338 - fixed typos (fixes #11641), thanks to James Troup for the patch!
339 * SGML source code included in package
340 * don't use `2-up' style for PostScript version (fixes #11095)
342 -- Christian Schwarz <schwarz@debian.org> Mon, 2 Sep 1997 00:54:31 +0200
344 debian-policy (2.2.0.0) unstable; urgency=low
346 * Changes in the Debian Policy Manual:
347 - completely reworked structure
348 - moved sections about new maintainers, upload procedure, interim
349 releases, and mailing lists into the Developers Reference Manual
350 - moved a few (small) sections into the Debian Packaging Manual
351 - removed all those ugly footnotes
352 - new example for "reload" in section about console messages
353 - mention Artistic License (fixes #9793)
354 - don't mention dpkg's version number in Policy Manual
355 - rewrote abstract and section introductions
356 - mention "orphaned packages"
357 - maintainer is responsible for a package license to comply with the
358 distributions' policy
359 - putting a package into base section requires discussion on debian-devel
360 - rewrote sections about "pre-depends", "essential" and, "base" packages
361 - added note that non-us' maintainers have to live outside the US
362 - added crypto-hook statement (fixes #7257)
363 - added section about arch spec strings
364 - rewrote section about "Site specific programs" (/usr/local)
365 - included Ian's suggestions for user IDs
366 - added section about "menus"
367 - removed section about "web menus" since this will be superseded with
368 the new documentation policy soon
369 - incorporated "Debian Free Software Guidelines" (fixes #9024)
370 - removed note that linking with -g produces large a.out binary (fixes
372 - added section about editors and pagers
373 - added note about Package priorities and dependencies
374 - added section about cron jobs (fixes #8814)
375 - added section about device files
376 - don't install shared libraries as executable (fixes #7129)
377 - app-defaults files may not be conffiles (cf. #2717)
378 - lots of minor changes not worth mentioning here (typos, formulations,
380 * Changes in the authoritative list of virtual package names
381 - Removed obsolete virtual packages: xR6shlib, xlibraries,
382 compress, emacs, sgmls, inews, gs_x, gs_svga, gs_both, xpmR6
383 - Added new section about obsolete names
384 * Added Helmut Geyer's paper about libc5-libc6 migration
385 * Fixed package's description
387 -- Christian Schwarz <schwarz@debian.org> Sun, 13 Jul 1997 13:25:51 +0200
389 debian-policy (2.1.3.3) frozen unstable; urgency=low
391 * Mention Artistic License in section 2.5 (bug #9755)
393 -- Christian Schwarz <schwarz@debian.org> Wed, 14 May 1997 16:53:15 +0200
395 debian-policy (2.1.3.2) frozen unstable; urgency=low
397 * Fixed an email address, an URL, and several typos in chapter 6 (#9358)
398 * Added new virtual package "wordlist" to list (requested by Joey Hess)
399 * Changed wording in section about "non-free" packages as suggested
400 by Kai Henningsen (#7076)
402 -- Christian Schwarz <schwarz@debian.org> Mon, 5 May 1997 20:05:39 +0200
404 debian-policy (2.1.3.1) frozen unstable; urgency=low
406 * Fixed bug in chapter 7: `-ur' should read `-us' (#8874)
407 * Fixed bug in chapter 7: `-rwhatever' also needed for rebuild (#8874)
408 * Create a PS and HTML version of the Policy Manual and upload it
410 * Install virtual-package-names-list.text in /usr/doc/debian-policy
411 and upload it "byhand" too.
413 -- Christian Schwarz <schwarz@debian.org> Tue, 29 Apr 1997 18:02:14 +0200
415 debian-policy (2.1.3.0) unstable; urgency=low
418 * New Policy Manager: Christian Schwarz <schwarz@debian.org>
419 * Added section 2.4 about the "non-us" distribution.
420 * Added section 3.1.1 about the "Package" field in the control file.
421 * Added section 3.2.1 about "Binaries": two programs with different
422 functionality must not have the same name.
423 * Changed headline of section 3.2.6 into "Debian changelog and upstream
424 changelog" as suggested by Santiago Vila Doncel <sanvila@unex.es>.
425 * Added log-rotating example to section 3.2.9 that tests with `-sf',
426 as suggested by Boris D. Beletsky <borik@isracom.co.il>.
427 * Added section 3.13: "Webstandard 3.0" by Christoph Lameter.
428 * Added section 3.14: "Standard for Console Messages" by Christian Schwarz.
429 * Split section 4.1 into 4.1.1 (Options for binaries) and 4.1.2 (Options
431 * Added note to 4.1.2: Libraries should be compiled with `-D_REENTRANT'
432 to make them compatible with LinuxThreads, by Rob Browning
433 <osiris@cs.utexas.edu>.
434 * Added note to 4.1.2: Libraries should be stripped with
435 "strip --strip-unneeded", by Guy Maor <maor@ece.utexas.edu>.
436 * Section 5.2: Policy changelog is now
437 "/usr/doc/debian-policy/changelog-policy.gz". This fixes bug #6130.
438 * Section 6.2 renamed to "Uploading your first Debian package". This
441 -- Christian Schwarz <schwarz@debian.org> Sat, 15 Mar 1997 18:08:56 +0100
443 debian-manuals (2.1.2.2) frozen unstable;
445 * Fixed even more typographical and grammatical errors in Policy and
447 * Corrected the contact email addresses again.
448 * Added a paragraph to Policy 6.3 on taking over an old package (Guy Maor)
449 * Added a paragraph to Programmer 4.2.14 on listing distributions to load
450 a package into. (Guy Maor)
451 * Further clarification of use of absolute pathnames in scripts in
454 -- David Morris <bweaver@worf.netins.net> Tue, 3 Dec 1996 23:28:04 -0600
456 debian-manuals (2.1.2.1) frozen unstable;
458 * Many editorial and formatting revisions with suggestions from Ian Jackson,
460 * correction of chiark address in Policy 6.2
461 * footnote in Programmers chapter 2 pointing to deb(5) manpage for
462 description of deb file format.
463 * addition of more dpkg examples in Programmer chapter 2
464 * Replace paragraph in Policy 4.1 outlining compiling parameters for
466 * Added paragraph in Programmer 6.1 on paths in maintainer scripts
468 * Cleaned up language and formatting of Programmer's 12.2, shlibs
469 * Corrected contact addresses for listmaster and override-change
471 -- David Morris <bweaver@worf.netins.net> Wed, 27 Nov 1996 08:17:16 -0600
473 debian-manuals (2.1.2.0) frozen unstable;
475 * Mostly editorial changes in Policy Manual.
476 * Added summary of distribution criteria to Introduction
477 * Added section headings for copyright criteria
478 * Fixed typos (Bugs #4485, #4622)
479 * Added paragraph in Compilation Options related to use of shared and
480 static libraries. (Bug #5299)
481 * Paragraph added about where to find PGP and other export restricted
482 packages in section on Procedure
483 * Change in List administrator and in the contact address for becoming
485 * A paragraph added related to who to contact for package maintainer changes.
486 * Changed where to send upload announcements: uploads destined for unstable,
487 frozen, or experimental go to debian-devel-changes.
489 * Made some mostly editorial changes to Programmers Manual.
490 * Added a recommendation to debmake in Introduction.
491 * A further interpretation of the various Distributions is added with
492 the intent of helping people decide which one to choose. (section 4.2.14)
493 * Section 12 on Shared Libraries expanded with further technical information
494 on various shlib files
495 * Section in 2.2 on format of shlib file moved to new subsection within 12.
496 * Paragraph on adding a symlink without version number added to Shared
497 Library Section (Guy Maor, Bug #5299)
499 -- David Morris <bweaver@worf.netins.net> Fri, 22 Nov 1996 23:41:39 -0600
501 debian-manuals (2.1.1.0) unstable;
503 * Hard links are forbidden in source packages (they didn't work anyway,
504 and can't easily be made to work reliably).
505 * Do not use dpkg-divert or update-alternatives without consultation.
507 * Do not need to declare dependencies on Essential packages.
508 * Restrictions on Pre-Depends stated in policy manual.
509 * debian/substvars file is now almost always auto-generated.
510 * Shared libraries must be installed stripped.
511 * Essential and Pre-Depends put together in policy manual.
513 * Explained component-wise (file-wise) vs. package-wise dependencies.
515 -- Ian Jackson <ian@chiark.greenend.org.uk> Thu, 12 Sep 1996 01:00:41 +0100
517 debian-manuals (2.1.0.0) unstable;
519 * Upstream changelog must be installed too (was just recommended).
521 * Modification to use dpkg-shlibdeps added to conversion instructions.
522 * Packages which are buggy and orphaned but which are preserved for
523 compatibility go in contrib.
525 * Programmers' manual source package section refers to conversion
526 instructions in policy manual.
527 * Make it clear that recommending a non-free or contrib package puts a
530 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sun, 1 Sep 1996 17:47:18 +0100
532 debian-manuals (2.0.1.0) unstable;
534 * varargs.h and libtermcap are obsolete - use stdarg.h and ncurses.
535 * Shared library link/library ordering corrected (aargh).
536 * When to byte-compile Elisp files.
537 * Missing final newlines not represented by dpkg-source.
539 * Must post upload announcements to debian-changes.
540 * Moved some sections into new `configuring and building' chapter.
543 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sat, 31 Aug 1996 20:07:22 +0100
545 debian-manuals (2.0.0.0) unstable;
547 * Footnote added OK'ing copyrights which require name changes.
548 * More detail about changelog format names.
550 * Problematic licence restrictions are formatted as lists.
551 * Mentioned 822-date utility as way to generate RFC822 format dates.
555 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Mon, 26 Aug 1996 14:27:34 +0100
557 debian-manuals (0.2.1.1) unstable;
559 * Can't overwrite directories in one package with files in another.
561 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Sat, 24 Aug 1996 18:44:54 +0100
563 debian-manuals (0.2.1.0) unstable;
565 * Policy says when and how to include original source in upload.
567 * Need -sa on dpkg-genchanges/dpkg-buildpackage when converting.
569 * Use minor patchlevel for meaning changes which don't affect packages.
570 * More verbosity about netiquette.
571 * Reorganised participation and upload policy: merged with mailing lists.
573 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Fri, 23 Aug 1996 12:48:09 +0100
575 debian-manuals (0.2.0.1) experimental;
577 * Said that system administrators' manual does not exist.
579 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Fri, 23 Aug 1996 04:05:36 +0100
581 debian-manuals (0.2.0.0) experimental;
585 -- Ian Jackson <ian@chiark.chu.cam.ac.uk> Wed, 21 Aug 1996 15:07:53 +0100
588 mode: debian-changelog
589 add-log-mailing-address: "phil@hands.com"