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