chiark / gitweb /
Update changelog for 3.4.11 upload (requested by the security team)
[developers-reference.git] / debian / changelog
1 developers-reference (3.4.11) unstable; urgency=low
2
3   [ Raphaël Hertzog ]
4   * Update versioning advice for security uploads as well. Closes: #709218
5     Thanks to Salvatore Bonaccorso for the patch.
6
7  -- David Prévot <taffit@debian.org>  Wed, 07 Aug 2013 14:06:40 +0200
8
9 developers-reference (3.4.10) unstable; urgency=low
10
11   * Team upload.
12
13   [ Raphaël Hertzog ]
14   * Add recommendations to re-introduce packages. Thanks to Paul Wise for the
15     patch. Closes: #685039
16   * Drop paragraph about vanilla debian/rules files which mainly points to a
17     no-longer working link.
18
19   [ Hideki Yamane ]
20   * Introduce epub support. Closes: #652044
21
22   [ Thijs Kinkhorst ]
23   * Update versioning advice for uploads to stable/testing. Closes: #685646
24   * Advise to use codename-security instead of stable-security.
25     Closes: #708290
26
27   [ Translation updates ]
28   * French by David Prévot.
29   * Japanese by victory.
30   * German by Chris Leick.
31
32   [ David Prévot ]
33   * debian/control:
34     - Update Standards-Version to 3.9.4 (no change required).
35     - Use canonical URL for Vcs-Svn.
36
37  -- David Prévot <taffit@debian.org>  Thu, 16 May 2013 18:35:23 -0400
38
39 developers-reference (3.4.9) unstable; urgency=low
40
41   * Team upload.
42
43   [ Raphaël Hertzog ]
44   * Clarify that removals from testing are possible. Closes: #678710
45     Thanks to Per Andersson <avtobiff@gmail.com> for the patch.
46   * Reword various parts to be gender-neutral. Closes: #678712
47     Thanks to Per Andersson and Steve Langasek for the patch.
48   * Recommend usage of gender-neutral formulations in README-contrib.
49   * Fix Vcs-Browser URL. Thanks to Charles Plessy who spotted it.
50   * Document the existence of "hints" that release managers can
51     use to tweak the conditions of testing migration. Closes: #679562
52     Thanks to Paul Gevers <paul@climbing.nl> for the patch.
53
54   [ Translation updates ]
55   * Japanese by Hideki Yamane.
56   * French by David Prévot.
57   * German by Chris Leick.
58
59   [ David Prévot ]
60   * Fix typo: Freenodes -> Freenode. Closes: #679735
61
62  -- David Prévot <taffit@debian.org>  Sun, 19 Aug 2012 17:34:59 -0400
63
64 developers-reference (3.4.8) unstable; urgency=low
65
66   [ David Prévot ]
67   * Move away po4a handling in its own directory with a single config file.
68   * Adapt Makefile and README-contrib to the current po4a tree.
69   * Upgrades to stable should be discussed using reportbug. Thanks to Don
70     Armstrong <don@donarmstrong.com> for the patch.
71     Acked-by: Julien Cristau <jcristau@debian.org> . Closes: #670362
72   * Use UTF-8 locale to prepare the text version. Closes: #658839
73   * Delayed queue goes from 0 to 15-day. Closes: #631353
74
75   [ Osamu Aoki ]
76   * Make XeTeX backend to use xCJK package only for CJK and add tipa for
77     build dependency. (See #666569). Closes: #666578
78
79   * Translation updates (complete)
80     - French by David Prévot.  
81     - German by Chris Leick.
82
83   [ Raphaël Hertzog ]
84   * Update Standards-Version to 3.9.3 (no change required).
85   * Switch to xz compression for source.
86   * Clean up debian/rules by using dh (with compat level 8).
87   * Drop build-dependency on latex-cjk-xcjk since xeCJK.sty is provided
88     by texlive-xetex directly.
89
90  -- Raphaël Hertzog <hertzog@debian.org>  Mon, 25 Jun 2012 18:57:23 +0200
91
92 developers-reference (3.4.7) unstable; urgency=low
93
94   * Team upload.
95
96   [ Raphaël Hertzog ]
97   * Document some best practices for meta-packages. Extend those for
98     transitional packages. Based on a patch by Luca Falavigna
99     <dktrkranz@debian.org> (thanks!). Closes: #569219
100   * Update license pointer to correctly point to GPL-2. Closes: #643929
101     Thanks to Luca Falavigna.
102   * Update URL of Debian Mentors FAQ. Closes: #643930
103     Thanks to Luca Falavigna for the patch.
104   * Refresh some release-specific information. Closes: #643931
105     Based on a patch by Luca Falavigna.
106   * Refresh some ftpmaster-related information. Closes: #643932
107     Thanks to Luca Falavigna for the patch.
108   * Update minimal GPG key length to match current requirements.
109     Closes: #643933 Thanks to Luca Falavigna for the patch.
110   * Update login information for rt.debian.org. Closes: #643934
111     Thanks to Luca Falavigna for the patch.
112   * Drop section about yada. Its usage is highly discouraged. Closes: #643935
113     Thanks to Luca Falavigna for the patch.
114   * Update best practice about unfuzzying PO file translations to recommend
115     msguntypot. Thanks to David Prévot for the patch.
116     Acked-by Christian Perrier. Closes: #655153
117
118   [ David Prévot ]
119   * Add doc-base file for the German translation.
120   * Typo fix, thanks to Andreas Moog. Closes: #655096
121   * Use XeTeX backend, that fix quotes in examples. Closes: #629530
122   * Build the Japanese PDF, thanks to Osamu Aoki and the maint-guide build
123     process.
124
125   * Translation updates (all completed)
126     - Japanese by Hideki Yamane.
127     - German by Chris Leick.
128     - French by David Prévot.
129
130  -- David Prévot <taffit@debian.org>  Tue, 17 Jan 2012 16:36:12 -0400
131
132 developers-reference (3.4.6) unstable; urgency=low
133
134   [ Raphaël Hertzog ]
135   * Update the NMU rules to take into account the 0-day NMU rule
136     instituted by the release managers. Closes: #625449
137
138   [ Lucas Nussbaum ]
139   * Update my email address.
140   * Encourage the use of RT to contact the security team.
141     Patch from Thijs Kinkhorst. Closes: #610782
142   * Document the process of returning after retirement.
143     Patch from Serafeim Zanikolas. Closes: #540249
144   * Add instructions how to mark a non-free package as auto-buildable.
145     Patch from Moritz Muehlenhoff, ACKed by Andreas Barth.
146     Closes: #602838
147
148  -- Lucas Nussbaum <lucas@debian.org>  Sun, 31 Jul 2011 19:52:10 +0200
149
150 developers-reference (3.4.5) unstable; urgency=low
151
152   * Team upload.
153
154   [ Gerfried Fuchs ]
155   * Remove part about -v for package uploads from experimental to unstable,
156     version tracking removed that requirement.
157
158   [ Raphaël Hertzog ]
159   * Rework section on "sponsoring packages" and include a basic
160     checklist for the sponsor. Closes: #453313
161   * Update the "Debian Developer's Duties" chapter to be more explicit
162     about duties of package maintainers. Closes: #548867
163   * Update references to merkel (which is decommissionned) where
164     needed. Closes: #619990
165     Thanks to Charles Plessy for the patch.
166   * Many typos fixed by Chris Leick <c.leick@vollbio.de>. Closes: #623512
167
168   [ Chris Leick ]
169   * Initial German translation.
170
171   [ David Prévot ]
172   * Activate German package. Closes: #623489
173   * Update French translation.
174   * Bump Standards-Version to 3.9.2. No changes needed.
175   * Add build-arch and build-indep targets.
176   * Explicitly refer to GPL-2 file in debian/copyright.
177
178   [ Hideki Yamane ]
179   * Update Japanese translation.
180
181  -- David Prévot <taffit@debian.org>  Sun, 19 Jun 2011 13:56:46 -0400
182
183 developers-reference (3.4.4) unstable; urgency=low
184
185   [ Lucas Nussbaum ]
186   * Document the new derivatives-bugs PTS keyword.
187   * Removed hp.debian.or.jp reference. Closes: 561597
188
189   [ Raphaël Hertzog ]
190   * Update description of the PTS "summary" keyword. Thanks to
191     Simon McVittie <smcv@debian.org> for the patch. Closes: #469154
192   * Add accent on my first name in debian/control.
193   * Use "3.0 (native)" source format with bzip2 compression.
194     Created debian/source/{format,options} for this.
195   * Update guideline for override change to point to BTS
196     instead of email. Thanks to Simon McVittie <smcv@debian.org> for the
197     patch. Closes: #540231
198   * Include full URL to the README of the upload queue. Thanks to Simon
199     McVittie <smcv@debian.org> for the patch. Closes: #540974
200   * The key protecting #debian-private is now stored on a file
201     on master.debian.org, it's no more required to search into
202     the debian-private archives. Thanks to gregor herrmann <gregoa@debian.org>
203     for the patch. Closes: #548823
204   * Update information about upload queues. Thanks to Simon McVittie
205     <smcv@debian.org> for the patches:
206     - point to official names {ftp,ssh}.upload.debian.org. Closes: #554054
207     - drop references to non-working queues. Closes: #554077
208   * Mention docbook, POD and reST as convenient formats to write new manual
209     pages. Thanks to Charles Plessy and the debian-mentors list
210     for the idea and the patch. Closes: #557298
211   * Update several sections to take into account the new source formats “3.0
212     (quilt)” and “3.0 (native)”. Closes: #561952
213   * Drop reference to “dbs” in the section about including binary files.
214   * Fix typo “transfered“ → “transferred”. Closes: #555685
215   * Fix typo “programms“ → “programs”. Closes: #560808
216   * Drop section about debmake, it has been removed of Debian since lenny.
217   * Update URL of the security tracker. Thanks to Salvatore Bonaccorso.
218     Closes: #556229
219   * Update URL of Packages-arch-specific. Closes: #553974
220   * Update section about Alioth to mention FusionForge instead of GForge.
221     Drop mention of separate cvs.debian.org it's managed by Alioth too.
222     Closes: #564068
223   * Document new "buildd" keyword from the PTS.
224   * Update URL explaining the "Debian Maintainer" status, it's now at
225     http://wiki.debian.org/DebianMaintainer. Closes: #564414
226   * Update number of source packages. Thanks Karl Goetz. Closes: #567235
227   * Update and simplify list of architectures. Thanks Karl Goetz.
228     Closes: #567234
229   * Small typo fixes and clarifications/rewordings suggested by Karl Goetz.
230     Closes: #567233
231   * Document the notion of "team upload": it looks like an NMU but it's not
232     really one because the uploader is an implicit co-maintainer since he's
233     part of the maintenance team. Thanks to Charles Plessy for the initial
234     patch. Closes: #573110
235   * Update standards-version to 3.9.1 and add missing ${misc:Depends} in
236     dependencies.
237   * Fix debian/tocsubstvars to cope with the new way dpkg-dev handles
238     multi-lines substitution variables.
239
240   [ David Prévot ]
241   * Update outdated mentions, typos and tags. Closes: #578664
242   * French translation updated from the 2006 debiandoc version.
243   * Apply updated patch from Nicolas François. Closes: #257150
244   * dinstall run happens four times a day. Closes: #585161
245   * Activate Japanese package.
246   * Handle addendum if it exists.
247
248  -- Raphaël Hertzog <hertzog@debian.org>  Mon, 22 Nov 2010 19:28:03 -0400
249
250 developers-reference (3.4.3) unstable; urgency=low
251
252   * Fixed working of the repackaged tarballs section to avoid giving the
253     impression that it's a standard packages must comply with. Closes:
254     #489135.
255   * Specify that bugs from removed packages must be closed in foo+rm.
256     Closes: #491839.
257   * Change the maintainer address to debian-policy@, based on discussion
258     on debian-devel@.
259   * Bump Standards-Version to 3.8.3. No changes needed.
260   * Update copyright notices and list of authors.
261
262  -- Lucas Nussbaum <lucas@lucas-nussbaum.net>  Thu, 17 Sep 2009 20:56:19 +0200
263
264 developers-reference (3.4.2) unstable; urgency=low
265
266   * Applied patch from Justin B Rye that improves the discussion on writing
267     package descriptions. Closes: #516436.
268   * Lenny has been released, update the list of codenames. Closes: #527008.
269   * Applied patch from Paul Wise that adds a paragraph about hostile
270     upstreams. Closes: #523985.
271   * Applied patch from Charles Plessy about providing information to the
272     ftpmasters. Closes: #526410.
273   * In the section about patch systems, mention quilt (wasn not
274     mentionned before) and describe it as the recommended patch system.
275     also mention dpatch and cdbs' patch system. drop dbs. Closes: #525668.
276   * Added a note in the wanna-build section to mention
277     http://release.debian.org/wanna-build.txt. Closes: #516375.
278   * Clarified NMU versioning to reflect existing practices. Closes: #532945.
279   * s/README.Debian-source/README.source/ in the section
280     about repackaged upstream tarballs.
281   * Mention the Gandi.net hosting discount in section 4.13.
282     Applied patch from Tim Retout. Closes: #538245.
283   * Reduce length of title of L10N section so that it is no longer split.
284     Applied patch from Justin B Rye. Closes: #534688.
285   * Bumped debhelper compat level to 5 (4 was deprecated)
286   * Bump Standards-Version to 3.8.2. No changes needed.
287   * Added pointer to debian-project@ post about the wanna-build team.
288
289  -- Lucas Nussbaum <lucas@lucas-nussbaum.net>  Sat, 22 Aug 2009 12:28:04 +0200
290
291 developers-reference (3.4.1) unstable; urgency=low
292
293   [ Raphael Hertzog ]
294   * Create a publish target in the Makefile to reenable builds on the
295     website.
296
297   [ Lucas Nussbaum ]
298   * Commited DEP1: rework the whole NMU section.
299     The most important changes are:
300     + NMUs are now explicitely allowed for all bugs, not just "serious bugs".
301     + It is recommended to use the DELAYED queue, and some example delays are
302       provided.
303     Other fixes:
304     + Describe the process of acknowleding NMUs in a way that works
305       with the BTS's version-tracking. Closes: #480723.
306     + No longer mention that only DDs can do NMU. Don't make any
307       distinction. Closes: #464230.
308     + Switch to +nmu for NMU versioning. Closes: #437392.
309     + Mention nmudiff. Closes: #483227.
310   * Mention docbook-xml, and that debiandoc-sgml is deprecated. Thanks to
311     W. Martin Borgert for the patch. Closes: #485689.
312   * Fixed typo and example in the blurb about debug packages.
313     Thanks to Theppitak Karoonboonyanan for the patch.
314     Closes: #487664.
315   * Update instructions on the delayed queue.
316     Thanks to Thijs Kinkhorst for the patch.
317     Closes: #512529.
318   * Clarify wording about repackaged .orig.tar.gz.
319     Thanks to Cyril Brulebois for the patch.
320     Closes: #492661.
321   * Improved README.contrib. Mention command to checkout the SVN
322     version. Thanks to Christine Spang for the patch.
323     Closes: #500371.
324   * Document usertags. Thanks to Chris Lamb for the patch.
325     Closes: #367876.
326   * Updated documentation on translation updates.
327     Thanks to Christian Perrier for the patch.
328     Closes: #474879.
329   * Update instructions on handling of security issues.
330     Thanks to Thijs Kinkhorst for the patch.
331     Closes: #512620, #510783.
332
333  -- Lucas Nussbaum <lucas@lucas-nussbaum.net>  Fri, 23 Jan 2009 09:57:54 +0100
334
335 developers-reference (3.4.0) unstable; urgency=low
336
337   [ Lucas Nussbaum ]
338   * Update Vcs-* fields after DDP's SVN restructuring. Closes: #483428.
339   * Fix conditions for updates from unstable to testing. Closes: #470754.
340   * linda has been removed. Remove section A.2.2. Closes: #483242.
341   * Co-maintainers are listed in the Uploaders field. Closes: #483230.
342   * Collaborative Maintenance: the 'global part' of debian/control
343     is the first paragraph, about the source package. Closes: #483231.
344   * debian-private archives are on master. Closes: #475531.
345   * Mention Debian Maintainers and the debian-maintainers package.
346     Closes: #483225.
347   * README.contrib: document that short lines are preferred.
348     Closes: #278267.
349   * build-rdeps allows to list reverse build-dependencies.
350     Closes: #376582.
351
352   [ Marc 'HE' Brockschmidt ]
353   * Replace abused <emphasis> tags with <literal> tags.
354   * In the same spirit, wrap all uses of stable/testing/unstable and
355     release codenames in <literal>
356   * Remove reference to upload queue on auric in section 5.6.5, auric
357     doesn't exist anymore.
358   * Fix several typesetting errors and typos noticed by Sandro Tosi,
359     thanks for the notes! Closes: #483223
360   * Update several bits about release management/testing transitions
361     and release-critical bugs. Closes: #483237, #456494
362   * Update and rewrite the porting guidelines in chapter 5, bringing
363     the dev-ref up to the state of porting in the year 2008. Also
364     fixes several wording issues, such as possible misunderstandings
365     about the need to rebuild uploads. Closes: #483226
366   * Update the instructions for uploads to the (old)stable 
367     distributions. Emphasize the importance of contacting the SRM
368     team before upload. Closes: #459343
369   * Update instructions for package removal requests. Closes: #454216
370   * Clarify instructions for bug reassignment, emphasizing the
371     need to inform the maintainers you reassign the bug to. Also
372     hint to using cloned bugs to avoid re-reporting. Heavily based
373     on patch by Marc Haber - thanks for the work! Closes: #484806
374   * Clarify instructions for replacing/renaming binary packages,
375     pointing out that using Provides is sometimes advisable. Closes:
376     #467102
377   * Update description of the madison tool (by replacing it with a
378     description of the dak ls tool). Update the example while we're
379     at it.
380   * Update explanation of best practice for closing bugs, seems to
381     have been forgotten when everything was upgraded to use
382     debbugs version-tracking. Closes: #485969
383   * Clarify ITP instructions and emphasize our wish that people send
384     ITPs, explaining a few of the reasons. Thanks for the note,
385     Thomas. Closes: #485837
386   * debian/control:
387      + Update Uploaders to include Lucas, Raphael and me.
388      + Bump Standards-Version to 3.8.0. No changes needed!
389
390  -- Lucas Nussbaum <lucas@lucas-nussbaum.net>  Fri, 13 Jun 2008 13:45:49 +0200
391
392 developers-reference (3.3.9) unstable; urgency=low
393
394   [ Andreas Barth ]
395   * Packaging changes:
396     - bump standards-version to 3.7.3 (no change)
397     - fix debian/copyright
398     - move debhelper to Build-Depends.
399     - add pdf for French version.
400   * Document changes to stable release management. Closes: #414291
401   * Debconf error templates no longer discouraged. Thanks,
402     Christian Perrier. Closes: #427832
403   * Keyring now uses RT. Closes: #428846
404   * Document -dbg-packages within BPs. Thanks, Joey Hess. Closes: #420540
405   * NMUs now also close bugs. Thanks, Lucas Nussbaum. Closes: #419507
406   * Fix documentation about gender neutral. Closes: #384178
407   * Fix typo. Closes: #405453
408   * More details on how to write documentation. Thanks, Josh Triplett.
409     Closes: #422750
410   * Add XS-Vcs-*. Thanks to Stefano Zacchiroli. Closes: #391023
411   * Small brushup to debconf description. Thanks, Thomas Huriaux.
412     Closes: #401415
413   * Document Team-Maintainence better. Thanks, Lucas Nussbaum.
414     Closes: #410159
415   * Add link to more removal ressources. Thanks, Adam D. Barratt,
416     Justin Pryzby. Closes: #412757, #356720
417   * Repacking source packages need to be documented in copyright.
418     Thanks, Russ Allbery. Closes: #413320
419   * Better describe version of debian native packages NMUs. Closes: #405818
420   * Source, HTML and text are now encoded in UTF-8. Thanks, Jörg Sommer.
421     Closes: #373816
422   * Source is now DocBook XML instead of debiandoc. Closes: #374220
423
424   [ Raphael Hertzog ]
425   * Add a link to enrico's excellent Debian Community Guidelines.
426   * Recommend the use of DSA's request tracker instead of mailing them.
427   * Remove reference to #debian-sf, #debian-bsd which don't exist anymore. Put
428     a reference to #debian-dpkg instead.
429   * Remove all stuff concerning non-US.
430   * Update information concerning Alioth.
431   * Update information concerning the Package Tracking System.
432   * Mention Alioth as the main resource for VCS repositories and deprecate
433     cvs.debian.org.
434   * Remove XS- prefix for Vcs-* fields since dpkg now supports them.
435   * Document the Homepage field. Thanks, Christian Perrier. Closes:
436     #445642
437   * Add Vcs-Svn and Vcs-Browser fields pointing to the new SVN
438     repository.
439
440  -- W. Martin Borgert <debacle@debian.org>  Thu, 28 Feb 2008 10:16:40 +0000
441
442 developers-reference (3.3.8) unstable; urgency=low
443
444   * mia-history is replaced by mia-query. Thanks, Christoph Berg.
445     Closes: #350792
446   * fix missing quite. Thanks, Frank Küster. Closes: #365994
447   * use gnugp instead of gpg. Thanks, Justin Pryzby, Jon Dowland.
448     Closes: #376411
449   * better destinction between maintainer and developer. Thanks for
450     the suggestion to Colin Tuckley. Closes: #380458
451   * irc.d.o points to oftc. Thanks, Christoph Biedl, Jon Dowland.
452     Closes: #382721
453   * Bugs are now always closed thanks to version tracking.
454     Closes: #339552, #353447, #376199
455   * Clarify what "a conflicts b" means in testing migration. 
456     Closes: #361311
457   * Packages in testing disappear if they're removed from unstable.
458     Thanks, Frank Küster, Al Stone. Closes: #365993
459   * Document only the most recent changelog entry is used. Thanks
460     to Kevin Glynn to the suggestion. Closes: #374738
461   * Add more tools for reverse depends. Close: #376582
462   * delayed-queue on gluck is uploaded more often now. Closes: #397907
463   * stop using capitals, minor fixes, language fixes.
464     Thanks, Thijs Kinkhorst, Colin Tuckley, Russ Allbery.
465     Closes: #368046, #378929, #361744
466   * add CVE Ids to your changelog. Closes: #376961
467   * add reasoning why debconf questions shouldn't be longer than
468     20 lines. Thanks, Thijs Kinkhorst, Christian Perrier, Russ Allbery.
469     Closes: #382477
470   * section changing needs re-uploading orig.tar.gz.
471     Thanks, Adam D. Barratt. Closes: #387154
472   * binary files in diffs could be en/decoded with perl.
473     Thanks, Frank Küster. Closes: #397786
474   * Add pointer to new-reject-FAQ. Closes: #324967
475   * Hint to dd-list/whodepends. Closes: #353874
476   * Don't use too generic mail ids. Closes: #355725
477   * pts/summary is actually used. Thanks, Holger Levsen. Closes: #387108
478   * clarify that one should append the NMU-diff to a bug. Closes: #394033
479   * more detailed instructions on binary package removals.
480     Closes: #356643
481
482   * Frédéric Bothamy
483     - French translation updated to version 3.3.8
484
485  -- Andreas Barth <aba@not.so.argh.org>  Sat, 11 Nov 2006 10:55:44 -0700
486
487 developers-reference (3.3.7) unstable; urgency=low
488
489   * Andreas Barth:
490     - adjust information about distributions with reality.
491     - add note on alioth accounts. Thanks, Phillip Kern. Closes: #306630
492     - correct manpage section of dpkg-scanpackages. Closes: #297069
493     - fix RFC 2440 URL. Closes: #308103
494     - add $arch@buildd information. Closes: #295483
495     - link to keyring.d.o for key replacement. Thanks, Martin Michlmayr.
496       Closes: #298016
497     - add information about Packages-arch-specific. Thanks, Frank Küster.
498       Closes: #302000
499     - add hint about LWN subscription. Thanks, Martin Michlmayr.
500       Closes: #299217
501     - more about debconf-style translation. Thanks, Christian Perrier.
502       Closes: #309502
503     - non-us discontinued.
504     - document nmu changes wrt version tracking. Thanks, Justin Pryzby.
505       Closes: #341197
506     - fix spelling issues. Thanks to various people.
507       Closes: #336146, #326857, #338660
508     - update menu policy helpers. Thanks, Florian Ernst. Closes: #340024
509     - send mia-mail to mia@qa. Thanks, Adam D. Barratt. Closes: #341568
510     - Joerg Jaspert is now freenode contact. Closes: #344303
511     - give a clearer description of the gpg v4-key issues. Thanks,
512       Martin Michlmayr and Peter Palfrader. Closes: #317411
513     - more verbose about Homepage. Closes: #339826
514     - add sarge and etch. Closes: #327682
515     - document severity of RoM-request bugs. Closes: #305947
516     - update FSF address. Closes: #334820
517     - fix P-a-s link. Closes: #341195
518     - reflect binNMU changes. Closes: #349493
519     - new security upload queue. Closes: #352749
520     - fix experimental's sources.list entry. Closes: #347229
521     - remove deprecated "Closes:..." to ACK NMU bug fixes. Closes: #353447
522     - when resigning, gpg-sign your mail. Closes: #348160
523     - make pristine source and repackaged origtargz anchors work.
524       Closes: #351255
525     - same number of RC bugs is ok. Closes: #351944
526     - dpkg-source doesn't keep permissions. Thanks, Enrico Zini.
527       Closes: #306120
528     - also mention aspell. Closes: #320981
529
530   * Frédéric Bothamy
531     - French translation updated to version 3.3.7, proofread by Bernard Adrian
532   
533  -- Andreas Barth <aba@not.so.argh.org>  Sun, 09 Apr 2006 11:31:52 -0600
534
535 developers-reference (3.3.6) unstable; urgency=low
536
537   * Andreas Barth
538     - closes: and NMUs/experimental uploads. Closes: #284714
539     - madison is on merkel.
540     - more gender-neutral. Closes: #290583, #290584, #263114
541     - explain current incoming. Closes: #290019
542     - remove broken sponsoring URL. Closes: #291698
543     - add handling hints about orig.tar.gz. Thanks, Frank. Closes: #278524
544     - duplicate bug reports should be merged. Closes: #285381
545     - if you're on vacation, please check whether someone needs keysigning.
546       Closes: #285458
547     - freenode has developer cloacks. Closes: #285687
548     - cleaned up uploaders / maintainer field
549     - explain how dak detects NMUs. Closes: #292354
550     - add "mass" to lots of bugs. Closes: #292946
551     - sync NM rules with reality.
552   * Frédéric Bothamy
553     - French translation updated to version 3.3.6
554
555  -- Andreas Barth <aba@not.so.argh.org>  Sun, 23 Jan 2005 16:08:49 -0700
556
557 developers-reference (3.3.5) unstable; urgency=low
558
559   * Andreas Barth
560     - uploads to more than one dist are not possible.
561     - updated upload queues. Closes: #235213
562     - updated URL of vanilla rules files. Closes: #237557, #252048
563     - please speak with stable RM before uploading to stable. Closes: #261464
564     - information on wnpp usage synced with wnpp. Closes: #255298
565     - spelling, grammer fixes.
566       Closes: #202444, #202499, #203202, #203378, #221902, #226208
567     - add hint about partitial key id. Closes: #243968
568     - spohr is restriced, and also ftp-master. Closes: #255814
569     - bpp: Hint about locale generation as non-root. Closes: #208021
570     - bpp: deborphan-compliant transition packages. Closes: #183654
571     - add myself to uploaders.
572     - add chapter about i10n. Closes: #208156
573     - add information about dchroot. Closes: #211845
574     - add information about NEWS.Debian. Closes: #212402
575     - add information about mia-database. Closes: #213961
576     - add link to debian-mentors FAQ.
577     - add verbose information about the package description. Closes: #214792
578     - add hint about -v<version> to experimental. Closes: #232930
579     - update information about yada. Closes: #217956
580     - urgency is sticky. Closes: #261914
581     - updated information about testing distribution. Closes: #266649.
582     - rewrote the NMU section, and
583       + made the possible severities of "target bugs" clearer. Closes: #233088.
584       + mention QA uploads. Closes: #202416.
585       + add -B for binNMUs, and local debsign usage. Closes: #208839.
586       + warning about breaking all-packages by binNMU. Closes: #213348.
587     - add information about gpg usage. Closes: #175815.
588     - make key replacement instructions more details. Closes: #275921
589     - typo and language fixes. Thanks, Era Eriksson. Closes: #277576
590     - add hints about debconf templates from Christian Perrier.
591   * Matt Zimmerman
592     - Security uploads get urgency=high
593     - Be even more explicit about not uploading security updates
594   * Frédéric Bothamy
595     - French translation updated to version 3.3.5
596
597  -- Andreas Barth <aba@not.so.argh.org>  Mon, 22 Nov 2004 19:07:26 +0100
598
599 developers-reference (3.3.4) unstable; urgency=low
600
601   * Josip Rodin:
602     - fixed language in the PTS section, prompted by a patch from
603       Romain FRANCOISE, thank you; closes: #197741
604     - updated the mailing lists section (again)
605     - documented Alioth, somewhat
606   * Frédéric Bothamy
607     - French translation updated to version 3.3.3 (more or less)
608     - proofread by Patrice Karatchentzeff
609   * Matt Zimmerman
610     - Don't upload security updates directly to stable
611     - Always include an external reference in security changelog entries
612     - Be careful not to re-use a version number in security uploads
613     - More explicit instructions about what is appropriate for a security
614       upload
615
616   * Adam Di Carlo
617     - replace <!entity...> with <!ENTITY...> and other SGML hygenics
618     - build refinements
619     - Release this package as is to flush changes between June and now.
620       Yes, its been an age between releases here, for which I apologize.
621       Since CVS upstream for this package is back, I'm working on closing
622       bugs in this package now, I just wanted to get it out as is before I
623       started.
624
625  -- Adam Di Carlo <aph@debian.org>  Sun, 29 Feb 2004 14:09:48 -0500
626
627 developers-reference (3.3.3) unstable; urgency=low
628
629   * Frédéric Bothamy
630     - corrections by Michel Grentzinger
631   * Raphaël Hertzog
632     - updated documentation concerning the PTS
633     - added a paragraph about the PTS web interface
634     - documented how to add custom news item in the PTS
635   * Matt Zimmerman
636     - updates and clarifications to instructions for security bugs
637     - deprecate uploads to stable for security fixes, reference
638       section on security bugs; closes: #196516
639     - use dpkg-buildpackage -B to test binary-arch, not -b;
640       closes: #196555
641   * Adam Di Carlo
642     - Sec "Managing sponsored packages": remove unnecessary 'debsign' cmd;
643       closes: #192417
644     - fix debconf-devel(7) man page section; closes: #189512
645     - Sec "Responding to bugs": mention what FTBFS means; closes: #186605
646     - Sec "Distribution directories" renamed "Distributions"
647     - Sec "The testing distribution" moved under Sec "Distribution
648       directories" and renamed "More information about the testing
649       distribution"
650     - Secs "Uploads to {stable,testing-proposed-updates}" retitled to make
651       it clear these are special cases
652     - Sec "Uploading to ftp-master": xref to "Delayed incoming"; 
653       closes: #195997
654     - check compliance with Policy version 3.5.10
655
656  -- Adam Di Carlo <aph@debian.org>  Mon, 16 Jun 2003 04:08:29 -0400
657
658 developers-reference (3.3.2) unstable; urgency=low
659
660   * Frédéric Bothamy:
661     - French translation updated to version 3.3.1
662     - proofread by Philippe Batailler and Patrice Karatchentzeff
663   * Adam Di Carlo:
664     - French translation requires debiandoc-sgml 1.1.76 or better
665
666  -- Adam Di Carlo <aph@debian.org>  Fri, 18 Apr 2003 09:48:59 -0400
667
668 developers-reference (3.3.1) unstable; urgency=low
669
670   * Josip Rodin:
671     - package description said it contained French and Japanese, fixed,
672       closes: #182614
673     - Sec "Experimental": sources.list entries
674     - Sec "Basic rules for [mailing list] use": cosmetic, link to this sec
675     - Sec "Handling bugs": retitle and expand section
676   * Adam Di Carlo:
677     - more improvements to package synopsis and description
678     - the synopsis formula changed to either
679        <package-name> is a <synopsis>
680       or
681        <package-name> is <synopsis>
682       or
683        <package-name> are <synopsis>
684       closes: #182956
685     - the synopsis itself should not start with an article
686     - Sec "Best practices for debian/control": expand intro
687     - fix doc-check URL; closes: #187144
688     - Sec "Multiple binary packages": fix awkward wording about vim source
689       package; closes: #187143
690
691  -- Adam Di Carlo <aph@debian.org>  Fri,  4 Apr 2003 14:26:52 -0500
692
693 developers-reference (3.3) unstable; urgency=low
694
695   * Frédéric Bothamy:
696     - French translation updated to version 3.2.2 (more or less)
697     - proofread by Philippe Batailler
698   * Raphaël Hertzog:
699     - added "ddtp" keyword in the PTS documentation
700   * Josip Rodin:
701     - split out the doc-files per language, closes: #177448
702     - shuffled stuff around in the packages chapter
703     - added a section describing how to handle large amounts of
704       architecture-independent data bundled with programs
705     - added best practices on debian/changelog files, based on a patch
706       kindly provided by Daniel Kobras, closes: #166388
707     - described debdiff and dpkg-depcheck, and linked to them from the
708       right places in the document, closes: #172897
709     - describe the current practice in writing synopsis lines,
710       closes: #174161
711   * Adam Di Carlo:
712     - update (c) year
713     - convert to debhelper (compat mode 4); maintainer scripts no longer
714       needed
715     - split -ja and -fr versions out into separate packages
716     - top-level makefile deletes targets on error; clean is cleaner
717     - replace the manual debian/control processing to show the document's
718       table of contents (TOC) with a new script 'debian/tocsubstvars';
719       note that the TOC displayed in the developers-reference-{fr,ja}
720       package descriptions are in English until UTF8 control files are
721       allowed; proper escaping of single quotes here requires newest
722       debhelper
723     - editorial changes on material added in this version
724     - reorder "Best Packaging Practices" a bit
725     - rework "Best practices for debian/control" based on contributions
726       from Colin Walters, Branden Robinson, Sebastian Rittau and others;
727       closes: #139957, #108416
728     - primary author is developers-reference@packages.debian.org; remove
729       emails from other authors to prevent spam and confusion
730
731  -- Adam Di Carlo <aph@debian.org>  Mon, 24 Feb 2003 13:29:07 -0500
732
733 developers-reference (3.2.2) unstable; urgency=low
734
735   * Josip Rodin:
736     - slightly rewrote and updated links in the mirrors section
737   * Adam Di Carlo:
738     - Policy compliance checked and updated to 3.5.8, no changes needed
739     - TODO: remove some tasks which are done
740     - ship README-contrib and TODO in the doc dir
741     - Sec "Upstream home page": some revisions based on discussion on
742       policy list
743     - Sec "Documentation" added under Sec "Common packaging situations"
744       for best practices for documentation
745     - Add tools entries for autotools-dev, dpkg-repack, alien, debsums;
746       new Sec "Documentation and information", add entries there for
747       debview, debiandoc-sgml, debian-keyring; we believe this manual now
748       covers all of the established, general Debian maintainer tool
749       packages
750     - spell-checking pass
751
752  -- Adam Di Carlo <aph@debian.org>  Thu, 12 Dec 2002 13:45:23 -0500
753
754 developers-reference (3.2.1) unstable; urgency=low
755
756   * Adam Di Carlo:
757     - Sec "Best practices for debian/control" added, Sec "Writing useful
758       descriptions" moved under there
759     - Sec "Upstream home page" added in debian/control section
760     - Sec "Miscellaneous advice" empty, removed
761     - Sec "Overview of maintainer tools": tools now categorized into
762       subgroups; do cross-linking from this section into other parts of
763       the document where these tools are discussed
764     - Sec "Overview of maintainer tools": add entries for sbuild,
765       build-essential, linda; improved entries for pbuilder, devscripts
766     - Sec "Tools for porters" renamed and readapted to "Porting
767       infrastructure and automation"; move tool discussion down to the
768       appendix; improve Sec "buildd" a bit
769     - README-contrib added giving information for authors, contributors,
770       and translators
771     - eliminate the ByHand stuff, I'm pretty sure it's not needed now
772       with the DDP builder process, or if it is needed, it's a probably
773       that can be fixed by DDP folks
774     - stop shipping SGML source -- use 'apt-get source developers-reference'
775       after all, this is supposed to be a binary package, right?
776     - simply PS and PDF building rules
777   
778  -- Adam Di Carlo <aph@debian.org>  Mon,  9 Dec 2002 03:04:19 -0500
779
780 developers-reference (3.2) unstable; urgency=low
781
782   * Josip Rodin:
783     - merged a bit misplaced lintian-reports section within the lintian
784       section and adjusted links
785     - added the missing description of dh-make and adjusted links
786   * Adam Di Carlo:
787     - ChangeLog attribution updates
788     - fix typos, closes: #171781
789     - expand the doc-base abstract and authors
790     - Ch "Packaging Practices" rewritten intro
791     - Sec "Packaging tools and common cases" renamed to "Best Practices
792       for debian/rules", and write an intro
793     - Sec "Helper scripts" in practices section rewritten, giving
794       arguments for and against debhelper, mostly for :)
795     - Sec "Package with multiple patches" renamed to "Patching source
796       versus patching at build time" and rewritten
797     - Sec "Multiple binary packages" rewritten
798     - Sec "Handling debconf translations" moved under an
799       "Internationalization" section, and some edits
800     - Sec "Internationalized Documentation" added under Sec
801       "Internationalization"
802     - Sec "Specific packaging practices" renamed to "Common packaging situations"
803     - Sec "Packages using autoconf/automake" rewritten
804     - Sec "Configuration management" moved forward in practices chapter
805     - Sec "Other specific packages" renamed to "Specific types of
806       packages", add info for SGML/XML and Lisp packages
807     - Sec "Writing useful descriptions" heavily edited
808     - Sec "Best practices for maintainer scripts" added, special credit
809       here to Charles Briscoe-Smith for work dating back to 1998; include
810       a POSIX shell snippet showing how to check if a command is the PATH,
811       closes: #150384
812     - Apdx "Overview of Debian Maintainer Tools": remove debget, it's
813       rather useless and broken
814     - normalize up-casing on sections, which should only up-case proper
815       names and the first word
816     - new 'translation-status' script to check status of translations,
817       adapted from doc-check in boot-floppies, source pkg only --
818       oh my, French translation is 54 CVS revisions behind, and Japanese
819       is 108 behind
820     - postinst: don't set /usr/doc symlink, aesthetics
821     - prerm: don't use 'command -v', it's not POSIX
822     - rules: produce md5sums file; break out a 'test' target
823
824  -- Adam Di Carlo <aph@debian.org>  Sat,  7 Dec 2002 02:28:06 -0500
825
826 developers-reference (3.1.2) unstable; urgency=low
827
828   * Josip Rodin:
829     - DDP publishing update
830   * Adam Di Carlo:
831     - doc-base file includes French and Japanese files
832     - debsign invocation was slightly wrong, closes: #170523
833     - Sec "Handling debconf translations", updates from Martin Quinson
834       for po-debconf with minimal editorial changes, closes: #169007
835
836  -- Adam Di Carlo <aph@debian.org>  Wed, 27 Nov 2002 21:16:30 -0500
837
838 developers-reference (3.1.1) unstable; urgency=low
839
840   * Josip Rodin:
841     - updated IRC stuff, thanks to Ben Armstrong, closes: #161403
842     - fixed/updated/extended stuff about bugs, hoping to address the
843       issue of people abusing the changelog bug closing feature
844   * Raphaël Hertzog:
845     - added myself as co-author
846     - fix a typo in Sec "Collaborative maintenance", closes: #161488
847   * Matt Zimmerman:
848     - updated security information, merging in Joey's stuff from the
849       Security Team FAQ and various updates and clarifications
850   * Adam Di Carlo
851     - fix some bad URLs, closes: #168357
852     - fix a grammar typo, closes: #166098
853
854  -- Adam Di Carlo <aph@debian.org>  Tue, 12 Nov 2002 23:15:03 -0500
855
856 developers-reference (3.1) unstable; urgency=low
857
858   * Raphaël Hertzog:
859     - Corrected several errors with &mdash;
860     - Applied patch from Peter Palfrader, correcting
861       the URL for the Debian Voting Information page. closes: #150427
862     - Applied patch from Matej Vela, dpkg-buildpackage does no more
863       require -sa for version -0.1. closes: #150861
864     - Applied the reformulations proposed by David Kimdon. closes: #150572
865     - Applied the patch of Matt Zimmerman. Thanks Matt! closes: #145287
866     - Added the explanation about how to replace an .orig.tar.gz.
867       closes: #150392
868     - Mostly deleted the paragraph about security upload in the
869       section explaining source NMU. Just added a link to point to
870       "Handling security-related bugs". closes: #159935
871     - Added a link to the Technical Committee web page (in the "Bug
872       housekeeping" section). closes: #151365
873     - Explain uploads to testing-proposed-updates, mentions briefly
874       stable-security and testing-security. closes: #149666
875       Removed the comment about uploads to frozen.
876     - Documented the "Developer's packages overview" web portal.
877       closes: #158650
878     - Added a reference to debian-l10n-english in "Writing useful
879       descriptions". closes: #158609
880     - Added a Best Packaging Practice section for "Packages using
881       autoconf/automake". closes: #158045
882     - Documented associated features to db.debian.org like SSH key
883       replication and *.debian.net DNS entry. closes: #155389
884     - Added a section about "Bug Squashing Parties".
885   * Josip Rodin:
886     - removed obsolete, needless dupload variables
887     - applied linguistic fixes from David Kimdon, closes: #150572
888     - random proofreading, mostly changing he -> they
889     - added people.d.o and non-us.d.o to the Debian servers section, and
890       mostly rewrote it to exclude real machine names and be better organized
891     - updated the mailing lists section
892   * Adam Di Carlo
893     - debian/changelog: remove obsolete Emacs variables
894     - editorial review of the changes above, minor tagging changes,
895       spelling fixes
896
897  -- Adam Di Carlo <aph@debian.org>  Tue, 10 Sep 2002 21:57:41 -0400
898
899 developers-reference (3.0) unstable; urgency=low
900
901   * Adam Di Carlo:
902     - welcome Manoj Srivastava as a co-maintainer
903     - welcome Raphael Hertzog as a co-maintainer
904
905     - new Chapter "Resource for Debian Developers", incorporating
906       the former chapters
907        Ch "Mailing Lists, Servers, and Other Machines"
908        Ch "The Debian Archive"
909   
910     - new Chapter "Managing Packages", incorporating former chapters
911        Ch "Package uploads"
912        Ch "Non-Maintainer Uploads (NMUs)"
913        Ch "Porting and Being Ported"
914        Ch "Moving, Removing, Renaming, Adopting, and Orphaning Packages"
915        Ch "Handling Bugs" (retitled "Handling package bugs")
916        Sec "Bug housekeeping" (new section, some parts stubbed out)
917      
918     - new Chapter "Beyond Packaging" recommends ways to contribute
919       to Debian beyond issues of package maintenance; incoporates
920       Ch "Interaction with Prospective Developers", retitled to
921           Sec "Interacting with Prospective Debian Developers"
922       Sec "Submitting Bugs", renamed to "Reporting Bugs"
923       Sec "QA" moved here from old Sec "Quality Assurance effort"
924       Sec "Dealing with unreachable maintainers"
925
926     - Sec "The Developers Database" added under Resources
927     - new Sec "Collaborative Maintenance" concerning multiple maintainers
928       for one package
929
930     - Sec "Getting started": add link to New Maintainers' Guide
931     - Sec "Debian Mentors" renamed to "Debian Mentors and Sponsors",
932       we add some info on sponsoring; also in Sec "Sponsoring packages"
933     - Section's first word capitalized, rest are normal case
934     - purge a reference to the Packaging Manual; closes: #145039
935     - misc. cross-referencing with new or moved sections
936     - change some literal quotes to &lsquo;, &rdquo;, etc.
937     - tagging improvements: replace <tt> with <file> for files and
938       directories; since <tt><var> and <example><var> doesn't look right,
939       work-around with &lt;...&gt;
940     - entity'ize master.debian.org, us-upload-dir, non-us-upload-dir
941     - update copyright date
942     - some simplifications on the TeX suffix rule
943     - spell check and grammar corrections
944     - s/GPG/GnuPG/
945
946   * Raphael Hertzog:
947     - changed -e by -m in the dpkg-buildpackage command line example;
948       closes: #110310
949     - clarify wording between "porter upload", "binary-only NMU", "simple
950       recompile"; closes: #102626
951     - extended "removing a package"; closes: #135560
952     - Ch "Best Packaging Practices": new chapter, including new
953       Sec "Writing useful descriptions" as a first entry in that
954       chapter; closes: #53109, #129848
955     - indicate that the list of subsections is defined in the policy;
956       closes: #123586
957     - removed some cruft in `Announcing package uploads'
958     - document the testing scripts; closes: #129445
959     - explain how to reassign/close bugs of removed packages; 
960       closes: #130255
961     - updates the note about software subject to US patents; 
962       closes: #142798
963     - new Section "Contacting other maintainers" under "Beyond packaging"
964       Document the package@packages.debian.org alias; closes: #114553
965     - new Section "Package's information" under Resources
966       Document http://packages.debian.org/<package>,
967       http://bugs.debian.org/<package> and the madison utility
968     - Sec "Reporting bugs": added http://bugs.debian.org/from:email@isp.com
969     - Sec "Handling bugs": added http://bugs.debian.org/login@debian.org
970     - Sec "The Incoming system" in "Resources", describe how it works and
971       also speak of the DELAYED directory; closes: #135562, #136774
972     - spelling fixes
973     - Sec "Developer Database": added a sentence about finger
974       login@debian.org
975     - update the total number of packages and the example directory tree
976       of a Debian archive
977     - updated the list of available architectures.
978     - commented out the "Subsections" section since it will RSN have nothing
979       to with the Debian archive. It's just a generic information field
980       of the package and nothing more.
981     - added more incentive to use experimental since it doesn't cause
982       any pain to the ftpmasters.
983     - Sec "When to do a source NMU": updated the NMU "protocol" and suggest
984       the use of the delayed queue.
985     - new Section "Acknowledging the NMUs" to explain the need to integrate
986       the changes introduced by NMUs. Insists on the fact that one shouldn't
987       be upset by a NMU.
988     - stubbed in new Section "Collaborative maintenance"
989     - stubbed in new Section "The Package Tracking System"
990     - Sec "The Package Tracking System": filled with content from
991       Francesco Paolo Lovergine, heavily updated by myself
992     - new Section "Managing sponsored packages" contributed by
993       Francesco Paolo Lovergine, slightly updated by myself
994     - new Sec "Bug housekeeping"; closes: #39519
995     - new Sec "Voting"
996     - new Sec "Documentation"
997     - added Sec "IRC channels" in the Resources chapter
998     - added Sec "pbuilder" in the appendix. Mention it in the section
999       "Being kind to porter" too
1000     - extended Sec "devscripts" with info about "bts" and "uscan"
1001     - completed Sec "Helper scripts"
1002     - completed Sec "Package with multiple patches",
1003       "Multiple binary packages", "Libraries", "Other specific packages",
1004       "The wise use of debconf" -- all those are quite simplistic, they
1005       can be improved
1006     - integrated Sec "Handling debconf translations" contributed by
1007       Denis Barbier -- thanks, Denis!
1008
1009   * Antoine Hulin:
1010     - update French translation
1011
1012  -- Adam Di Carlo <aph@debian.org>  Fri, 14 Jun 2002 01:18:19 -0400
1013
1014 developers-reference (2.11) unstable; urgency=low
1015
1016   * Antoine Hulin:
1017     - some grammar corrections
1018     - update French translation
1019   * Martin Michlmayr:
1020     - changes in upload situation, not possible to remove from Incoming
1021       anymore; closes: #135559
1022     - also talk about dput a tiny bit
1023   * Adam Di Carlo:
1024     - Ch "Overview of Debian Maintainer Tools":
1025       - improve the intro
1026       - Charles Briscoe-Smith deprecates yada (I think new maintainers of
1027         that would be welcome)
1028       - debconf-doc mentioned for debconf
1029       - debhelper: don't talk about debmake; mention how to get info on the dh-* pkgs
1030       - dput: new section, closes: #129378
1031       - debootstrap: new section, closes: #129377
1032       - dpkg-dev-el: new section
1033       - other minor wording changes
1034     - Sec "Mailing Lists": where to find private archives, closes: #96780
1035     - Ch "Package uploads":
1036       - new Sec "Adding an entry to debian/changelog"
1037       - rename Sec "Announcing new packages" to "New packages"
1038     - crypto is in main, non-US is for patent restrictions, so:
1039       - excise some text from "Registering as a Debian developer"
1040       - changes in Sec "Uploading to ftp-master"
1041       - changes in Sec "Uploading to non-US"
1042   * old bugs closed out, closes: #110573
1043
1044  -- Adam Di Carlo <aph@debian.org>  Sun,  7 Apr 2002 23:34:08 -0700
1045
1046 developers-reference (2.10.0) unstable; urgency=low
1047
1048   * from Martin Michlmayr
1049     - update the "Applying to Become a New Maintainer" section, with
1050       review by Raphael Hertzog, closes: #133965
1051     - bugs closed in NMUs should uses 'closes' changelog entries,
1052       closes: #133951
1053     - developers are not required to subscribe to debian-private
1054       closes: #133955
1055     - some suggestions on places to use the proper term, Debian GNU/Linux,
1056       closes: #133953
1057     - fix some typos, closes: #133956
1058   * Adam Di Carlo:
1059     - frozen doesn't exist anymore, just testing; note, however, that
1060       there is a way to upload to 'woody-proposed-updates' -- if I can
1061       find some description of that, I'll document it; closes: #133948
1062     - minor build tweaks
1063     - minor cosmetics
1064     - isolate a few more language-independent bits
1065   * from Chris Tillman
1066     - change /usr/doc to /usr/share/doc, and typo in debian/copyright,
1067       closes: #126924
1068
1069  -- Adam Di Carlo <aph@debian.org>  Sun, 24 Feb 2002 14:46:46 -0500
1070
1071 developers-reference (2.9.0) unstable; urgency=low
1072
1073   * Josip Rodin: 
1074     - created a new subsection about uploading to stable, and elaborated
1075       about that subject
1076     - removed a stray sentence about stable from the paragraph about
1077       security uploads (which apply to all distributions equally)
1078     - replaced the nonexistent term "Security Manager" with "security officer"
1079     - uploading to stable and unstable is deprecated; updated the section
1080       about the experimental distribution; other fixes in the section
1081       talking about uploading to distributions
1082     - better organize some subsections in the section about package uploads
1083     - replaced some bogus <ftppath>s with <tt>s
1084     - noted how there is an upload queue on pandora, too
1085   * Antoine Hulin:
1086     - French translation updated
1087   * Adam Di Carlo:
1088     - normalize '--' as &mdash; for prettier output
1089     - integrate changes from James Troup, part of #102626
1090     - typo fix thanks to Mark Hodge
1091
1092  -- Adam Di Carlo <aph@debian.org>  Sun, 21 Oct 2001 01:03:01 -0400
1093
1094 developers-reference (2.8.8) unstable; urgency=low
1095
1096   * from Josip Rodin:
1097     - a few more strong words about sponsoring
1098     - started a new chapter about the relationship between old and new
1099       developers
1100
1101  -- Adam Di Carlo <aph@debian.org>  Fri, 20 Jul 2001 17:53:47 -0400
1102
1103 developers-reference (2.8.7) unstable; urgency=low
1104
1105   * French updates
1106   * fix a typo in a link
1107   * dpkg-buildpackage -m<addr> flag was changed for -e<addr> when NMU'ing;
1108     update documentation accordingly
1109     closes: #101676
1110   * Matt Zimmerman fixes up some wording in the section talking about
1111     forwarding bugs upstream
1112     closes: #98312
1113   * provide proper l10n for SGML date entities; now we have &date-<LANG>
1114     entities which should be used
1115   * debian/rules: fixes for new debiandoc-sgml
1116   * debian/control: depend on debiandoc-sgml 1.1.48 or better
1117
1118  -- Adam Di Carlo <aph@debian.org>  Thu, 21 Jun 2001 14:43:42 -0400
1119
1120 developers-reference (2.8.6) unstable; urgency=low
1121
1122   * fix a typo, thanks to Antoine Hulin
1123   * French version: completely up-to-date now
1124   * Makefile: add a 'validate' target
1125   * prepare and ship "upstream" ChangeLog; move the debian changelog to
1126     changelog.Debian.gz
1127   * all versions: change the email address to use when orphaning
1128     closes: #93727
1129
1130  -- Adam Di Carlo <aph@debian.org>  Fri, 13 Apr 2001 03:32:08 -0400
1131
1132 developers-reference (2.8.5) unstable; urgency=low
1133
1134   * expunge references to the Debian Packaging Manual, which is now in the
1135     Policy
1136   * Japanese version: also comment out some references packaging manual;
1137     this translation needs updating
1138   * deny request to shut down non-maintainer bug maintenance bug closure
1139     practices (closes: Bug#88623)
1140   * add some advice about U.S. citizens uploading to non-US
1141     (closes: Bug#89694)
1142   * debian/control: Build-Depends should have been Build-Depends-Indep
1143   * French version: First complete translation of the Debian developer's
1144     reference guide.  Much work done by Antoine Hulin. Reviewed by Nicolas
1145     Bertolissio.
1146   * Portuguese version: work is started by Carlos Laviola, nothing
1147     included yet, however
1148
1149  -- Adam Di Carlo <aph@debian.org>  Sun,  8 Apr 2001 01:25:51 -0400
1150
1151 developers-reference (2.8.4) unstable; urgency=low
1152
1153   * debian/control: remove reference to obsolete packaging-manual package
1154     (closes: Bug#86505)
1155   * debian/control: fill in the description a bit more
1156   * doc-base: index.html corrected to be index.en.html
1157     (closes: Bug#85933)
1158   * Makefile: clean is cleaner
1159
1160  -- Adam Di Carlo <aph@debian.org>  Sun, 25 Feb 2001 12:47:06 -0500
1161
1162 developers-reference (2.8.3) unstable; urgency=low
1163
1164   * build and provide French and Japanese versions
1165   * devolve build logic from debian/rules to top-level Makefile
1166   * developers-reference.jp.sgml: minor changes so it will build (is out
1167     of date)
1168   * debian/rules: stop making useless /usr/share/developers-reference dir
1169
1170  -- Adam Di Carlo <aph@debian.org>  Mon, 22 Jan 2001 02:02:02 -0500
1171
1172 developers-reference (2.8.2) unstable; urgency=low
1173
1174   * Josip Rodin:
1175     - fix typographic errors reported by David Martinez (closes: Bug#80740)
1176     - common.ent: upped the numbers a little bit, updated lintian reports URL
1177     - updated regarding va->klecker move, and www->people move, changed
1178       most mentions of dinstall to a generic term "archive maintenance
1179       software", removed full path to it because it is in PATH now,
1180       mentioned "dak" and "katie" (somewhat vaguely), changed week to
1181       month regarding FTP archive waiting time since that\'s more often
1182       the case, and changed weeks to hours regarding Maintainers file
1183       updates since that\'s also more often the case now, updated some
1184       URLs to entities, s/debian-doc/doc-debian/
1185     - replaced evil latin1-only quotation marks, replaced mentions of
1186       important severity (in RCB context) with serious severity, some
1187       details fixed
1188     - common.ent (1.10): fixed email-debian-user alias; updated
1189       sample-dist-dirtree (with more to come)
1190     - described testing; described package pools (this particular part
1191       required quite a bit of changes, and it might be a bit rough, but
1192       it's a start); described the frozen test cycles et al; some other
1193       smaller fixes
1194     - another update WRT sid/unstable/testing, from Colin Watson
1195       (closes: Bug#80896)
1196   * debian/control: add Recommends for debian-policy, packaging-manual 
1197   * update copyright notice for 2001
1198   * fix for WNPP bug filing severities from David Schleef
1199   * clarify the status of the Developers's reference as "normative"
1200   * add a reference to debconf (closes: Bug#82413)
1201
1202  -- Adam Di Carlo <aph@debian.org>  Sun, 21 Jan 2001 18:10:21 -0500
1203
1204 developers-reference (2.8.1) unstable; urgency=low
1205
1206   * update WNPP instructions, based on patch from Marcelo E. Magallon 
1207     (closes: Bug#69435)
1208   * spelling corrections, awkward grammar suggestions from Andreas Krueger 
1209     (closes: Bug#72810)
1210   * debian/rules: remove some obsolete source-depends stuff
1211
1212  -- Adam Di Carlo <aph@debian.org>  Sat,  4 Nov 2000 13:22:21 -0500
1213
1214 developers-reference (2.8.0) unstable; urgency=low
1215
1216   * Almost all changes for this release are from Josip Rodin
1217     <joy@debian.org>. Thanks, Josip!
1218
1219   * debian/control, postinst, prerm, rules: Policy 3.2.1 (closes:
1220     Bug#68929, Bug#70384)
1221   * fixed bug closing example (closes: Bug#71198)
1222   * update the perl regexp from current /usr/lib/dpkg/parsechangelog/debian
1223   * updated keyring/keyserver information (closes: Bug#67783)
1224   * updated new-maintainer stuff (closes: Bug#67841)
1225   * updated for master -> ftp-master move (closes: Bug#68369)
1226   * noted www.d.o is the right host for web pages, but all other machines
1227     could be used if necessary
1228   * reorder mentions of scp to come before FTP, as it is more secure;
1229     mention the rsync dupload method
1230   * reorder mentions of pandora <-> non-us, canonical name non-us is
1231     better
1232   * other small corrections
1233   * fixed orphaning/adopting instructions with regard to the new WNPP
1234   * common.ent: fix urls for cvs.d.o, wnpp, Debian machines page, 
1235     lists-archives, www.d.o BTS
1236   * common.ent: changed link for machines from devel/maintainer_contacts
1237     to the db.d.o CGI
1238   * Makefile: remove unnecessary subshell
1239
1240   * Adam's change: update debian/copyright for new Policy, and put my name
1241     in there a bit with updated years; update doc-base file for FHS
1242
1243  -- Adam Di Carlo <aph@debian.org>  Sun, 15 Oct 2000 03:25:21 -0400
1244
1245 developers-reference (2.7.2) frozen unstable; urgency=medium
1246
1247   * I believe this should go into frozen because (a) it's only
1248     documentation, so it can't introduce RC bugs, and (b) it fixes an
1249     error which prevented it from building properly; however, whatever
1250     ftpmaster feels is best is fine
1251   *
1252   * include common.ent as well as version.ent 
1253     (closes: Bug#52582, Bug#48926)
1254   * debian/rules: fix build error caused by newer debiandoc-sgml; remove
1255     constitution.en.html, since that is now located in the doc-debian
1256     package (closes: Bug#54778, Bug#42014); don't compress .pdf file
1257   *
1258   * All changes below from Raphael Hertzog <hertzog@debian.org>
1259   *
1260   * Sec. "Uploading to master" and "Uploading to pandora": 
1261     explained dinstall -n (closes: Bug#45079)
1262   * Sec. "Picking a distribution": added reference to the debian-release
1263     team (closes: Bug#52906)
1264   * Sec. "Announcing package uploads": rewrote it to take care of the fact
1265     that dinstall is doing it automatically (closes: Bug#43877)
1266   * Sec. "Mailing lists": added a paragraph about debian-email
1267     (closes: Bug#40258)
1268   * Changed the "Maintaining Your Debian Information" into "Debian
1269     Developer's Duties" (closes: Bug#28908)
1270     - added a section about the LDAP database
1271     - added a section about the "on vacation" message
1272     - added a section about the coordination with upstream developers
1273       (closes: Bug#43878)
1274     - added a section about managing Release Critical bugs
1275     - added a section about Quality Assurance effort
1276
1277  -- Adam Di Carlo <aph@debian.org>  Sun, 16 Apr 2000 23:24:33 -0400
1278
1279 developers-reference (2.7.1) unstable; urgency=low
1280
1281   * Sec. "Registering as a Debian developer": we are transitioning away
1282     from non-free PGP -- remove allusions to non-free software such as
1283     PGPv2 or v5 insofar as possible; recommend use of DSS keys rather than
1284     RSA
1285   * Sec. "Maintaining Your Public Key": remove PGP-centric stuff
1286   * Sec. "When bugs are closed by new uploads": describe how to close bugs
1287     via a magic changelog entry (closes: Bug#43690)
1288   * Sec. "Generating the changes file": refer to Sec. "When bugs are
1289     closed by new uploads" for closing bugs via a changelog entry
1290   * developers-reference.sgml: re-enable RCS variables in CVS sources
1291   * debian/control,rules: dynamically generate the TOC in the package
1292     description from developers-reference.sgml
1293
1294  -- Adam Di Carlo <aph@debian.org>  Sun, 12 Sep 1999 18:15:59 -0400
1295
1296 developers-reference (2.7.0) unstable; urgency=low
1297
1298   * developers-reference.sgml: separated out language-independant elements
1299     into common.ent (not content changes); misc minor grammar changes
1300     throughout
1301   * doc-base: change section for *constitution* to Debian (not 'debian')
1302     (closes Bug#37392)
1303   * Sec. "Stable, unstable, and sometimes frozen": mention how old stable
1304     releases are available at archive.debian.org
1305   * Sec. "Uploading to pandora (non-us)" added, remove stale
1306     information about the old anonymous ftp area (closes Bug#39541);
1307     Sec. "Other Upload Queues" added about that upload queues, added
1308     samosa and master.debian.org.jp (closes Bug#37804)
1309   * Sec. "Yada": mention that yada might not be as robust as other package
1310     producing systems, at request of the author; Sec. "equivs" added
1311   * Sec. "Moving packages": at the request of Guy Maor, clarify that this
1312     procedure is for moving packages in sections (i.e., free, contrib)
1313     only
1314   * Sec. "Registering as a Debian developer": talk about RSA keys rather
1315     than PGP keys, since I think GPG can create/handle them now; mention
1316     that the official pkg maintainer address much match an ID on your key;
1317   * Sec. "Maintaining Your Public Key": beef up the warnings a bit; point
1318     to the PGP FAQ
1319   * Sec. "Mailing Lists, Servers, and Other Machines": clean up and
1320     clarify section; mention that all developers are expected to be
1321     subscribed to debian-private and debian-devel-announce
1322   * Sec. "Other Debian Machines": remove list of machines; point to
1323     http://www.debian.org/devel/machines instead
1324   * Sec. "Release code names": potato is 2.2
1325   * Sec. "Guidelines for Porter Uploads": talk about recompile only
1326     uploads and version numbers for this (i.e., foo_2.4-1.0.1), from a
1327     suggestion from James Troup
1328   * Sec. "buildd": mention andrea, and buildd.debian.org
1329   * Sec. "Removing packages": correct apt-cache usage
1330   * debain/rules: update standards to 3.0.1 -- since I'm not moving
1331     /usr/doc to /usr/share/doc yet, no changes were required except in the
1332     text here and there
1333
1334  -- Adam Di Carlo <aph@debian.org>  Mon, 16 Aug 1999 23:29:45 -0400
1335
1336 developers-reference (2.6.8) unstable; urgency=low
1337
1338   * when applying as a new user, the login name can be *eight* characters,
1339     not seven (thanks to Rafael Caetano dos Santos)
1340
1341  -- Adam Di Carlo <aph@debian.org>  Fri, 21 May 1999 21:50:04 -0400
1342
1343 developers-reference (2.6.7) unstable; urgency=low
1344
1345   * SGML'ish: normalize SGML elements, refill paragraphs (closes Bug#37987)
1346   * doc-base: change section to Debian -- hmm, this looks like a doc-base
1347     bug, really, but hey, who am I to refile bugs to another one of my own
1348     packages? (closes Bug#37392)
1349   * Ch. "Overview of Debian Maintainer Tools": new section for yada (um,
1350     someone who uses this should check my description), correct build ->
1351     debuild in the devscripts section (closes Bug#38053)
1352
1353  -- Adam Di Carlo <aph@debian.org>  Fri, 21 May 1999 01:41:45 -0400
1354
1355 developers-reference (2.6.6) unstable; urgency=low
1356
1357   * Sec. "The master server": note that problems on Debian ftp can be sent
1358     to ftpmaster@debian.org also
1359   * Secs. "Uploads via chiark" and "Uploads via erlangen": remove
1360     'cron-driven' (thanks Roman Hodek)
1361   * Sec. "Being Kind to Porters": typos corrected, note that binary-arch
1362     and binary-indep targets should work independantly (thanks Roman
1363     Hodek)
1364   * Sec. "buildd": remove erroneous reference to debbuild, reorganize the
1365     section and correct typos (thank again Roman -- boy, this is the all
1366     Roman release)
1367   * debian/rules: re-enable letter-sized PDFs
1368
1369  -- Adam Di Carlo <aph@debian.org>  Sun,  9 May 1999 01:17:29 -0400
1370
1371 developers-reference (2.6.5) unstable; urgency=low
1372
1373   * Sec. "Architectures": correction on supported architecture in Linux
1374     2.2, from Job Bogan
1375   * Sec. "Experimental": other reasons to use or not use the experiment
1376     archive "section", from comments by Guy Maor
1377   * Sec. "Being Kind to Porters": replace x86 with i386 (closes Bug#36485)
1378   * debian/rules: date printing protected from local l10n (closes Bug#36891)
1379   * Ch. "Mailing Lists, Servers, and Other Machines": renamed chapter; add
1380     intro paragraph
1381   * Sec. "Debian Servers": new, for talking about the standard servers,
1382     with intro; demoted server sections under that
1383   * Sec. "The FTP servers": was empty, removed
1384   * Sec. "The master server": fill in more info and cross-refs on how to
1385     report problems
1386   * Sec. "The CVS server": add some more detail which should be included
1387     when requesting cvs areas; mention the cvsweb URL
1388   * Sec. "Other Debian Machines": new section, list the machines for which
1389     a normal developer may have access.
1390
1391  -- Adam Di Carlo <aph@debian.org>  Tue,  4 May 1999 03:32:21 -0400
1392
1393 developers-reference (2.6.4) unstable; urgency=low
1394
1395   * debian/rules: hack 'byhand' file entries to include debian version
1396     number in it, so subsequent uploads of the package into Incoming don't
1397     step all over each other
1398
1399  -- Adam Di Carlo <aph@debian.org>  Fri,  9 Apr 1999 20:04:04 -0400
1400
1401 developers-reference (2.6.3) unstable; urgency=low
1402
1403   * correction from James Troup -- <keyring-maint> is indeed the correct
1404     address for PGP key updates
1405
1406  -- Adam Di Carlo <aph@debian.org>  Sun,  4 Apr 1999 13:28:58 -0400
1407
1408 developers-reference (2.6.2) unstable; urgency=low
1409
1410   * Sec. "fakeroot": libtricks is not replacing anything after all
1411   * developers-reference.sgml: use public declaration
1412   * BTW, if any maintainers of translated versions of this document would
1413     like to talk to me about folding your version into the
1414     developers-reference CVS area, please get in touch with me
1415
1416  -- Adam Di Carlo <aph@debian.org>  Sun,  4 Apr 1999 04:42:29 -0400
1417
1418 developers-reference (2.6.1) unstable; urgency=low
1419
1420   * include Debian constitution (closes Bug#30694)
1421   * Sec. "fakeroot": libtricks is replacing fakeroot, not libtool
1422   * Sec. "Maintaining Your Public Key" -- give email addresses as
1423     {pgp,gpg}-update@debian.org, at James Troup's request (note to Jameas,
1424     if you see this: /usr/doc/debian-keyring/README.gz talks about
1425     <keyring-maint> instead)
1426   * Ch. "Overview of Debian Maintainer Tools" -- add Sec. "debget"
1427   * developers-reference.sgml: minor typo correction from Tril
1428     <dem@tunes.org>
1429   * doc-base stuff: add abstract to developers-reference, new file for
1430     constitution
1431   * debian/rules: minor cleanup and consistency; build PDF, not PS file;
1432     ship PDF file;.text file now has .txt extension
1433   * debian/control: set priority to optional, matching archive
1434
1435  -- Adam Di Carlo <aph@debian.org>  Sat,  3 Apr 1999 17:17:06 -0500
1436
1437 developers-reference (2.6.0) frozen unstable; urgency=low
1438
1439   * would be nice to sneak this into slink; it's just documentation!
1440   * Ch. "Porting and Being Ported": porter information broken out into it's
1441     own chapter, Sec. "Guidelines for Porter Uploads" and "When to do a
1442     source NMU if you are a porter" moved to this chapter; porter tool
1443     descriptions such as 'quinn-diff' moved to this section.  Sec. "Being
1444     Kind to Porters" added, with tips for how to avoid making problems for
1445     porters.
1446   * Ch. "Non-Maintainer Uploads (NMUs)": update for the new chapter, and
1447     tighten up the language a bit
1448   * Sec. "Monitoring bugs": add a little cron job to get an 'index maint'
1449     of outstanding bugs (closes Bug#31259), loosen language a tiny bit
1450     w.r.t. non-maintainers or submitters closing bugs (closes Bug#30394)
1451   * Sec. "Scope of This Document": point out that this file is not
1452     official policy
1453   * Ch. "Handling Bugs": renamed from "Handling Bug Reports", incorporate
1454     some suggestions from James Troup, namely, don't mail from your root
1455     account, don't close bugs via control@bugs.debian.org; break out new
1456     sections, "Submitting Bugs" and "Responding to Bugs"
1457   * Ch. "Overview of Debian Maintainer Tools": remove attribution for
1458     package maintainers, since I can't keep up; add entries for fakeroot
1459     and devscripts
1460   * Ch. "Maintaining Your Debian Information": new chapter, quite small
1461     right now; it mentions keyring-maint@debian.org for key modification,
1462     warns against putting private keys on multi-user machines, and talks
1463     about how to depart Debian gracefully
1464   * typo correction from Christian Hudon (closes Bug#32052)
1465   * menu file removed, obsoleted by doc-base file
1466   * parameterize some often-changing values with SGML entities, update
1467     number of available packages
1468   * use new way of notating multiple copyrights
1469   * change <tt> elements to <file> where appropriate
1470
1471  -- Adam Di Carlo <aph@debian.org>  Thu, 11 Feb 1999 02:53:55 -0500
1472
1473 developers-reference (2.5.0.5) unstable; urgency=low
1474
1475   * add version.ent to docdir, needed to reconstruct from SGML 
1476     (closes Bug#31034)
1477
1478  -- Adam Di Carlo <aph@debian.org>  Tue, 29 Dec 1998 02:42:50 -0500
1479
1480 developers-reference (2.5.0.4) unstable; urgency=low
1481
1482   * not officially released
1483   * more spelling corrections
1484   * s/ppc/powerpc/ (thanks, James Troup)
1485
1486  -- Adam Di Carlo <aph@debian.org>  Fri, 18 Dec 1998 00:07:40 -0500
1487
1488 developers-reference (2.5.0.3) unstable; urgency=low
1489
1490   * not officially released
1491   * Sec. "Removing a package from Incoming": tiny section added
1492   * some PGP-centricity removed
1493   * Sec. "Adopting a package": point out that hijacking packages is not ok 
1494   * Ch. "Non-Maintainer Uploads (NMUs) and Porters": change 'NMU' to
1495     'source NMU', 'port' to 'binary NMU', shorten the window for porters a
1496     tad; fix spelling; stress that non-maintainer patches must be
1497     non-disruptive and that aesthetic issues are not suitable for fixing
1498     by non-maintainers; other fixes as suggested by interested parties
1499
1500  -- Adam Di Carlo <aph@debian.org>  Wed, 25 Nov 1998 00:01:27 -0500
1501
1502 developers-reference (2.5.0.2) frozen unstable; urgency=low
1503
1504   * not officially released
1505   * maintainer name change (but it's still me)
1506   * Ch. "Non-Maintainer Uploads (NMUs) and Porters":  new chapter
1507     discussing NMUs and porters; Section "Interim Releases" integrated out
1508     of existance.  New TOC for this section is:
1509          * 6 Non-Maintainer Uploads (NMUs) and Porters
1510             + 6.1 Who can do a port or an NMU
1511             + 6.2 When to do a port or an NMU
1512                  o 6.2.1 When to do an NMU if you are a porter
1513             + 6.3 How to do an NMU
1514                  o 6.3.1 NMU version numbering
1515                  o 6.3.2 NMUs must create a changelog entry
1516                  o 6.3.3 NMUs must send patches, if any, to the BTS
1517                  o 6.3.4 Building the NMU
1518             + 6.4 Guidelines for Porters
1519   
1520   * Sec. "Maintainer changes": renamed to "Adopting a package" and moved
1521     to Chapter "Moving, Removing, Renaming, Adopting, and Orphaning
1522     Packages".
1523   * Sec. "Reporting lots of bugs at once": more forcefully deprecate this
1524     practice
1525   * Sec. "Adopting a package": mention that the BTS maintainer update can
1526     take a couple of weeks
1527   * Sec. "Overview of Debian Maintainer Tools": give credit where credit
1528     is due and attribute current maintainers; add `apt'; add `quinn-diff';
1529     add mention of as yet unreleased 'buildd' package, since I'm so
1530     excited about it and can't wait
1531   * Sec. "Removing packages": talk about how apt-cache can be used to look
1532     at reverse depends, a good step to take prior to removing a package
1533     from the archive
1534   * show *full* TOC, including sect2
1535   * of course the obligatory typo, grammar, and spelling corrections
1536
1537   * Makefile: small changes to accomodate DDP autobuild
1538   * debian/dirs: obsolete, removed
1539   * debian/rules: use changelog date for SGML timestamping, not current date
1540
1541  -- Adam Di Carlo <aph@debian.org>  Fri, 20 Nov 1998 12:27:53 -0500
1542
1543 developers-reference (2.5.0) frozen unstable; urgency=low
1544
1545   * move to 3-level version number:
1546     top-level version number probably won't change for a while, it is the
1547     "major", the second-level number means significant content changes,
1548     and the third-level change means corrections and minor improvements.
1549     Since this version has significant content changes, we are now 2.5.0.
1550     Since I'm going to put porter instructions in the next major rev, that
1551     will be 2.6.0...
1552
1553   * use new <package> tag where appropriate (Ardo, you rock)
1554   * replace 'm86k' with 'm68k'
1555   * rename 'Whirlwind Tour of ...' section to 'Overview of ...' (suggested 
1556     by James Troup)
1557   * typos and "red-pen" corrections, fix cosmetic problems in PostScript
1558     version
1559   * remove the one case I use an URL fragment identifier, since
1560     debiandoc-sgml doesn't like it (bug filed against debiandoc-sgml)
1561   * debian/rules: cosmetic cleanups, loosen check for root
1562   * debian/rules: build PostScript version during build, since it's nice
1563     to have all my debiandoc2* scripts together
1564   * debian/control: policy compliant to 2.5.0
1565
1566   * advise against uploading when a package has lintian problems of
1567     severity 'E'
1568   * "Mailing Lists and Servers":
1569     - "The master server": mention how master is the home of the BTS;
1570       mention how users need to take care with their accounts on master
1571     - "The WWW servers": fill in www.debian.org, first pass, and discuss
1572       how to put up your own web pages on va or master
1573     - "The CVS server": new section added
1574     - "Mirrors of Debian servers": new section added; point to info about
1575        how to mirror
1576   * "Applying to Become a Maintainer": do not advise resending initial
1577     application; instead, simply mail a followup asking new maintainers
1578     whether they go the initial application (closes Bug #28739); mention
1579     that calls usually come in the evening; mention that if you use PGP
1580     v5, you need to generate an RSA key (right?); clarify our intentions
1581     with respect to GPG.
1582   * "Release code names": Debian 2.2 is 'potato'
1583   * "Distribution directories": give concrete examples, hopefully making
1584     it clearer where to look in Debian archives for specific stuff;
1585     mention that old distributions are moved to archive servers (is there
1586     a canonical location?)
1587   * "The override file": new section, added under "Notification that a new
1588     package has been installed"; fill it out quite a bit
1589   * "Uploading to *": reiterate thrice not to upload export
1590     controlled-software to master, or the European queues on erlangen and
1591     chiark
1592   * "Picking a distribution": section broken out from "Generating the
1593     changes file"
1594   * "Uploading to frozen": new section, almost straight from Brian White
1595     (hope you don't mind!) -- isn't that topical?
1596   * "Interim releases": if you NMU a new upstream version (0.1), run 
1597     'dpkg-buildpackage -sa'
1598
1599  -- Adam P. Harris <aph@debian.org>  Thu, 12 Nov 1998 00:03:43 -0500
1600
1601 developers-reference (2.4.1.5) unstable; urgency=low
1602
1603   * Fix instructions for new maintainers, incorporating the actual text
1604     sent to prospective new maintainers.  Improve this text a bit for
1605     readability, coverage, and organization.  Significant changes were
1606     patched back to the new-maintainers group, if they care to use
1607     them. (closes Bug#26948)
1608   * Add an introductory "Scope" chapter which helps delineate what should
1609     and should not be included in this Reference.
1610   * Add a new chapter, "Whirlwind Tour of Debian Maintainer Tools".  Let
1611     me know what useful tools I forgot -- remember, Debian-specific
1612     maintainer tools only!
1613   * Add discussion of the "experimental" distribution, culled from an email
1614     from Guy Maor on debian-devel.
1615   * Incorporated suggestions from Branden Robinson (closes Bug#27211).
1616   * Point to doc-debian's mailing list instructions where relevant.
1617   * Made references to online documentation into URLs where possible.
1618   * Little corrections here and there.
1619   * add a Makefile for use in the DDP manual hierarchy
1620   * debian/rules: comment out my 'source-depends' hack; it's just slowing
1621     things down
1622
1623  -- Adam P. Harris <aph@debian.org>  Thu,  1 Oct 1998 03:42:43 -0400
1624
1625 developers-reference (2.4.1.4) unstable; urgency=low
1626
1627   * fill in Section "The master server" a bit; other servers to follow
1628   * in Section "Distribution directories", mention that distributions
1629     are always in 'dists' subdir of the Debian archive; talk about
1630     'proposed-updates'
1631   * in Section "Release code names", talk about 'sid' a bit
1632   * in Section "Interim releases", talk about how non-maintainers should
1633     use the BTS, and bug severity "fixed" (closes Bug#17524)
1634   * in Section "Generating the changes file", talk about how to set the
1635     distribution in the debian/changelog file (i.e., "frozen unstable")
1636   * add a new Section "Checking the package prior to upload" to Section
1637     "Uploading a package", mentioning lintian and other tests one should
1638     do prior to uploading
1639   * add new Section "Notification that a new package has been installed"
1640     in Section "Uploading a package", talking about dinstall and the
1641     override file a bit
1642   * add new Sections "Moving packages", "Removing packages", "Replacing or
1643     renaming packages", and "Orphaning a package" (closes Bug#26650)
1644   * add new Section "Bugs in your packages", talking about maintainer
1645     duties with respect to bugs
1646   * add new Section "Lintian reports" under "Handling bugs reports",
1647     talking about how maintainers should check their packages with lintian 
1648     every now and then, alternatively pointing them to the lintian web
1649     pages
1650   * clarify, a bit, the use of "section" and "subsection", bringing it
1651     into line with the usage in the Policy Manual and Packaging Manual
1652   * grammar and markup changes throughout
1653   * debian/rules: added a crude source-depends rule, which renders more
1654     explicit what is used to build this package
1655
1656  -- Adam P. Harris <aph@debian.org>  Mon, 21 Sep 1998 00:51:46 -0400
1657
1658 developers-reference (2.4.1.3) unstable; urgency=low
1659
1660   * new maintainer
1661   * version number and date are automatically populated now
1662   * changed doc-base section to "debian"
1663   * debian/rules: better abstraction and organization
1664   * reformat SGML like I happen to like it
1665   * utilize the new URL tag
1666   * build PostScript on letter size, I hear thats better for A4 and US
1667     letter printing
1668
1669  -- Adam P. Harris <aph@debian.org>  Thu, 16 Jul 1998 00:52:35 -0400
1670
1671 developers-reference (2.4.1.2) frozen unstable; urgency=low
1672
1673   * non-maintainer release
1674   * rebuilt since HTML versions of Chapters 1 and 2 were truncated
1675     (important bug, no number yet, bugs.debian.org isn't working;
1676     regardless, this should go in hamm because a broken developers
1677     reference won't win us many friends in hamm, and after all, it's just
1678     text, it can't hurt you.)
1679   * no content changes, except that the version number in the SGML file
1680     reflect this packages version number
1681   * debian/rule: clean is cleaner now
1682
1683  -- Adam P. Harris <aph@debian.org>  Tue, 16 Jun 1998 01:35:39 -0400
1684
1685 developers-reference (2.4.1.1) frozen unstable; urgency=low
1686
1687   * Orphaned package
1688
1689  -- Christian Schwarz <schwarz@debian.org>  Thu, 14 May 1998 21:56:36 +0200
1690
1691 developers-reference (2.4.1.0) frozen unstable; urgency=low
1692
1693   * New version numbering scheme:
1694   
1695     - The version numbers are independent of dpkg now, but all policy
1696       manuals (the Debian Policy Manual, the Debian Packaging Manual, and
1697       the Debian Developer's Reference) share the same version numbering
1698       scheme.
1699     
1700     - The first three digits of the version number specify the
1701       `Standards-Version.' This number is incremented with each policy
1702       change. The fourth digit represents the `patch-level,' which may
1703       differ between the manuals. 
1704   
1705       If only the patch-level digit is incremented, no changes in policy
1706       have been made, except bug fixes and clarifications. Packages only
1707       have to specify the first three digits of the version number in the
1708       `Standards-Version' field of their source packages.
1709   
1710   * Uploaded to frozen and unstable. This is a documentation-only
1711     package and the changes to the manual are relevant for hamm.
1712
1713   * No changes to the Developer's Reference
1714   
1715  -- Christian Schwarz <schwarz@debian.org>  Mon, 13 Apr 1998 17:54:43 +0200
1716
1717 developers-reference (0.5) unstable; urgency=low
1718
1719   * Changes to the Developer's Reference:
1720   
1721     - Changed section 1.2 Registering as a Debian developer:
1722       + signatures from formal certification service are _NOT_ accepted
1723         anymore
1724       + images of ID documents have to be PGP or RSA signed
1725       (as requested by James Troup)
1726   
1727     - Use current date instead of <date> in manual
1728     
1729   * Updated FSF's address (reported by Lintian)
1730
1731  -- Christian Schwarz <schwarz@debian.org>  Sat,  7 Mar 1998 13:52:15 +0100
1732
1733 developers-reference (0.4) unstable; urgency=low
1734
1735   * Changes to the Developer's Reference:
1736
1737     - Renamed chapter 4 into `Package uploads'
1738
1739     - New section 4.2.5 Uploading to the non-us server
1740
1741     - Changed section 4.4 Interim releases:
1742       + non-maintainer releases should not close bugs
1743       + normal maintainer must at least read the patch provided with
1744         the non-maintainer release
1745
1746     - New chapter 5 Handling bug reports:
1747       + when reporting more then 10 bugs on the same topic, a message
1748         has to be sent to debian-devel and the `maintonly' address
1749         should be used
1750
1751     - Lots of typos fixed
1752
1753   * Compressed SGML source code
1754
1755   * Added support for doc-base to register the Developer's Reference
1756     to the online documentation systems dwww and dhelp
1757
1758   * Upgraded to standards version 2.4.0.0 (no changes)
1759   
1760  -- Christian Schwarz <schwarz@debian.org>  Fri, 30 Jan 1998 21:58:34 +0100
1761   
1762 developers-reference (0.3) unstable; urgency=low
1763
1764   * Put lost sections from Policy Manual 2.1.3.3 back in:
1765       - Generating the changes file (for uploads)
1766       - Announcing package uploads
1767   * New section about Debian Mentors
1768   * debian/rules: Don't use debstd anymore
1769   * debian/rules: Compress changelog file (fixes:#15441)
1770   * Fixed link to WNPP list (fixes:#16201)
1771   * Added menu entry (fixes:#15708)
1772   
1773  -- Christian Schwarz <schwarz@debian.org>  Wed, 24 Dec 1997 13:54:33 +0100
1774   
1775 developers-reference (0.2) unstable; urgency=low
1776
1777   * New chapter about `The Debian Archive' describing the structure
1778     of our FTP server and the development process
1779   * Added note that new maintainers have to read the Social Contract
1780     and have to know where to find the Policy and Packaging Manuals
1781   * PGP key ring is not distributed via dpkg but in doc/ of the FTP
1782     server
1783   * Added note that cross posting between Debian lists is depreciated
1784   * New list of advantages why new packages should be discussed on
1785     debian-devel before they are uploaded
1786   * Added section about how packages are uploaded
1787   * Added note that the Security Managers may do interim releases without 
1788     contacting the maintainer
1789   * Removed chapter about bug tracking system (will be included in
1790     a new manual released soon)
1791   * Some minor changes
1792   * Include SGML source in package
1793   * Don't use `2-up' style for PostScript version
1794   * Upgraded to Standards 2.3.0.1
1795
1796  -- Christian Schwarz <schwarz@debian.org>  Sun,  2 Nov 1997 20:53:26 +0100
1797   
1798 developers-reference (0.1) unstable; urgency=low
1799
1800   * Initial Release.
1801
1802  -- Christian Schwarz <schwarz@debian.org>  Tue, 8 Jul 1997 00:19:49 +0200
1803