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