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