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