chiark / gitweb /
1c7fe07893dd40b1bed8f40ec3e18a6a9abb0257
[developers-reference.git] / debian / changelog
1 developers-reference (3.3.6) unstable; urgency=low
2
3   * Andreas Barth
4     - closes: and NMUs/experimental uploads. Closes: #284714
5     - madison is on merkel.
6     - more gender-neutral. Closes: #290583, #290584
7     - explain current incoming. Closes: #290019
8     - remove broken sponsoring URL. Closes: #291698
9     - add handling hints about orig.tar.gz. Thanks, Frank. Closes: #278524
10     - duplicate bug reports should be merged. Closes: #285381
11     - if you're on vacation, please check whether someone needs keysigning.
12       Closes: #285458
13     - freenode has developer cloacks. Closes: #285687
14   * Frédéric Bothamy
15     - French translation updated to version 3.3.6
16
17  -- Andreas Barth <aba@not.so.argh.org>  Sun, 23 Jan 2005 16:08:49 -0700
18
19 developers-reference (3.3.5) unstable; urgency=low
20
21   * Andreas Barth
22     - uploads to more than one dist are not possible.
23     - updated upload queues. Closes: #235213
24     - updated URL of vanilla rules files. Closes: #237557, #252048
25     - please speak with stable RM before uploading to stable. Closes: #261464
26     - information on wnpp usage synced with wnpp. Closes: #255298
27     - spelling, grammer fixes.
28       Closes: #202444, #202499, #203202, #203378, #221902, #226208
29     - add hint about partitial key id. Closes: #243968
30     - spohr is restriced, and also ftp-master. Closes: #255814
31     - bpp: Hint about locale generation as non-root. Closes: #208021
32     - bpp: deborphan-compliant transition packages. Closes: #183654
33     - add myself to uploaders.
34     - add chapter about i10n. Closes: #208156
35     - add information about dchroot. Closes: #211845
36     - add information about NEWS.Debian. Closes: #212402
37     - add information about mia-database. Closes: #213961
38     - add link to debian-mentors FAQ.
39     - add verbose information about the package description. Closes: #214792
40     - add hint about -v<version> to experimental. Closes: #232930
41     - update information about yada. Closes: #217956
42     - urgency is sticky. Closes: #261914
43     - updated information about testing distribution. Closes: #266649.
44     - rewrote the NMU section, and
45       + made the possible severities of "target bugs" clearer. Closes: #233088.
46       + mention QA uploads. Closes: #202416.
47       + add -B for binNMUs, and local debsign usage. Closes: #208839.
48       + warning about breaking all-packages by binNMU. Closes: #213348.
49     - add information about gpg usage. Closes: #175815.
50     - make key replacement instructions more details. Closes: #275921
51     - typo and language fixes. Thanks, Era Eriksson. Closes: #277576
52     - add hints about debconf templates from Christian Perrier.
53   * Matt Zimmerman
54     - Security uploads get urgency=high
55     - Be even more explicit about not uploading security updates
56   * Frédéric Bothamy
57     - French translation updated to version 3.3.5
58
59  -- Andreas Barth <aba@not.so.argh.org>  Mon, 22 Nov 2004 19:07:26 +0100
60
61 developers-reference (3.3.4) unstable; urgency=low
62
63   * Josip Rodin:
64     - fixed language in the PTS section, prompted by a patch from
65       Romain FRANCOISE, thank you; closes: #197741
66     - updated the mailing lists section (again)
67     - documented Alioth, somewhat
68   * Frédéric Bothamy
69     - French translation updated to version 3.3.3 (more or less)
70     - proofread by Patrice Karatchentzeff
71   * Matt Zimmerman
72     - Don't upload security updates directly to stable
73     - Always include an external reference in security changelog entries
74     - Be careful not to re-use a version number in security uploads
75     - More explicit instructions about what is appropriate for a security
76       upload
77
78   * Adam Di Carlo
79     - replace <!entity...> with <!ENTITY...> and other SGML hygenics
80     - build refinements
81     - Release this package as is to flush changes between June and now.
82       Yes, its been an age between releases here, for which I apologize.
83       Since CVS upstream for this package is back, I'm working on closing
84       bugs in this package now, I just wanted to get it out as is before I
85       started.
86
87  -- Adam Di Carlo <aph@debian.org>  Sun, 29 Feb 2004 14:09:48 -0500
88
89 developers-reference (3.3.3) unstable; urgency=low
90
91   * Frédéric Bothamy
92     - corrections by Michel Grentzinger
93   * Raphaël Hertzog
94     - updated documentation concerning the PTS
95     - added a paragraph about the PTS web interface
96     - documented how to add custom news item in the PTS
97   * Matt Zimmerman
98     - updates and clarifications to instructions for security bugs
99     - deprecate uploads to stable for security fixes, reference
100       section on security bugs; closes: #196516
101     - use dpkg-buildpackage -B to test binary-arch, not -b;
102       closes: #196555
103   * Adam Di Carlo
104     - Sec "Managing sponsored packages": remove unnecessary 'debsign' cmd;
105       closes: #192417
106     - fix debconf-devel(7) man page section; closes: #189512
107     - Sec "Responding to bugs": mention what FTBFS means; closes: #186605
108     - Sec "Distribution directories" renamed "Distributions"
109     - Sec "The testing distribution" moved under Sec "Distribution
110       directories" and renamed "More information about the testing
111       distribution"
112     - Secs "Uploads to {stable,testing-proposed-updates}" retitled to make
113       it clear these are special cases
114     - Sec "Uploading to ftp-master": xref to "Delayed incoming"; 
115       closes: #195997
116     - check compliance with Policy version 3.5.10
117
118  -- Adam Di Carlo <aph@debian.org>  Mon, 16 Jun 2003 04:08:29 -0400
119
120 developers-reference (3.3.2) unstable; urgency=low
121
122   * Frédéric Bothamy:
123     - French translation updated to version 3.3.1
124     - proofread by Philippe Batailler and Patrice Karatchentzeff
125   * Adam Di Carlo:
126     - French translation requires debiandoc-sgml 1.1.76 or better
127
128  -- Adam Di Carlo <aph@debian.org>  Fri, 18 Apr 2003 09:48:59 -0400
129
130 developers-reference (3.3.1) unstable; urgency=low
131
132   * Josip Rodin:
133     - package description said it contained French and Japanese, fixed,
134       closes: #182614
135     - Sec "Experimental": sources.list entries
136     - Sec "Basic rules for [mailing list] use": cosmetic, link to this sec
137     - Sec "Handling bugs": retitle and expand section
138   * Adam Di Carlo:
139     - more improvements to package synopsis and description
140     - the synopsis formula changed to either
141        <package-name> is a <synopsis>
142       or
143        <package-name> is <synopsis>
144       or
145        <package-name> are <synopsis>
146       closes: #182956
147     - the synopsis itself should not start with an article
148     - Sec "Best practices for debian/control": expand intro
149     - fix doc-check URL; closes: #187144
150     - Sec "Multiple binary packages": fix awkward wording about vim source
151       package; closes: #187143
152
153  -- Adam Di Carlo <aph@debian.org>  Fri,  4 Apr 2003 14:26:52 -0500
154
155 developers-reference (3.3) unstable; urgency=low
156
157   * Frédéric Bothamy:
158     - French translation updated to version 3.2.2 (more or less)
159     - proofread by Philippe Batailler
160   * Raphaël Hertzog:
161     - added "ddtp" keyword in the PTS documentation
162   * Josip Rodin:
163     - split out the doc-files per language, closes: #177448
164     - shuffled stuff around in the packages chapter
165     - added a section describing how to handle large amounts of
166       architecture-independent data bundled with programs
167     - added best practices on debian/changelog files, based on a patch
168       kindly provided by Daniel Kobras, closes: #166388
169     - described debdiff and dpkg-depcheck, and linked to them from the
170       right places in the document, closes: #172897
171     - describe the current practice in writing synopsis lines,
172       closes: #174161
173   * Adam Di Carlo:
174     - update (c) year
175     - convert to debhelper (compat mode 4); maintainer scripts no longer
176       needed
177     - split -ja and -fr versions out into separate packages
178     - top-level makefile deletes targets on error; clean is cleaner
179     - replace the manual debian/control processing to show the document's
180       table of contents (TOC) with a new script 'debian/tocsubstvars';
181       note that the TOC displayed in the developers-reference-{fr,ja}
182       package descriptions are in English until UTF8 control files are
183       allowed; proper escaping of single quotes here requires newest
184       debhelper
185     - editorial changes on material added in this version
186     - reorder "Best Packaging Practices" a bit
187     - rework "Best practices for debian/control" based on contributions
188       from Colin Walters, Branden Robinson, Sebastian Rittau and others;
189       closes: #139957, #108416
190     - primary author is developers-reference@packages.debian.org; remove
191       emails from other authors to prevent spam and confusion
192
193  -- Adam Di Carlo <aph@debian.org>  Mon, 24 Feb 2003 13:29:07 -0500
194
195 developers-reference (3.2.2) unstable; urgency=low
196
197   * Josip Rodin:
198     - slightly rewrote and updated links in the mirrors section
199   * Adam Di Carlo:
200     - Policy compliance checked and updated to 3.5.8, no changes needed
201     - TODO: remove some tasks which are done
202     - ship README-contrib and TODO in the doc dir
203     - Sec "Upstream home page": some revisions based on discussion on
204       policy list
205     - Sec "Documentation" added under Sec "Common packaging situations"
206       for best practices for documentation
207     - Add tools entries for autotools-dev, dpkg-repack, alien, debsums;
208       new Sec "Documentation and information", add entries there for
209       debview, debiandoc-sgml, debian-keyring; we believe this manual now
210       covers all of the established, general Debian maintainer tool
211       packages
212     - spell-checking pass
213
214  -- Adam Di Carlo <aph@debian.org>  Thu, 12 Dec 2002 13:45:23 -0500
215
216 developers-reference (3.2.1) unstable; urgency=low
217
218   * Adam Di Carlo:
219     - Sec "Best practices for debian/control" added, Sec "Writing useful
220       descriptions" moved under there
221     - Sec "Upstream home page" added in debian/control section
222     - Sec "Miscellaneous advice" empty, removed
223     - Sec "Overview of maintainer tools": tools now categorized into
224       subgroups; do cross-linking from this section into other parts of
225       the document where these tools are discussed
226     - Sec "Overview of maintainer tools": add entries for sbuild,
227       build-essential, linda; improved entries for pbuilder, devscripts
228     - Sec "Tools for porters" renamed and readapted to "Porting
229       infrastructure and automation"; move tool discussion down to the
230       appendix; improve Sec "buildd" a bit
231     - README-contrib added giving information for authors, contributors,
232       and translators
233     - eliminate the ByHand stuff, I'm pretty sure it's not needed now
234       with the DDP builder process, or if it is needed, it's a probably
235       that can be fixed by DDP folks
236     - stop shipping SGML source -- use 'apt-get source developers-reference'
237       after all, this is supposed to be a binary package, right?
238     - simply PS and PDF building rules
239   
240  -- Adam Di Carlo <aph@debian.org>  Mon,  9 Dec 2002 03:04:19 -0500
241
242 developers-reference (3.2) unstable; urgency=low
243
244   * Josip Rodin:
245     - merged a bit misplaced lintian-reports section within the lintian
246       section and adjusted links
247     - added the missing description of dh-make and adjusted links
248   * Adam Di Carlo:
249     - ChangeLog attribution updates
250     - fix typos, closes: #171781
251     - expand the doc-base abstract and authors
252     - Ch "Packaging Practices" rewritten intro
253     - Sec "Packaging tools and common cases" renamed to "Best Practices
254       for debian/rules", and write an intro
255     - Sec "Helper scripts" in practices section rewritten, giving
256       arguments for and against debhelper, mostly for :)
257     - Sec "Package with multiple patches" renamed to "Patching source
258       versus patching at build time" and rewritten
259     - Sec "Multiple binary packages" rewritten
260     - Sec "Handling debconf translations" moved under an
261       "Internationalization" section, and some edits
262     - Sec "Internationalized Documentation" added under Sec
263       "Internationalization"
264     - Sec "Specific packaging practices" renamed to "Common packaging situations"
265     - Sec "Packages using autoconf/automake" rewritten
266     - Sec "Configuration management" moved forward in practices chapter
267     - Sec "Other specific packages" renamed to "Specific types of
268       packages", add info for SGML/XML and Lisp packages
269     - Sec "Writing useful descriptions" heavily edited
270     - Sec "Best practices for maintainer scripts" added, special credit
271       here to Charles Briscoe-Smith for work dating back to 1998; include
272       a POSIX shell snippet showing how to check if a command is the PATH,
273       closes: #150384
274     - Apdx "Overview of Debian Maintainer Tools": remove debget, it's
275       rather useless and broken
276     - normalize up-casing on sections, which should only up-case proper
277       names and the first word
278     - new 'translation-status' script to check status of translations,
279       adapted from doc-check in boot-floppies, source pkg only --
280       oh my, French translation is 54 CVS revisions behind, and Japanese
281       is 108 behind
282     - postinst: don't set /usr/doc symlink, aesthetics
283     - prerm: don't use 'command -v', it's not POSIX
284     - rules: produce md5sums file; break out a 'test' target
285
286  -- Adam Di Carlo <aph@debian.org>  Sat,  7 Dec 2002 02:28:06 -0500
287
288 developers-reference (3.1.2) unstable; urgency=low
289
290   * Josip Rodin:
291     - DDP publishing update
292   * Adam Di Carlo:
293     - doc-base file includes French and Japanese files
294     - debsign invocation was slightly wrong, closes: #170523
295     - Sec "Handling debconf translations", updates from Martin Quinson
296       for po-debconf with minimal editorial changes, closes: #169007
297
298  -- Adam Di Carlo <aph@debian.org>  Wed, 27 Nov 2002 21:16:30 -0500
299
300 developers-reference (3.1.1) unstable; urgency=low
301
302   * Josip Rodin:
303     - updated IRC stuff, thanks to Ben Armstrong, closes: #161403
304     - fixed/updated/extended stuff about bugs, hoping to address the
305       issue of people abusing the changelog bug closing feature
306   * Raphaël Hertzog:
307     - added myself as co-author
308     - fix a typo in Sec "Collaborative maintenance", closes: #161488
309   * Matt Zimmerman:
310     - updated security information, merging in Joey's stuff from the
311       Security Team FAQ and various updates and clarifications
312   * Adam Di Carlo
313     - fix some bad URLs, closes: #168357
314     - fix a grammar typo, closes: #166098
315
316  -- Adam Di Carlo <aph@debian.org>  Tue, 12 Nov 2002 23:15:03 -0500
317
318 developers-reference (3.1) unstable; urgency=low
319
320   * Raphaël Hertzog:
321     - Corrected several errors with &mdash;
322     - Applied patch from Peter Palfrader, correcting
323       the URL for the Debian Voting Information page. closes: #150427
324     - Applied patch from Matej Vela, dpkg-buildpackage does no more
325       require -sa for version -0.1. closes: #150861
326     - Applied the reformulations proposed by David Kimdon. closes: #150572
327     - Applied the patch of Matt Zimmerman. Thanks Matt! closes: #145287
328     - Added the explanation about how to replace an .orig.tar.gz.
329       closes: #150392
330     - Mostly deleted the paragraph about security upload in the
331       section explaining source NMU. Just added a link to point to
332       "Handling security-related bugs". closes: #159935
333     - Added a link to the Technical Committee web page (in the "Bug
334       housekeeping" section). closes: #151365
335     - Explain uploads to testing-proposed-updates, mentions briefly
336       stable-security and testing-security. closes: #149666
337       Removed the comment about uploads to frozen.
338     - Documented the "Developer's packages overview" web portal.
339       closes: #158650
340     - Added a reference to debian-l10n-english in "Writing useful
341       descriptions". closes: #158609
342     - Added a Best Packaging Practice section for "Packages using
343       autoconf/automake". closes: #158045
344     - Documented associated features to db.debian.org like SSH key
345       replication and *.debian.net DNS entry. closes: #155389
346     - Added a section about "Bug Squashing Parties".
347   * Josip Rodin:
348     - removed obsolete, needless dupload variables
349     - applied linguistic fixes from David Kimdon, closes: #150572
350     - random proofreading, mostly changing he -> they
351     - added people.d.o and non-us.d.o to the Debian servers section, and
352       mostly rewrote it to exclude real machine names and be better organized
353     - updated the mailing lists section
354   * Adam Di Carlo
355     - debian/changelog: remove obsolete Emacs variables
356     - editorial review of the changes above, minor tagging changes,
357       spelling fixes
358
359  -- Adam Di Carlo <aph@debian.org>  Tue, 10 Sep 2002 21:57:41 -0400
360
361 developers-reference (3.0) unstable; urgency=low
362
363   * Adam Di Carlo:
364     - welcome Manoj Srivastava as a co-maintainer
365     - welcome Raphael Hertzog as a co-maintainer
366
367     - new Chapter "Resource for Debian Developers", incorporating
368       the former chapters
369        Ch "Mailing Lists, Servers, and Other Machines"
370        Ch "The Debian Archive"
371   
372     - new Chapter "Managing Packages", incorporating former chapters
373        Ch "Package uploads"
374        Ch "Non-Maintainer Uploads (NMUs)"
375        Ch "Porting and Being Ported"
376        Ch "Moving, Removing, Renaming, Adopting, and Orphaning Packages"
377        Ch "Handling Bugs" (retitled "Handling package bugs")
378        Sec "Bug housekeeping" (new section, some parts stubbed out)
379      
380     - new Chapter "Beyond Packaging" recommends ways to contribute
381       to Debian beyond issues of package maintenance; incoporates
382       Ch "Interaction with Prospective Developers", retitled to
383           Sec "Interacting with Prospective Debian Developers"
384       Sec "Submitting Bugs", renamed to "Reporting Bugs"
385       Sec "QA" moved here from old Sec "Quality Assurance effort"
386       Sec "Dealing with unreachable maintainers"
387
388     - Sec "The Developers Database" added under Resources
389     - new Sec "Collaborative Maintenance" concerning multiple maintainers
390       for one package
391
392     - Sec "Getting started": add link to New Maintainers' Guide
393     - Sec "Debian Mentors" renamed to "Debian Mentors and Sponsors",
394       we add some info on sponsoring; also in Sec "Sponsoring packages"
395     - Section's first word capitalized, rest are normal case
396     - purge a reference to the Packaging Manual; closes: #145039
397     - misc. cross-referencing with new or moved sections
398     - change some literal quotes to &lsquo;, &rdquo;, etc.
399     - tagging improvements: replace <tt> with <file> for files and
400       directories; since <tt><var> and <example><var> doesn't look right,
401       work-around with &lt;...&gt;
402     - entity'ize master.debian.org, us-upload-dir, non-us-upload-dir
403     - update copyright date
404     - some simplifications on the TeX suffix rule
405     - spell check and grammar corrections
406     - s/GPG/GnuPG/
407
408   * Raphael Hertzog:
409     - changed -e by -m in the dpkg-buildpackage command line example;
410       closes: #110310
411     - clarify wording between "porter upload", "binary-only NMU", "simple
412       recompile"; closes: #102626
413     - extended "removing a package"; closes: #135560
414     - Ch "Best Packaging Practices": new chapter, including new
415       Sec "Writing useful descriptions" as a first entry in that
416       chapter; closes: #53109, #129848
417     - indicate that the list of subsections is defined in the policy;
418       closes: #123586
419     - removed some cruft in `Announcing package uploads'
420     - document the testing scripts; closes: #129445
421     - explain how to reassign/close bugs of removed packages; 
422       closes: #130255
423     - updates the note about software subject to US patents; 
424       closes: #142798
425     - new Section "Contacting other maintainers" under "Beyond packaging"
426       Document the package@packages.debian.org alias; closes: #114553
427     - new Section "Package's information" under Resources
428       Document http://packages.debian.org/<package>,
429       http://bugs.debian.org/<package> and the madison utility
430     - Sec "Reporting bugs": added http://bugs.debian.org/from:email@isp.com
431     - Sec "Handling bugs": added http://bugs.debian.org/login@debian.org
432     - Sec "The Incoming system" in "Resources", describe how it works and
433       also speak of the DELAYED directory; closes: #135562, #136774
434     - spelling fixes
435     - Sec "Developer Database": added a sentence about finger
436       login@debian.org
437     - update the total number of packages and the example directory tree
438       of a Debian archive
439     - updated the list of available architectures.
440     - commented out the "Subsections" section since it will RSN have nothing
441       to with the Debian archive. It's just a generic information field
442       of the package and nothing more.
443     - added more incentive to use experimental since it doesn't cause
444       any pain to the ftpmasters.
445     - Sec "When to do a source NMU": updated the NMU "protocol" and suggest
446       the use of the delayed queue.
447     - new Section "Acknowledging the NMUs" to explain the need to integrate
448       the changes introduced by NMUs. Insists on the fact that one shouldn't
449       be upset by a NMU.
450     - stubbed in new Section "Collaborative maintenance"
451     - stubbed in new Section "The Package Tracking System"
452     - Sec "The Package Tracking System": filled with content from
453       Francesco Paolo Lovergine, heavily updated by myself
454     - new Section "Managing sponsored packages" contributed by
455       Francesco Paolo Lovergine, slightly updated by myself
456     - new Sec "Bug housekeeping"; closes: #39519
457     - new Sec "Voting"
458     - new Sec "Documentation"
459     - added Sec "IRC channels" in the Resources chapter
460     - added Sec "pbuilder" in the appendix. Mention it in the section
461       "Being kind to porter" too
462     - extended Sec "devscripts" with info about "bts" and "uscan"
463     - completed Sec "Helper scripts"
464     - completed Sec "Package with multiple patches",
465       "Multiple binary packages", "Libraries", "Other specific packages",
466       "The wise use of debconf" -- all those are quite simplistic, they
467       can be improved
468     - integrated Sec "Handling debconf translations" contributed by
469       Denis Barbier -- thanks, Denis!
470
471   * Antoine Hulin:
472     - update French translation
473
474  -- Adam Di Carlo <aph@debian.org>  Fri, 14 Jun 2002 01:18:19 -0400
475
476 developers-reference (2.11) unstable; urgency=low
477
478   * Antoine Hulin:
479     - some grammar corrections
480     - update French translation
481   * Martin Michlmayr:
482     - changes in upload situation, not possible to remove from Incoming
483       anymore; closes: #135559
484     - also talk about dput a tiny bit
485   * Adam Di Carlo:
486     - Ch "Overview of Debian Maintainer Tools":
487       - improve the intro
488       - Charles Briscoe-Smith deprecates yada (I think new maintainers of
489         that would be welcome)
490       - debconf-doc mentioned for debconf
491       - debhelper: don't talk about debmake; mention how to get info on the dh-* pkgs
492       - dput: new section, closes: #129378
493       - debootstrap: new section, closes: #129377
494       - dpkg-dev-el: new section
495       - other minor wording changes
496     - Sec "Mailing Lists": where to find private archives, closes: #96780
497     - Ch "Package uploads":
498       - new Sec "Adding an entry to debian/changelog"
499       - rename Sec "Announcing new packages" to "New packages"
500     - crypto is in main, non-US is for patent restrictions, so:
501       - excise some text from "Registering as a Debian developer"
502       - changes in Sec "Uploading to ftp-master"
503       - changes in Sec "Uploading to non-US"
504   * old bugs closed out, closes: #110573
505
506  -- Adam Di Carlo <aph@debian.org>  Sun,  7 Apr 2002 23:34:08 -0700
507
508 developers-reference (2.10.0) unstable; urgency=low
509
510   * from Martin Michlmayr
511     - update the "Applying to Become a New Maintainer" section, with
512       review by Raphael Hertzog, closes: #133965
513     - bugs closed in NMUs should uses 'closes' changelog entries,
514       closes: #133951
515     - developers are not required to subscribe to debian-private
516       closes: #133955
517     - some suggestions on places to use the proper term, Debian GNU/Linux,
518       closes: #133953
519     - fix some typos, closes: #133956
520   * Adam Di Carlo:
521     - frozen doesn't exist anymore, just testing; note, however, that
522       there is a way to upload to 'woody-proposed-updates' -- if I can
523       find some description of that, I'll document it; closes: #133948
524     - minor build tweaks
525     - minor cosmetics
526     - isolate a few more language-independent bits
527   * from Chris Tillman
528     - change /usr/doc to /usr/share/doc, and typo in debian/copyright,
529       closes: #126924
530
531  -- Adam Di Carlo <aph@debian.org>  Sun, 24 Feb 2002 14:46:46 -0500
532
533 developers-reference (2.9.0) unstable; urgency=low
534
535   * Josip Rodin: 
536     - created a new subsection about uploading to stable, and elaborated
537       about that subject
538     - removed a stray sentence about stable from the paragraph about
539       security uploads (which apply to all distributions equally)
540     - replaced the nonexistent term "Security Manager" with "security officer"
541     - uploading to stable and unstable is deprecated; updated the section
542       about the experimental distribution; other fixes in the section
543       talking about uploading to distributions
544     - better organize some subsections in the section about package uploads
545     - replaced some bogus <ftppath>s with <tt>s
546     - noted how there is an upload queue on pandora, too
547   * Antoine Hulin:
548     - French translation updated
549   * Adam Di Carlo:
550     - normalize '--' as &mdash; for prettier output
551     - integrate changes from James Troup, part of #102626
552     - typo fix thanks to Mark Hodge
553
554  -- Adam Di Carlo <aph@debian.org>  Sun, 21 Oct 2001 01:03:01 -0400
555
556 developers-reference (2.8.8) unstable; urgency=low
557
558   * from Josip Rodin:
559     - a few more strong words about sponsoring
560     - started a new chapter about the relationship between old and new
561       developers
562
563  -- Adam Di Carlo <aph@debian.org>  Fri, 20 Jul 2001 17:53:47 -0400
564
565 developers-reference (2.8.7) unstable; urgency=low
566
567   * French updates
568   * fix a typo in a link
569   * dpkg-buildpackage -m<addr> flag was changed for -e<addr> when NMU'ing;
570     update documentation accordingly
571     closes: #101676
572   * Matt Zimmerman fixes up some wording in the section talking about
573     forwarding bugs upstream
574     closes: #98312
575   * provide proper l10n for SGML date entities; now we have &date-<LANG>
576     entities which should be used
577   * debian/rules: fixes for new debiandoc-sgml
578   * debian/control: depend on debiandoc-sgml 1.1.48 or better
579
580  -- Adam Di Carlo <aph@debian.org>  Thu, 21 Jun 2001 14:43:42 -0400
581
582 developers-reference (2.8.6) unstable; urgency=low
583
584   * fix a typo, thanks to Antoine Hulin
585   * French version: completely up-to-date now
586   * Makefile: add a 'validate' target
587   * prepare and ship "upstream" ChangeLog; move the debian changelog to
588     changelog.Debian.gz
589   * all versions: change the email address to use when orphaning
590     closes: #93727
591
592  -- Adam Di Carlo <aph@debian.org>  Fri, 13 Apr 2001 03:32:08 -0400
593
594 developers-reference (2.8.5) unstable; urgency=low
595
596   * expunge references to the Debian Packaging Manual, which is now in the
597     Policy
598   * Japanese version: also comment out some references packaging manual;
599     this translation needs updating
600   * deny request to shut down non-maintainer bug maintenance bug closure
601     practices (closes: Bug#88623)
602   * add some advice about U.S. citizens uploading to non-US
603     (closes: Bug#89694)
604   * debian/control: Build-Depends should have been Build-Depends-Indep
605   * French version: First complete translation of the Debian developer's
606     reference guide.  Much work done by Antoine Hulin. Reviewed by Nicolas
607     Bertolissio.
608   * Portuguese version: work is started by Carlos Laviola, nothing
609     included yet, however
610
611  -- Adam Di Carlo <aph@debian.org>  Sun,  8 Apr 2001 01:25:51 -0400
612
613 developers-reference (2.8.4) unstable; urgency=low
614
615   * debian/control: remove reference to obsolete packaging-manual package
616     (closes: Bug#86505)
617   * debian/control: fill in the description a bit more
618   * doc-base: index.html corrected to be index.en.html
619     (closes: Bug#85933)
620   * Makefile: clean is cleaner
621
622  -- Adam Di Carlo <aph@debian.org>  Sun, 25 Feb 2001 12:47:06 -0500
623
624 developers-reference (2.8.3) unstable; urgency=low
625
626   * build and provide French and Japanese versions
627   * devolve build logic from debian/rules to top-level Makefile
628   * developers-reference.jp.sgml: minor changes so it will build (is out
629     of date)
630   * debian/rules: stop making useless /usr/share/developers-reference dir
631
632  -- Adam Di Carlo <aph@debian.org>  Mon, 22 Jan 2001 02:02:02 -0500
633
634 developers-reference (2.8.2) unstable; urgency=low
635
636   * Josip Rodin:
637     - fix typographic errors reported by David Martinez (closes: Bug#80740)
638     - common.ent: upped the numbers a little bit, updated lintian reports URL
639     - updated regarding va->klecker move, and www->people move, changed
640       most mentions of dinstall to a generic term "archive maintenance
641       software", removed full path to it because it is in PATH now,
642       mentioned "dak" and "katie" (somewhat vaguely), changed week to
643       month regarding FTP archive waiting time since that\'s more often
644       the case, and changed weeks to hours regarding Maintainers file
645       updates since that\'s also more often the case now, updated some
646       URLs to entities, s/debian-doc/doc-debian/
647     - replaced evil latin1-only quotation marks, replaced mentions of
648       important severity (in RCB context) with serious severity, some
649       details fixed
650     - common.ent (1.10): fixed email-debian-user alias; updated
651       sample-dist-dirtree (with more to come)
652     - described testing; described package pools (this particular part
653       required quite a bit of changes, and it might be a bit rough, but
654       it's a start); described the frozen test cycles et al; some other
655       smaller fixes
656     - another update WRT sid/unstable/testing, from Colin Watson
657       (closes: Bug#80896)
658   * debian/control: add Recommends for debian-policy, packaging-manual 
659   * update copyright notice for 2001
660   * fix for WNPP bug filing severities from David Schleef
661   * clarify the status of the Developers's reference as "normative"
662   * add a reference to debconf (closes: Bug#82413)
663
664  -- Adam Di Carlo <aph@debian.org>  Sun, 21 Jan 2001 18:10:21 -0500
665
666 developers-reference (2.8.1) unstable; urgency=low
667
668   * update WNPP instructions, based on patch from Marcelo E. Magallon 
669     (closes: Bug#69435)
670   * spelling corrections, awkward grammar suggestions from Andreas Krueger 
671     (closes: Bug#72810)
672   * debian/rules: remove some obsolete source-depends stuff
673
674  -- Adam Di Carlo <aph@debian.org>  Sat,  4 Nov 2000 13:22:21 -0500
675
676 developers-reference (2.8.0) unstable; urgency=low
677
678   * Almost all changes for this release are from Josip Rodin
679     <joy@debian.org>. Thanks, Josip!
680
681   * debian/control, postinst, prerm, rules: Policy 3.2.1 (closes:
682     Bug#68929, Bug#70384)
683   * fixed bug closing example (closes: Bug#71198)
684   * update the perl regexp from current /usr/lib/dpkg/parsechangelog/debian
685   * updated keyring/keyserver information (closes: Bug#67783)
686   * updated new-maintainer stuff (closes: Bug#67841)
687   * updated for master -> ftp-master move (closes: Bug#68369)
688   * noted www.d.o is the right host for web pages, but all other machines
689     could be used if necessary
690   * reorder mentions of scp to come before FTP, as it is more secure;
691     mention the rsync dupload method
692   * reorder mentions of pandora <-> non-us, canonical name non-us is
693     better
694   * other small corrections
695   * fixed orphaning/adopting instructions with regard to the new WNPP
696   * common.ent: fix urls for cvs.d.o, wnpp, Debian machines page, 
697     lists-archives, www.d.o BTS
698   * common.ent: changed link for machines from devel/maintainer_contacts
699     to the db.d.o CGI
700   * Makefile: remove unnecessary subshell
701
702   * Adam's change: update debian/copyright for new Policy, and put my name
703     in there a bit with updated years; update doc-base file for FHS
704
705  -- Adam Di Carlo <aph@debian.org>  Sun, 15 Oct 2000 03:25:21 -0400
706
707 developers-reference (2.7.2) frozen unstable; urgency=medium
708
709   * I believe this should go into frozen because (a) it's only
710     documentation, so it can't introduce RC bugs, and (b) it fixes an
711     error which prevented it from building properly; however, whatever
712     ftpmaster feels is best is fine
713   *
714   * include common.ent as well as version.ent 
715     (closes: Bug#52582, Bug#48926)
716   * debian/rules: fix build error caused by newer debiandoc-sgml; remove
717     constitution.en.html, since that is now located in the doc-debian
718     package (closes: Bug#54778, Bug#42014); don't compress .pdf file
719   *
720   * All changes below from Raphael Hertzog <hertzog@debian.org>
721   *
722   * Sec. "Uploading to master" and "Uploading to pandora": 
723     explained dinstall -n (closes: Bug#45079)
724   * Sec. "Picking a distribution": added reference to the debian-release
725     team (closes: Bug#52906)
726   * Sec. "Announcing package uploads": rewrote it to take care of the fact
727     that dinstall is doing it automatically (closes: Bug#43877)
728   * Sec. "Mailing lists": added a paragraph about debian-email
729     (closes: Bug#40258)
730   * Changed the "Maintaining Your Debian Information" into "Debian
731     Developer's Duties" (closes: Bug#28908)
732     - added a section about the LDAP database
733     - added a section about the "on vacation" message
734     - added a section about the coordination with upstream developers
735       (closes: Bug#43878)
736     - added a section about managing Release Critical bugs
737     - added a section about Quality Assurance effort
738
739  -- Adam Di Carlo <aph@debian.org>  Sun, 16 Apr 2000 23:24:33 -0400
740
741 developers-reference (2.7.1) unstable; urgency=low
742
743   * Sec. "Registering as a Debian developer": we are transitioning away
744     from non-free PGP -- remove allusions to non-free software such as
745     PGPv2 or v5 insofar as possible; recommend use of DSS keys rather than
746     RSA
747   * Sec. "Maintaining Your Public Key": remove PGP-centric stuff
748   * Sec. "When bugs are closed by new uploads": describe how to close bugs
749     via a magic changelog entry (closes: Bug#43690)
750   * Sec. "Generating the changes file": refer to Sec. "When bugs are
751     closed by new uploads" for closing bugs via a changelog entry
752   * developers-reference.sgml: re-enable RCS variables in CVS sources
753   * debian/control,rules: dynamically generate the TOC in the package
754     description from developers-reference.sgml
755
756  -- Adam Di Carlo <aph@debian.org>  Sun, 12 Sep 1999 18:15:59 -0400
757
758 developers-reference (2.7.0) unstable; urgency=low
759
760   * developers-reference.sgml: separated out language-independant elements
761     into common.ent (not content changes); misc minor grammar changes
762     throughout
763   * doc-base: change section for *constitution* to Debian (not 'debian')
764     (closes Bug#37392)
765   * Sec. "Stable, unstable, and sometimes frozen": mention how old stable
766     releases are available at archive.debian.org
767   * Sec. "Uploading to pandora (non-us)" added, remove stale
768     information about the old anonymous ftp area (closes Bug#39541);
769     Sec. "Other Upload Queues" added about that upload queues, added
770     samosa and master.debian.org.jp (closes Bug#37804)
771   * Sec. "Yada": mention that yada might not be as robust as other package
772     producing systems, at request of the author; Sec. "equivs" added
773   * Sec. "Moving packages": at the request of Guy Maor, clarify that this
774     procedure is for moving packages in sections (i.e., free, contrib)
775     only
776   * Sec. "Registering as a Debian developer": talk about RSA keys rather
777     than PGP keys, since I think GPG can create/handle them now; mention
778     that the official pkg maintainer address much match an ID on your key;
779   * Sec. "Maintaining Your Public Key": beef up the warnings a bit; point
780     to the PGP FAQ
781   * Sec. "Mailing Lists, Servers, and Other Machines": clean up and
782     clarify section; mention that all developers are expected to be
783     subscribed to debian-private and debian-devel-announce
784   * Sec. "Other Debian Machines": remove list of machines; point to
785     http://www.debian.org/devel/machines instead
786   * Sec. "Release code names": potato is 2.2
787   * Sec. "Guidelines for Porter Uploads": talk about recompile only
788     uploads and version numbers for this (i.e., foo_2.4-1.0.1), from a
789     suggestion from James Troup
790   * Sec. "buildd": mention andrea, and buildd.debian.org
791   * Sec. "Removing packages": correct apt-cache usage
792   * debain/rules: update standards to 3.0.1 -- since I'm not moving
793     /usr/doc to /usr/share/doc yet, no changes were required except in the
794     text here and there
795
796  -- Adam Di Carlo <aph@debian.org>  Mon, 16 Aug 1999 23:29:45 -0400
797
798 developers-reference (2.6.8) unstable; urgency=low
799
800   * when applying as a new user, the login name can be *eight* characters,
801     not seven (thanks to Rafael Caetano dos Santos)
802
803  -- Adam Di Carlo <aph@debian.org>  Fri, 21 May 1999 21:50:04 -0400
804
805 developers-reference (2.6.7) unstable; urgency=low
806
807   * SGML'ish: normalize SGML elements, refill paragraphs (closes Bug#37987)
808   * doc-base: change section to Debian -- hmm, this looks like a doc-base
809     bug, really, but hey, who am I to refile bugs to another one of my own
810     packages? (closes Bug#37392)
811   * Ch. "Overview of Debian Maintainer Tools": new section for yada (um,
812     someone who uses this should check my description), correct build ->
813     debuild in the devscripts section (closes Bug#38053)
814
815  -- Adam Di Carlo <aph@debian.org>  Fri, 21 May 1999 01:41:45 -0400
816
817 developers-reference (2.6.6) unstable; urgency=low
818
819   * Sec. "The master server": note that problems on Debian ftp can be sent
820     to ftpmaster@debian.org also
821   * Secs. "Uploads via chiark" and "Uploads via erlangen": remove
822     'cron-driven' (thanks Roman Hodek)
823   * Sec. "Being Kind to Porters": typos corrected, note that binary-arch
824     and binary-indep targets should work independantly (thanks Roman
825     Hodek)
826   * Sec. "buildd": remove erroneous reference to debbuild, reorganize the
827     section and correct typos (thank again Roman -- boy, this is the all
828     Roman release)
829   * debian/rules: re-enable letter-sized PDFs
830
831  -- Adam Di Carlo <aph@debian.org>  Sun,  9 May 1999 01:17:29 -0400
832
833 developers-reference (2.6.5) unstable; urgency=low
834
835   * Sec. "Architectures": correction on supported architecture in Linux
836     2.2, from Job Bogan
837   * Sec. "Experimental": other reasons to use or not use the experiment
838     archive "section", from comments by Guy Maor
839   * Sec. "Being Kind to Porters": replace x86 with i386 (closes Bug#36485)
840   * debian/rules: date printing protected from local l10n (closes Bug#36891)
841   * Ch. "Mailing Lists, Servers, and Other Machines": renamed chapter; add
842     intro paragraph
843   * Sec. "Debian Servers": new, for talking about the standard servers,
844     with intro; demoted server sections under that
845   * Sec. "The FTP servers": was empty, removed
846   * Sec. "The master server": fill in more info and cross-refs on how to
847     report problems
848   * Sec. "The CVS server": add some more detail which should be included
849     when requesting cvs areas; mention the cvsweb URL
850   * Sec. "Other Debian Machines": new section, list the machines for which
851     a normal developer may have access.
852
853  -- Adam Di Carlo <aph@debian.org>  Tue,  4 May 1999 03:32:21 -0400
854
855 developers-reference (2.6.4) unstable; urgency=low
856
857   * debian/rules: hack 'byhand' file entries to include debian version
858     number in it, so subsequent uploads of the package into Incoming don't
859     step all over each other
860
861  -- Adam Di Carlo <aph@debian.org>  Fri,  9 Apr 1999 20:04:04 -0400
862
863 developers-reference (2.6.3) unstable; urgency=low
864
865   * correction from James Troup -- <keyring-maint> is indeed the correct
866     address for PGP key updates
867
868  -- Adam Di Carlo <aph@debian.org>  Sun,  4 Apr 1999 13:28:58 -0400
869
870 developers-reference (2.6.2) unstable; urgency=low
871
872   * Sec. "fakeroot": libtricks is not replacing anything after all
873   * developers-reference.sgml: use public declaration
874   * BTW, if any maintainers of translated versions of this document would
875     like to talk to me about folding your version into the
876     developers-reference CVS area, please get in touch with me
877
878  -- Adam Di Carlo <aph@debian.org>  Sun,  4 Apr 1999 04:42:29 -0400
879
880 developers-reference (2.6.1) unstable; urgency=low
881
882   * include Debian constitution (closes Bug#30694)
883   * Sec. "fakeroot": libtricks is replacing fakeroot, not libtool
884   * Sec. "Maintaining Your Public Key" -- give email addresses as
885     {pgp,gpg}-update@debian.org, at James Troup's request (note to Jameas,
886     if you see this: /usr/doc/debian-keyring/README.gz talks about
887     <keyring-maint> instead)
888   * Ch. "Overview of Debian Maintainer Tools" -- add Sec. "debget"
889   * developers-reference.sgml: minor typo correction from Tril
890     <dem@tunes.org>
891   * doc-base stuff: add abstract to developers-reference, new file for
892     constitution
893   * debian/rules: minor cleanup and consistency; build PDF, not PS file;
894     ship PDF file;.text file now has .txt extension
895   * debian/control: set priority to optional, matching archive
896
897  -- Adam Di Carlo <aph@debian.org>  Sat,  3 Apr 1999 17:17:06 -0500
898
899 developers-reference (2.6.0) frozen unstable; urgency=low
900
901   * would be nice to sneak this into slink; it's just documentation!
902   * Ch. "Porting and Being Ported": porter information broken out into it's
903     own chapter, Sec. "Guidelines for Porter Uploads" and "When to do a
904     source NMU if you are a porter" moved to this chapter; porter tool
905     descriptions such as 'quinn-diff' moved to this section.  Sec. "Being
906     Kind to Porters" added, with tips for how to avoid making problems for
907     porters.
908   * Ch. "Non-Maintainer Uploads (NMUs)": update for the new chapter, and
909     tighten up the language a bit
910   * Sec. "Monitoring bugs": add a little cron job to get an 'index maint'
911     of outstanding bugs (closes Bug#31259), loosen language a tiny bit
912     w.r.t. non-maintainers or submitters closing bugs (closes Bug#30394)
913   * Sec. "Scope of This Document": point out that this file is not
914     official policy
915   * Ch. "Handling Bugs": renamed from "Handling Bug Reports", incorporate
916     some suggestions from James Troup, namely, don't mail from your root
917     account, don't close bugs via control@bugs.debian.org; break out new
918     sections, "Submitting Bugs" and "Responding to Bugs"
919   * Ch. "Overview of Debian Maintainer Tools": remove attribution for
920     package maintainers, since I can't keep up; add entries for fakeroot
921     and devscripts
922   * Ch. "Maintaining Your Debian Information": new chapter, quite small
923     right now; it mentions keyring-maint@debian.org for key modification,
924     warns against putting private keys on multi-user machines, and talks
925     about how to depart Debian gracefully
926   * typo correction from Christian Hudon (closes Bug#32052)
927   * menu file removed, obsoleted by doc-base file
928   * parameterize some often-changing values with SGML entities, update
929     number of available packages
930   * use new way of notating multiple copyrights
931   * change <tt> elements to <file> where appropriate
932
933  -- Adam Di Carlo <aph@debian.org>  Thu, 11 Feb 1999 02:53:55 -0500
934
935 developers-reference (2.5.0.5) unstable; urgency=low
936
937   * add version.ent to docdir, needed to reconstruct from SGML 
938     (closes Bug#31034)
939
940  -- Adam Di Carlo <aph@debian.org>  Tue, 29 Dec 1998 02:42:50 -0500
941
942 developers-reference (2.5.0.4) unstable; urgency=low
943
944   * not officially released
945   * more spelling corrections
946   * s/ppc/powerpc/ (thanks, James Troup)
947
948  -- Adam Di Carlo <aph@debian.org>  Fri, 18 Dec 1998 00:07:40 -0500
949
950 developers-reference (2.5.0.3) unstable; urgency=low
951
952   * not officially released
953   * Sec. "Removing a package from Incoming": tiny section added
954   * some PGP-centricity removed
955   * Sec. "Adopting a package": point out that hijacking packages is not ok 
956   * Ch. "Non-Maintainer Uploads (NMUs) and Porters": change 'NMU' to
957     'source NMU', 'port' to 'binary NMU', shorten the window for porters a
958     tad; fix spelling; stress that non-maintainer patches must be
959     non-disruptive and that aesthetic issues are not suitable for fixing
960     by non-maintainers; other fixes as suggested by interested parties
961
962  -- Adam Di Carlo <aph@debian.org>  Wed, 25 Nov 1998 00:01:27 -0500
963
964 developers-reference (2.5.0.2) frozen unstable; urgency=low
965
966   * not officially released
967   * maintainer name change (but it's still me)
968   * Ch. "Non-Maintainer Uploads (NMUs) and Porters":  new chapter
969     discussing NMUs and porters; Section "Interim Releases" integrated out
970     of existance.  New TOC for this section is:
971          * 6 Non-Maintainer Uploads (NMUs) and Porters
972             + 6.1 Who can do a port or an NMU
973             + 6.2 When to do a port or an NMU
974                  o 6.2.1 When to do an NMU if you are a porter
975             + 6.3 How to do an NMU
976                  o 6.3.1 NMU version numbering
977                  o 6.3.2 NMUs must create a changelog entry
978                  o 6.3.3 NMUs must send patches, if any, to the BTS
979                  o 6.3.4 Building the NMU
980             + 6.4 Guidelines for Porters
981   
982   * Sec. "Maintainer changes": renamed to "Adopting a package" and moved
983     to Chapter "Moving, Removing, Renaming, Adopting, and Orphaning
984     Packages".
985   * Sec. "Reporting lots of bugs at once": more forcefully deprecate this
986     practice
987   * Sec. "Adopting a package": mention that the BTS maintainer update can
988     take a couple of weeks
989   * Sec. "Overview of Debian Maintainer Tools": give credit where credit
990     is due and attribute current maintainers; add `apt'; add `quinn-diff';
991     add mention of as yet unreleased 'buildd' package, since I'm so
992     excited about it and can't wait
993   * Sec. "Removing packages": talk about how apt-cache can be used to look
994     at reverse depends, a good step to take prior to removing a package
995     from the archive
996   * show *full* TOC, including sect2
997   * of course the obligatory typo, grammar, and spelling corrections
998
999   * Makefile: small changes to accomodate DDP autobuild
1000   * debian/dirs: obsolete, removed
1001   * debian/rules: use changelog date for SGML timestamping, not current date
1002
1003  -- Adam Di Carlo <aph@debian.org>  Fri, 20 Nov 1998 12:27:53 -0500
1004
1005 developers-reference (2.5.0) frozen unstable; urgency=low
1006
1007   * move to 3-level version number:
1008     top-level version number probably won't change for a while, it is the
1009     "major", the second-level number means significant content changes,
1010     and the third-level change means corrections and minor improvements.
1011     Since this version has significant content changes, we are now 2.5.0.
1012     Since I'm going to put porter instructions in the next major rev, that
1013     will be 2.6.0...
1014
1015   * use new <package> tag where appropriate (Ardo, you rock)
1016   * replace 'm86k' with 'm68k'
1017   * rename 'Whirlwind Tour of ...' section to 'Overview of ...' (suggested 
1018     by James Troup)
1019   * typos and "red-pen" corrections, fix cosmetic problems in PostScript
1020     version
1021   * remove the one case I use an URL fragment identifier, since
1022     debiandoc-sgml doesn't like it (bug filed against debiandoc-sgml)
1023   * debian/rules: cosmetic cleanups, loosen check for root
1024   * debian/rules: build PostScript version during build, since it's nice
1025     to have all my debiandoc2* scripts together
1026   * debian/control: policy compliant to 2.5.0
1027
1028   * advise against uploading when a package has lintian problems of
1029     severity 'E'
1030   * "Mailing Lists and Servers":
1031     - "The master server": mention how master is the home of the BTS;
1032       mention how users need to take care with their accounts on master
1033     - "The WWW servers": fill in www.debian.org, first pass, and discuss
1034       how to put up your own web pages on va or master
1035     - "The CVS server": new section added
1036     - "Mirrors of Debian servers": new section added; point to info about
1037        how to mirror
1038   * "Applying to Become a Maintainer": do not advise resending initial
1039     application; instead, simply mail a followup asking new maintainers
1040     whether they go the initial application (closes Bug #28739); mention
1041     that calls usually come in the evening; mention that if you use PGP
1042     v5, you need to generate an RSA key (right?); clarify our intentions
1043     with respect to GPG.
1044   * "Release code names": Debian 2.2 is 'potato'
1045   * "Distribution directories": give concrete examples, hopefully making
1046     it clearer where to look in Debian archives for specific stuff;
1047     mention that old distributions are moved to archive servers (is there
1048     a canonical location?)
1049   * "The override file": new section, added under "Notification that a new
1050     package has been installed"; fill it out quite a bit
1051   * "Uploading to *": reiterate thrice not to upload export
1052     controlled-software to master, or the European queues on erlangen and
1053     chiark
1054   * "Picking a distribution": section broken out from "Generating the
1055     changes file"
1056   * "Uploading to frozen": new section, almost straight from Brian White
1057     (hope you don't mind!) -- isn't that topical?
1058   * "Interim releases": if you NMU a new upstream version (0.1), run 
1059     'dpkg-buildpackage -sa'
1060
1061  -- Adam P. Harris <aph@debian.org>  Thu, 12 Nov 1998 00:03:43 -0500
1062
1063 developers-reference (2.4.1.5) unstable; urgency=low
1064
1065   * Fix instructions for new maintainers, incorporating the actual text
1066     sent to prospective new maintainers.  Improve this text a bit for
1067     readability, coverage, and organization.  Significant changes were
1068     patched back to the new-maintainers group, if they care to use
1069     them. (closes Bug#26948)
1070   * Add an introductory "Scope" chapter which helps delineate what should
1071     and should not be included in this Reference.
1072   * Add a new chapter, "Whirlwind Tour of Debian Maintainer Tools".  Let
1073     me know what useful tools I forgot -- remember, Debian-specific
1074     maintainer tools only!
1075   * Add discussion of the "experimental" distribution, culled from an email
1076     from Guy Maor on debian-devel.
1077   * Incorporated suggestions from Branden Robinson (closes Bug#27211).
1078   * Point to doc-debian's mailing list instructions where relevant.
1079   * Made references to online documentation into URLs where possible.
1080   * Little corrections here and there.
1081   * add a Makefile for use in the DDP manual hierarchy
1082   * debian/rules: comment out my 'source-depends' hack; it's just slowing
1083     things down
1084
1085  -- Adam P. Harris <aph@debian.org>  Thu,  1 Oct 1998 03:42:43 -0400
1086
1087 developers-reference (2.4.1.4) unstable; urgency=low
1088
1089   * fill in Section "The master server" a bit; other servers to follow
1090   * in Section "Distribution directories", mention that distributions
1091     are always in 'dists' subdir of the Debian archive; talk about
1092     'proposed-updates'
1093   * in Section "Release code names", talk about 'sid' a bit
1094   * in Section "Interim releases", talk about how non-maintainers should
1095     use the BTS, and bug severity "fixed" (closes Bug#17524)
1096   * in Section "Generating the changes file", talk about how to set the
1097     distribution in the debian/changelog file (i.e., "frozen unstable")
1098   * add a new Section "Checking the package prior to upload" to Section
1099     "Uploading a package", mentioning lintian and other tests one should
1100     do prior to uploading
1101   * add new Section "Notification that a new package has been installed"
1102     in Section "Uploading a package", talking about dinstall and the
1103     override file a bit
1104   * add new Sections "Moving packages", "Removing packages", "Replacing or
1105     renaming packages", and "Orphaning a package" (closes Bug#26650)
1106   * add new Section "Bugs in your packages", talking about maintainer
1107     duties with respect to bugs
1108   * add new Section "Lintian reports" under "Handling bugs reports",
1109     talking about how maintainers should check their packages with lintian 
1110     every now and then, alternatively pointing them to the lintian web
1111     pages
1112   * clarify, a bit, the use of "section" and "subsection", bringing it
1113     into line with the usage in the Policy Manual and Packaging Manual
1114   * grammar and markup changes throughout
1115   * debian/rules: added a crude source-depends rule, which renders more
1116     explicit what is used to build this package
1117
1118  -- Adam P. Harris <aph@debian.org>  Mon, 21 Sep 1998 00:51:46 -0400
1119
1120 developers-reference (2.4.1.3) unstable; urgency=low
1121
1122   * new maintainer
1123   * version number and date are automatically populated now
1124   * changed doc-base section to "debian"
1125   * debian/rules: better abstraction and organization
1126   * reformat SGML like I happen to like it
1127   * utilize the new URL tag
1128   * build PostScript on letter size, I hear thats better for A4 and US
1129     letter printing
1130
1131  -- Adam P. Harris <aph@debian.org>  Thu, 16 Jul 1998 00:52:35 -0400
1132
1133 developers-reference (2.4.1.2) frozen unstable; urgency=low
1134
1135   * non-maintainer release
1136   * rebuilt since HTML versions of Chapters 1 and 2 were truncated
1137     (important bug, no number yet, bugs.debian.org isn't working;
1138     regardless, this should go in hamm because a broken developers
1139     reference won't win us many friends in hamm, and after all, it's just
1140     text, it can't hurt you.)
1141   * no content changes, except that the version number in the SGML file
1142     reflect this packages version number
1143   * debian/rule: clean is cleaner now
1144
1145  -- Adam P. Harris <aph@debian.org>  Tue, 16 Jun 1998 01:35:39 -0400
1146
1147 developers-reference (2.4.1.1) frozen unstable; urgency=low
1148
1149   * Orphaned package
1150
1151  -- Christian Schwarz <schwarz@debian.org>  Thu, 14 May 1998 21:56:36 +0200
1152
1153 developers-reference (2.4.1.0) frozen unstable; urgency=low
1154
1155   * New version numbering scheme:
1156   
1157     - The version numbers are independent of dpkg now, but all policy
1158       manuals (the Debian Policy Manual, the Debian Packaging Manual, and
1159       the Debian Developer's Reference) share the same version numbering
1160       scheme.
1161     
1162     - The first three digits of the version number specify the
1163       `Standards-Version.' This number is incremented with each policy
1164       change. The fourth digit represents the `patch-level,' which may
1165       differ between the manuals. 
1166   
1167       If only the patch-level digit is incremented, no changes in policy
1168       have been made, except bug fixes and clarifications. Packages only
1169       have to specify the first three digits of the version number in the
1170       `Standards-Version' field of their source packages.
1171   
1172   * Uploaded to frozen and unstable. This is a documentation-only
1173     package and the changes to the manual are relevant for hamm.
1174
1175   * No changes to the Developer's Reference
1176   
1177  -- Christian Schwarz <schwarz@debian.org>  Mon, 13 Apr 1998 17:54:43 +0200
1178
1179 developers-reference (0.5) unstable; urgency=low
1180
1181   * Changes to the Developer's Reference:
1182   
1183     - Changed section 1.2 Registering as a Debian developer:
1184       + signatures from formal certification service are _NOT_ accepted
1185         anymore
1186       + images of ID documents have to be PGP or RSA signed
1187       (as requested by James Troup)
1188   
1189     - Use current date instead of <date> in manual
1190     
1191   * Updated FSF's address (reported by Lintian)
1192
1193  -- Christian Schwarz <schwarz@debian.org>  Sat,  7 Mar 1998 13:52:15 +0100
1194
1195 developers-reference (0.4) unstable; urgency=low
1196
1197   * Changes to the Developer's Reference:
1198
1199     - Renamed chapter 4 into `Package uploads'
1200
1201     - New section 4.2.5 Uploading to the non-us server
1202
1203     - Changed section 4.4 Interim releases:
1204       + non-maintainer releases should not close bugs
1205       + normal maintainer must at least read the patch provided with
1206         the non-maintainer release
1207
1208     - New chapter 5 Handling bug reports:
1209       + when reporting more then 10 bugs on the same topic, a message
1210         has to be sent to debian-devel and the `maintonly' address
1211         should be used
1212
1213     - Lots of typos fixed
1214
1215   * Compressed SGML source code
1216
1217   * Added support for doc-base to register the Developer's Reference
1218     to the online documentation systems dwww and dhelp
1219
1220   * Upgraded to standards version 2.4.0.0 (no changes)
1221   
1222  -- Christian Schwarz <schwarz@debian.org>  Fri, 30 Jan 1998 21:58:34 +0100
1223   
1224 developers-reference (0.3) unstable; urgency=low
1225
1226   * Put lost sections from Policy Manual 2.1.3.3 back in:
1227       - Generating the changes file (for uploads)
1228       - Announcing package uploads
1229   * New section about Debian Mentors
1230   * debian/rules: Don't use debstd anymore
1231   * debian/rules: Compress changelog file (fixes:#15441)
1232   * Fixed link to WNPP list (fixes:#16201)
1233   * Added menu entry (fixes:#15708)
1234   
1235  -- Christian Schwarz <schwarz@debian.org>  Wed, 24 Dec 1997 13:54:33 +0100
1236   
1237 developers-reference (0.2) unstable; urgency=low
1238
1239   * New chapter about `The Debian Archive' describing the structure
1240     of our FTP server and the development process
1241   * Added note that new maintainers have to read the Social Contract
1242     and have to know where to find the Policy and Packaging Manuals
1243   * PGP key ring is not distributed via dpkg but in doc/ of the FTP
1244     server
1245   * Added note that cross posting between Debian lists is depreciated
1246   * New list of advantages why new packages should be discussed on
1247     debian-devel before they are uploaded
1248   * Added section about how packages are uploaded
1249   * Added note that the Security Managers may do interim releases without 
1250     contacting the maintainer
1251   * Removed chapter about bug tracking system (will be included in
1252     a new manual released soon)
1253   * Some minor changes
1254   * Include SGML source in package
1255   * Don't use `2-up' style for PostScript version
1256   * Upgraded to Standards 2.3.0.1
1257
1258  -- Christian Schwarz <schwarz@debian.org>  Sun,  2 Nov 1997 20:53:26 +0100
1259   
1260 developers-reference (0.1) unstable; urgency=low
1261
1262   * Initial Release.
1263
1264  -- Christian Schwarz <schwarz@debian.org>  Tue, 8 Jul 1997 00:19:49 +0200
1265