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