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