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