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