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