1 developers-reference (3.0) unstable; urgency=low
4 - some simplifications on the TeX suffix rule
5 - welcome Manoj Srivastava as a co-maintainer
6 - welcome Raphael Hertzog as a co-maintainer
7 - update copyright date
8 - Sec "Getting started": link to New Maintainers' Guide
9 - Sec "Debian Mentors" renamed to "Debian Mentors and Sponsors",
10 we add some info on sponsoring; also in Sec "Sponsoring packages"
11 - new Chapter "Beyond Packaging" for recommended ways to contribute
12 to Debian beyond issues of package maintenance; Ch "Interaction with
13 Prospective Developers" moved into this chapter and renamed to Sec
14 "Interacting with Prospective Debian Developers"
15 - Section's first word capitalized, rest are normal case
16 - purge a reference to the Packaging Manual; closes: #145039
18 -- Adam Di Carlo <aph@debian.org> Sun, 5 May 2002 13:24:03 -0700
20 developers-reference (2.11) unstable; urgency=low
23 - some grammar corrections
24 - update French translation
26 - changes in upload situation, not possible to remove from Incoming
27 anymore; closes: #135559
28 - also talk about dput a tiny bit
30 - Ch "Overview of Debian Maintainer Tools":
32 - Charles Briscoe-Smith deprecates yada (I think new maintainers of
33 that would be welcome)
34 - debconf-doc mentioned for debconf
35 - debhelper: don't talk about debmake; mention how to get info on the dh-* pkgs
36 - dput: new section, closes: #129378
37 - debootstrap: new section, closes: #129377
38 - dpkg-dev-el: new section
39 - other minor wording changes
40 - Sec "Mailing Lists": where to find private archives, closes: #96780
41 - Ch "Package uploads":
42 - new Sec "Adding an entry to debian/changelog"
43 - rename Sec "Announcing new packages" to "New packages"
44 - crypto is in main, non-US is for patent restrictions, so:
45 - excise some text from "Registering as a Debian developer"
46 - changes in Sec "Uploading to ftp-master"
47 - changes in Sec "Uploading to non-US"
48 * old bugs closed out, closes: #110573
50 -- Adam Di Carlo <aph@debian.org> Sun, 7 Apr 2002 23:34:08 -0700
52 developers-reference (2.10.0) unstable; urgency=low
54 * from Martin Michlmayr
55 - update the "Applying to Become a New Maintainer" section, with
56 review by Raphael Hertzog, closes: #133965
57 - bugs closed in NMUs should uses 'closes' changelog entries,
59 - developers are not required to subscribe to debian-private
61 - some suggestions on places to use the proper term, Debian GNU/Linux,
63 - fix some typos, closes: #133956
65 - frozen doesn't exist anymore, just testing; note, however, that
66 there is a way to upload to 'woody-proposed-updates' -- if I can
67 find some description of that, I'll document it; closes: #133948
70 - isolate a few more language-independent bits
72 - change /usr/doc to /usr/share/doc, and typo in debian/copyright,
75 -- Adam Di Carlo <aph@debian.org> Sun, 24 Feb 2002 14:46:46 -0500
77 developers-reference (2.9.0) unstable; urgency=low
80 - created a new subsection about uploading to stable, and elaborated
82 - removed a stray sentence about stable from the paragraph about
83 security uploads (which apply to all distributions equally)
84 - replaced the nonexistent term "Security Manager" with "security officer"
85 - uploading to stable and unstable is deprecated; updated the section
86 about the experimental distribution; other fixes in the section
87 talking about uploading to distributions
88 - better organize some subsections in the section about package uploads
89 - replaced some bogus <ftppath>s with <tt>s
90 - noted how there is an upload queue on pandora, too
92 - French translation updated
94 - normalize '--' as — for prettier output
95 - integrate changes from James Troup, part of #102626
96 - typo fix thanks to Mark Hodge
98 -- Adam Di Carlo <aph@debian.org> Sun, 21 Oct 2001 01:03:01 -0400
100 developers-reference (2.8.8) unstable; urgency=low
103 - a few more strong words about sponsoring
104 - started a new chapter about the relationship between old and new
107 -- Adam Di Carlo <aph@debian.org> Fri, 20 Jul 2001 17:53:47 -0400
109 developers-reference (2.8.7) unstable; urgency=low
112 * fix a typo in a link
113 * dpkg-buildpackage -m<addr> flag was changed for -e<addr> when NMU'ing;
114 update documentation accordingly
116 * Matt Zimmerman fixes up some wording in the section talking about
117 forwarding bugs upstream
119 * provide proper l10n for SGML date entities; now we have &date-<LANG>
120 entities which should be used
121 * debian/rules: fixes for new debiandoc-sgml
122 * debian/control: depend on debiandoc-sgml 1.1.48 or better
124 -- Adam Di Carlo <aph@debian.org> Thu, 21 Jun 2001 14:43:42 -0400
126 developers-reference (2.8.6) unstable; urgency=low
128 * fix a typo, thanks to Antoine Hulin
129 * French version: completely up-to-date now
130 * Makefile: add a 'validate' target
131 * prepare and ship "upstream" ChangeLog; move the debian changelog to
133 * all versions: change the email address to use when orphaning
136 -- Adam Di Carlo <aph@debian.org> Fri, 13 Apr 2001 03:32:08 -0400
138 developers-reference (2.8.5) unstable; urgency=low
140 * expunge references to the Debian Packaging Manual, which is now in the
142 * Japanese version: also comment out some references packaging manual;
143 this translation needs updating
144 * deny request to shut down non-maintainer bug maintenance bug closure
145 practices (closes: Bug#88623)
146 * add some advice about U.S. citizens uploading to non-US
148 * debian/control: Build-Depends should have been Build-Depends-Indep
149 * French version: First complete translation of the Debian developer's
150 reference guide. Much work done by Antoine Hulin. Reviewed by Nicolas
152 * Portuguese version: work is started by Carlos Laviola, nothing
153 included yet, however
155 -- Adam Di Carlo <aph@debian.org> Sun, 8 Apr 2001 01:25:51 -0400
157 developers-reference (2.8.4) unstable; urgency=low
159 * debian/control: remove reference to obsolete packaging-manual package
161 * debian/control: fill in the description a bit more
162 * doc-base: index.html corrected to be index.en.html
164 * Makefile: clean is cleaner
166 -- Adam Di Carlo <aph@debian.org> Sun, 25 Feb 2001 12:47:06 -0500
168 developers-reference (2.8.3) unstable; urgency=low
170 * build and provide French and Japanese versions
171 * devolve build logic from debian/rules to top-level Makefile
172 * developers-reference.jp.sgml: minor changes so it will build (is out
174 * debian/rules: stop making useless /usr/share/developers-reference dir
176 -- Adam Di Carlo <aph@debian.org> Mon, 22 Jan 2001 02:02:02 -0500
178 developers-reference (2.8.2) unstable; urgency=low
181 - fix typographic errors reported by David Martinez (closes: Bug#80740)
182 - common.ent: upped the numbers a little bit, updated lintian reports URL
183 - updated regarding va->klecker move, and www->people move, changed
184 most mentions of dinstall to a generic term "archive maintenance
185 software", removed full path to it because it is in PATH now,
186 mentioned "dak" and "katie" (somewhat vaguely), changed week to
187 month regarding FTP archive waiting time since that\'s more often
188 the case, and changed weeks to hours regarding Maintainers file
189 updates since that\'s also more often the case now, updated some
190 URLs to entities, s/debian-doc/doc-debian/
191 - replaced evil latin1-only quotation marks, replaced mentions of
192 important severity (in RCB context) with serious severity, some
194 - common.ent (1.10): fixed email-debian-user alias; updated
195 sample-dist-dirtree (with more to come)
196 - described testing; described package pools (this particular part
197 required quite a bit of changes, and it might be a bit rough, but
198 it's a start); described the frozen test cycles et al; some other
200 - another update WRT sid/unstable/testing, from Colin Watson
202 * debian/control: add Recommends for debian-policy, packaging-manual
203 * update copyright notice for 2001
204 * fix for WNPP bug filing severities from David Schleef
205 * clarify the status of the Developers's reference as "normative"
206 * add a reference to debconf (closes: Bug#82413)
208 -- Adam Di Carlo <aph@debian.org> Sun, 21 Jan 2001 18:10:21 -0500
210 developers-reference (2.8.1) unstable; urgency=low
212 * update WNPP instructions, based on patch from Marcelo E. Magallon
214 * spelling corrections, awkward grammar suggestions from Andreas Krueger
216 * debian/rules: remove some obsolete source-depends stuff
218 -- Adam Di Carlo <aph@debian.org> Sat, 4 Nov 2000 13:22:21 -0500
220 developers-reference (2.8.0) unstable; urgency=low
222 * Almost all changes for this release are from Josip Rodin
223 <joy@debian.org>. Thanks, Josip!
225 * debian/control, postinst, prerm, rules: Policy 3.2.1 (closes:
226 Bug#68929, Bug#70384)
227 * fixed bug closing example (closes: Bug#71198)
228 * update the perl regexp from current /usr/lib/dpkg/parsechangelog/debian
229 * updated keyring/keyserver information (closes: Bug#67783)
230 * updated new-maintainer stuff (closes: Bug#67841)
231 * updated for master -> ftp-master move (closes: Bug#68369)
232 * noted www.d.o is the right host for web pages, but all other machines
233 could be used if necessary
234 * reorder mentions of scp to come before FTP, as it is more secure;
235 mention the rsync dupload method
236 * reorder mentions of pandora <-> non-us, canonical name non-us is
238 * other small corrections
239 * fixed orphaning/adopting instructions with regard to the new WNPP
240 * common.ent: fix urls for cvs.d.o, wnpp, Debian machines page,
241 lists-archives, www.d.o BTS
242 * common.ent: changed link for machines from devel/maintainer_contacts
244 * Makefile: remove unnecessary subshell
246 * Adam's change: update debian/copyright for new Policy, and put my name
247 in there a bit with updated years; update doc-base file for FHS
249 -- Adam Di Carlo <aph@debian.org> Sun, 15 Oct 2000 03:25:21 -0400
251 developers-reference (2.7.2) frozen unstable; urgency=medium
253 * I believe this should go into frozen because (a) it's only
254 documentation, so it can't introduce RC bugs, and (b) it fixes an
255 error which prevented it from building properly; however, whatever
256 ftpmaster feels is best is fine
258 * include common.ent as well as version.ent
259 (closes: Bug#52582, Bug#48926)
260 * debian/rules: fix build error caused by newer debiandoc-sgml; remove
261 constitution.en.html, since that is now located in the doc-debian
262 package (closes: Bug#54778, Bug#42014); don't compress .pdf file
264 * All changes below from Raphael Hertzog <hertzog@debian.org>
266 * Sec. "Uploading to master" and "Uploading to pandora":
267 explained dinstall -n (closes: Bug#45079)
268 * Sec. "Picking a distribution": added reference to the debian-release
269 team (closes: Bug#52906)
270 * Sec. "Announcing package uploads": rewrote it to take care of the fact
271 that dinstall is doing it automatically (closes: Bug#43877)
272 * Sec. "Mailing lists": added a paragraph about debian-email
274 * Changed the "Maintaining Your Debian Information" into "Debian
275 Developer's Duties" (closes: Bug#28908)
276 - added a section about the LDAP database
277 - added a section about the "on vacation" message
278 - added a section about the coordination with upstream developers
280 - added a section about managing Release Critical bugs
281 - added a section about Quality Assurance effort
283 -- Adam Di Carlo <aph@debian.org> Sun, 16 Apr 2000 23:24:33 -0400
285 developers-reference (2.7.1) unstable; urgency=low
287 * Sec. "Registering as a Debian developer": we are transitioning away
288 from non-free PGP -- remove allusions to non-free software such as
289 PGPv2 or v5 insofar as possible; recommend use of DSS keys rather than
291 * Sec. "Maintaining Your Public Key": remove PGP-centric stuff
292 * Sec. "When bugs are closed by new uploads": describe how to close bugs
293 via a magic changelog entry (closes: Bug#43690)
294 * Sec. "Generating the changes file": refer to Sec. "When bugs are
295 closed by new uploads" for closing bugs via a changelog entry
296 * developers-reference.sgml: re-enable RCS variables in CVS sources
297 * debian/control,rules: dynamically generate the TOC in the package
298 description from developers-reference.sgml
300 -- Adam Di Carlo <aph@debian.org> Sun, 12 Sep 1999 18:15:59 -0400
302 developers-reference (2.7.0) unstable; urgency=low
304 * developers-reference.sgml: separated out language-independant elements
305 into common.ent (not content changes); misc minor grammar changes
307 * doc-base: change section for *constitution* to Debian (not 'debian')
309 * Sec. "Stable, unstable, and sometimes frozen": mention how old stable
310 releases are available at archive.debian.org
311 * Sec. "Uploading to pandora (non-us)" added, remove stale
312 information about the old anonymous ftp area (closes Bug#39541);
313 Sec. "Other Upload Queues" added about that upload queues, added
314 samosa and master.debian.org.jp (closes Bug#37804)
315 * Sec. "Yada": mention that yada might not be as robust as other package
316 producing systems, at request of the author; Sec. "equivs" added
317 * Sec. "Moving packages": at the request of Guy Maor, clarify that this
318 procedure is for moving packages in sections (i.e., free, contrib)
320 * Sec. "Registering as a Debian developer": talk about RSA keys rather
321 than PGP keys, since I think GPG can create/handle them now; mention
322 that the official pkg maintainer address much match an ID on your key;
323 * Sec. "Maintaining Your Public Key": beef up the warnings a bit; point
325 * Sec. "Mailing Lists, Servers, and Other Machines": clean up and
326 clarify section; mention that all developers are expected to be
327 subscribed to debian-private and debian-devel-announce
328 * Sec. "Other Debian Machines": remove list of machines; point to
329 http://www.debian.org/devel/machines instead
330 * Sec. "Release code names": potato is 2.2
331 * Sec. "Guidelines for Porter Uploads": talk about recompile only
332 uploads and version numbers for this (i.e., foo_2.4-1.0.1), from a
333 suggestion from James Troup
334 * Sec. "buildd": mention andrea, and buildd.debian.org
335 * Sec. "Removing packages": correct apt-cache usage
336 * debain/rules: update standards to 3.0.1 -- since I'm not moving
337 /usr/doc to /usr/share/doc yet, no changes were required except in the
340 -- Adam Di Carlo <aph@debian.org> Mon, 16 Aug 1999 23:29:45 -0400
342 developers-reference (2.6.8) unstable; urgency=low
344 * when applying as a new user, the login name can be *eight* characters,
345 not seven (thanks to Rafael Caetano dos Santos)
347 -- Adam Di Carlo <aph@debian.org> Fri, 21 May 1999 21:50:04 -0400
349 developers-reference (2.6.7) unstable; urgency=low
351 * SGML'ish: normalize SGML elements, refill paragraphs (closes Bug#37987)
352 * doc-base: change section to Debian -- hmm, this looks like a doc-base
353 bug, really, but hey, who am I to refile bugs to another one of my own
354 packages? (closes Bug#37392)
355 * Ch. "Overview of Debian Maintainer Tools": new section for yada (um,
356 someone who uses this should check my description), correct build ->
357 debuild in the devscripts section (closes Bug#38053)
359 -- Adam Di Carlo <aph@debian.org> Fri, 21 May 1999 01:41:45 -0400
361 developers-reference (2.6.6) unstable; urgency=low
363 * Sec. "The master server": note that problems on Debian ftp can be sent
364 to ftpmaster@debian.org also
365 * Secs. "Uploads via chiark" and "Uploads via erlangen": remove
366 'cron-driven' (thanks Roman Hodek)
367 * Sec. "Being Kind to Porters": typos corrected, note that binary-arch
368 and binary-indep targets should work independantly (thanks Roman
370 * Sec. "buildd": remove erroneous reference to debbuild, reorganize the
371 section and correct typos (thank again Roman -- boy, this is the all
373 * debian/rules: re-enable letter-sized PDFs
375 -- Adam Di Carlo <aph@debian.org> Sun, 9 May 1999 01:17:29 -0400
377 developers-reference (2.6.5) unstable; urgency=low
379 * Sec. "Architectures": correction on supported architecture in Linux
381 * Sec. "Experimental": other reasons to use or not use the experiment
382 archive "section", from comments by Guy Maor
383 * Sec. "Being Kind to Porters": replace x86 with i386 (closes Bug#36485)
384 * debian/rules: date printing protected from local l10n (closes Bug#36891)
385 * Ch. "Mailing Lists, Servers, and Other Machines": renamed chapter; add
387 * Sec. "Debian Servers": new, for talking about the standard servers,
388 with intro; demoted server sections under that
389 * Sec. "The FTP servers": was empty, removed
390 * Sec. "The master server": fill in more info and cross-refs on how to
392 * Sec. "The CVS server": add some more detail which should be included
393 when requesting cvs areas; mention the cvsweb URL
394 * Sec. "Other Debian Machines": new section, list the machines for which
395 a normal developer may have access.
397 -- Adam Di Carlo <aph@debian.org> Tue, 4 May 1999 03:32:21 -0400
399 developers-reference (2.6.4) unstable; urgency=low
401 * debian/rules: hack 'byhand' file entries to include debian version
402 number in it, so subsequent uploads of the package into Incoming don't
403 step all over each other
405 -- Adam Di Carlo <aph@debian.org> Fri, 9 Apr 1999 20:04:04 -0400
407 developers-reference (2.6.3) unstable; urgency=low
409 * correction from James Troup -- <keyring-maint> is indeed the correct
410 address for PGP key updates
412 -- Adam Di Carlo <aph@debian.org> Sun, 4 Apr 1999 13:28:58 -0400
414 developers-reference (2.6.2) unstable; urgency=low
416 * Sec. "fakeroot": libtricks is not replacing anything after all
417 * developers-reference.sgml: use public declaration
418 * BTW, if any maintainers of translated versions of this document would
419 like to talk to me about folding your version into the
420 developers-reference CVS area, please get in touch with me
422 -- Adam Di Carlo <aph@debian.org> Sun, 4 Apr 1999 04:42:29 -0400
424 developers-reference (2.6.1) unstable; urgency=low
426 * include Debian constitution (closes Bug#30694)
427 * Sec. "fakeroot": libtricks is replacing fakeroot, not libtool
428 * Sec. "Maintaining Your Public Key" -- give email addresses as
429 {pgp,gpg}-update@debian.org, at James Troup's request (note to Jameas,
430 if you see this: /usr/doc/debian-keyring/README.gz talks about
431 <keyring-maint> instead)
432 * Ch. "Overview of Debian Maintainer Tools" -- add Sec. "debget"
433 * developers-reference.sgml: minor typo correction from Tril
435 * doc-base stuff: add abstract to developers-reference, new file for
437 * debian/rules: minor cleanup and consistency; build PDF, not PS file;
438 ship PDF file;.text file now has .txt extension
439 * debian/control: set priority to optional, matching archive
441 -- Adam Di Carlo <aph@debian.org> Sat, 3 Apr 1999 17:17:06 -0500
443 developers-reference (2.6.0) frozen unstable; urgency=low
445 * would be nice to sneak this into slink; it's just documentation!
446 * Ch. "Porting and Being Ported": porter information broken out into it's
447 own chapter, Sec. "Guidelines for Porter Uploads" and "When to do a
448 source NMU if you are a porter" moved to this chapter; porter tool
449 descriptions such as 'quinn-diff' moved to this section. Sec. "Being
450 Kind to Porters" added, with tips for how to avoid making problems for
452 * Ch. "Non-Maintainer Uploads (NMUs)": update for the new chapter, and
453 tighten up the language a bit
454 * Sec. "Monitoring bugs": add a little cron job to get an 'index maint'
455 of outstanding bugs (closes Bug#31259), loosen language a tiny bit
456 w.r.t. non-maintainers or submitters closing bugs (closes Bug#30394)
457 * Sec. "Scope of This Document": point out that this file is not
459 * Ch. "Handling Bugs": renamed from "Handling Bug Reports", incorporate
460 some suggestions from James Troup, namely, don't mail from your root
461 account, don't close bugs via control@bugs.debian.org; break out new
462 sections, "Submitting Bugs" and "Responding to Bugs"
463 * Ch. "Overview of Debian Maintainer Tools": remove attribution for
464 package maintainers, since I can't keep up; add entries for fakeroot
466 * Ch. "Maintaining Your Debian Information": new chapter, quite small
467 right now; it mentions keyring-maint@debian.org for key modification,
468 warns against putting private keys on multi-user machines, and talks
469 about how to depart Debian gracefully
470 * typo correction from Christian Hudon (closes Bug#32052)
471 * menu file removed, obsoleted by doc-base file
472 * parameterize some often-changing values with SGML entities, update
473 number of available packages
474 * use new way of notating multiple copyrights
475 * change <tt> elements to <file> where appropriate
477 -- Adam Di Carlo <aph@debian.org> Thu, 11 Feb 1999 02:53:55 -0500
479 developers-reference (2.5.0.5) unstable; urgency=low
481 * add version.ent to docdir, needed to reconstruct from SGML
484 -- Adam Di Carlo <aph@debian.org> Tue, 29 Dec 1998 02:42:50 -0500
486 developers-reference (2.5.0.4) unstable; urgency=low
488 * not officially released
489 * more spelling corrections
490 * s/ppc/powerpc/ (thanks, James Troup)
492 -- Adam Di Carlo <aph@debian.org> Fri, 18 Dec 1998 00:07:40 -0500
494 developers-reference (2.5.0.3) unstable; urgency=low
496 * not officially released
497 * Sec. "Removing a package from Incoming": tiny section added
498 * some PGP-centricity removed
499 * Sec. "Adopting a package": point out that hijacking packages is not ok
500 * Ch. "Non-Maintainer Uploads (NMUs) and Porters": change 'NMU' to
501 'source NMU', 'port' to 'binary NMU', shorten the window for porters a
502 tad; fix spelling; stress that non-maintainer patches must be
503 non-disruptive and that aesthetic issues are not suitable for fixing
504 by non-maintainers; other fixes as suggested by interested parties
506 -- Adam Di Carlo <aph@debian.org> Wed, 25 Nov 1998 00:01:27 -0500
508 developers-reference (2.5.0.2) frozen unstable; urgency=low
510 * not officially released
511 * maintainer name change (but it's still me)
512 * Ch. "Non-Maintainer Uploads (NMUs) and Porters": new chapter
513 discussing NMUs and porters; Section "Interim Releases" integrated out
514 of existance. New TOC for this section is:
515 * 6 Non-Maintainer Uploads (NMUs) and Porters
516 + 6.1 Who can do a port or an NMU
517 + 6.2 When to do a port or an NMU
518 o 6.2.1 When to do an NMU if you are a porter
519 + 6.3 How to do an NMU
520 o 6.3.1 NMU version numbering
521 o 6.3.2 NMUs must create a changelog entry
522 o 6.3.3 NMUs must send patches, if any, to the BTS
523 o 6.3.4 Building the NMU
524 + 6.4 Guidelines for Porters
526 * Sec. "Maintainer changes": renamed to "Adopting a package" and moved
527 to Chapter "Moving, Removing, Renaming, Adopting, and Orphaning
529 * Sec. "Reporting lots of bugs at once": more forcefully deprecate this
531 * Sec. "Adopting a package": mention that the BTS maintainer update can
532 take a couple of weeks
533 * Sec. "Overview of Debian Maintainer Tools": give credit where credit
534 is due and attribute current maintainers; add `apt'; add `quinn-diff';
535 add mention of as yet unreleased 'buildd' package, since I'm so
536 excited about it and can't wait
537 * Sec. "Removing packages": talk about how apt-cache can be used to look
538 at reverse depends, a good step to take prior to removing a package
540 * show *full* TOC, including sect2
541 * of course the obligatory typo, grammar, and spelling corrections
543 * Makefile: small changes to accomodate DDP autobuild
544 * debian/dirs: obsolete, removed
545 * debian/rules: use changelog date for SGML timestamping, not current date
547 -- Adam Di Carlo <aph@debian.org> Fri, 20 Nov 1998 12:27:53 -0500
549 developers-reference (2.5.0) frozen unstable; urgency=low
551 * move to 3-level version number:
552 top-level version number probably won't change for a while, it is the
553 "major", the second-level number means significant content changes,
554 and the third-level change means corrections and minor improvements.
555 Since this version has significant content changes, we are now 2.5.0.
556 Since I'm going to put porter instructions in the next major rev, that
559 * use new <package> tag where appropriate (Ardo, you rock)
560 * replace 'm86k' with 'm68k'
561 * rename 'Whirlwind Tour of ...' section to 'Overview of ...' (suggested
563 * typos and "red-pen" corrections, fix cosmetic problems in PostScript
565 * remove the one case I use an URL fragment identifier, since
566 debiandoc-sgml doesn't like it (bug filed against debiandoc-sgml)
567 * debian/rules: cosmetic cleanups, loosen check for root
568 * debian/rules: build PostScript version during build, since it's nice
569 to have all my debiandoc2* scripts together
570 * debian/control: policy compliant to 2.5.0
572 * advise against uploading when a package has lintian problems of
574 * "Mailing Lists and Servers":
575 - "The master server": mention how master is the home of the BTS;
576 mention how users need to take care with their accounts on master
577 - "The WWW servers": fill in www.debian.org, first pass, and discuss
578 how to put up your own web pages on va or master
579 - "The CVS server": new section added
580 - "Mirrors of Debian servers": new section added; point to info about
582 * "Applying to Become a Maintainer": do not advise resending initial
583 application; instead, simply mail a followup asking new maintainers
584 whether they go the initial application (closes Bug #28739); mention
585 that calls usually come in the evening; mention that if you use PGP
586 v5, you need to generate an RSA key (right?); clarify our intentions
588 * "Release code names": Debian 2.2 is 'potato'
589 * "Distribution directories": give concrete examples, hopefully making
590 it clearer where to look in Debian archives for specific stuff;
591 mention that old distributions are moved to archive servers (is there
592 a canonical location?)
593 * "The override file": new section, added under "Notification that a new
594 package has been installed"; fill it out quite a bit
595 * "Uploading to *": reiterate thrice not to upload export
596 controlled-software to master, or the European queues on erlangen and
598 * "Picking a distribution": section broken out from "Generating the
600 * "Uploading to frozen": new section, almost straight from Brian White
601 (hope you don't mind!) -- isn't that topical?
602 * "Interim releases": if you NMU a new upstream version (0.1), run
603 'dpkg-buildpackage -sa'
605 -- Adam P. Harris <aph@debian.org> Thu, 12 Nov 1998 00:03:43 -0500
607 developers-reference (2.4.1.5) unstable; urgency=low
609 * Fix instructions for new maintainers, incorporating the actual text
610 sent to prospective new maintainers. Improve this text a bit for
611 readability, coverage, and organization. Significant changes were
612 patched back to the new-maintainers group, if they care to use
613 them. (closes Bug#26948)
614 * Add an introductory "Scope" chapter which helps delineate what should
615 and should not be included in this Reference.
616 * Add a new chapter, "Whirlwind Tour of Debian Maintainer Tools". Let
617 me know what useful tools I forgot -- remember, Debian-specific
618 maintainer tools only!
619 * Add discussion of the "experimental" distribution, culled from an email
620 from Guy Maor on debian-devel.
621 * Incorporated suggestions from Branden Robinson (closes Bug#27211).
622 * Point to doc-debian's mailing list instructions where relevant.
623 * Made references to online documentation into URLs where possible.
624 * Little corrections here and there.
625 * add a Makefile for use in the DDP manual hierarchy
626 * debian/rules: comment out my 'source-depends' hack; it's just slowing
629 -- Adam P. Harris <aph@debian.org> Thu, 1 Oct 1998 03:42:43 -0400
631 developers-reference (2.4.1.4) unstable; urgency=low
633 * fill in Section "The master server" a bit; other servers to follow
634 * in Section "Distribution directories", mention that distributions
635 are always in 'dists' subdir of the Debian archive; talk about
637 * in Section "Release code names", talk about 'sid' a bit
638 * in Section "Interim releases", talk about how non-maintainers should
639 use the BTS, and bug severity "fixed" (closes Bug#17524)
640 * in Section "Generating the changes file", talk about how to set the
641 distribution in the debian/changelog file (i.e., "frozen unstable")
642 * add a new Section "Checking the package prior to upload" to Section
643 "Uploading a package", mentioning lintian and other tests one should
644 do prior to uploading
645 * add new Section "Notification that a new package has been installed"
646 in Section "Uploading a package", talking about dinstall and the
648 * add new Sections "Moving packages", "Removing packages", "Replacing or
649 renaming packages", and "Orphaning a package" (closes Bug#26650)
650 * add new Section "Bugs in your packages", talking about maintainer
651 duties with respect to bugs
652 * add new Section "Lintian reports" under "Handling bugs reports",
653 talking about how maintainers should check their packages with lintian
654 every now and then, alternatively pointing them to the lintian web
656 * clarify, a bit, the use of "section" and "subsection", bringing it
657 into line with the usage in the Policy Manual and Packaging Manual
658 * grammar and markup changes throughout
659 * debian/rules: added a crude source-depends rule, which renders more
660 explicit what is used to build this package
662 -- Adam P. Harris <aph@debian.org> Mon, 21 Sep 1998 00:51:46 -0400
664 developers-reference (2.4.1.3) unstable; urgency=low
667 * version number and date are automatically populated now
668 * changed doc-base section to "debian"
669 * debian/rules: better abstraction and organization
670 * reformat SGML like I happen to like it
671 * utilize the new URL tag
672 * build PostScript on letter size, I hear thats better for A4 and US
675 -- Adam P. Harris <aph@debian.org> Thu, 16 Jul 1998 00:52:35 -0400
677 developers-reference (2.4.1.2) frozen unstable; urgency=low
679 * non-maintainer release
680 * rebuilt since HTML versions of Chapters 1 and 2 were truncated
681 (important bug, no number yet, bugs.debian.org isn't working;
682 regardless, this should go in hamm because a broken developers
683 reference won't win us many friends in hamm, and after all, it's just
684 text, it can't hurt you.)
685 * no content changes, except that the version number in the SGML file
686 reflect this packages version number
687 * debian/rule: clean is cleaner now
689 -- Adam P. Harris <aph@debian.org> Tue, 16 Jun 1998 01:35:39 -0400
691 developers-reference (2.4.1.1) frozen unstable; urgency=low
695 -- Christian Schwarz <schwarz@debian.org> Thu, 14 May 1998 21:56:36 +0200
697 developers-reference (2.4.1.0) frozen unstable; urgency=low
699 * New version numbering scheme:
701 - The version numbers are independent of dpkg now, but all policy
702 manuals (the Debian Policy Manual, the Debian Packaging Manual, and
703 the Debian Developer's Reference) share the same version numbering
706 - The first three digits of the version number specify the
707 `Standards-Version.' This number is incremented with each policy
708 change. The fourth digit represents the `patch-level,' which may
709 differ between the manuals.
711 If only the patch-level digit is incremented, no changes in policy
712 have been made, except bug fixes and clarifications. Packages only
713 have to specify the first three digits of the version number in the
714 `Standards-Version' field of their source packages.
716 * Uploaded to frozen and unstable. This is a documentation-only
717 package and the changes to the manual are relevant for hamm.
719 * No changes to the Developer's Reference
721 -- Christian Schwarz <schwarz@debian.org> Mon, 13 Apr 1998 17:54:43 +0200
723 developers-reference (0.5) unstable; urgency=low
725 * Changes to the Developer's Reference:
727 - Changed section 1.2 Registering as a Debian developer:
728 + signatures from formal certification service are _NOT_ accepted
730 + images of ID documents have to be PGP or RSA signed
731 (as requested by James Troup)
733 - Use current date instead of <date> in manual
735 * Updated FSF's address (reported by Lintian)
737 -- Christian Schwarz <schwarz@debian.org> Sat, 7 Mar 1998 13:52:15 +0100
739 developers-reference (0.4) unstable; urgency=low
741 * Changes to the Developer's Reference:
743 - Renamed chapter 4 into `Package uploads'
745 - New section 4.2.5 Uploading to the non-us server
747 - Changed section 4.4 Interim releases:
748 + non-maintainer releases should not close bugs
749 + normal maintainer must at least read the patch provided with
750 the non-maintainer release
752 - New chapter 5 Handling bug reports:
753 + when reporting more then 10 bugs on the same topic, a message
754 has to be sent to debian-devel and the `maintonly' address
757 - Lots of typos fixed
759 * Compressed SGML source code
761 * Added support for doc-base to register the Developer's Reference
762 to the online documentation systems dwww and dhelp
764 * Upgraded to standards version 2.4.0.0 (no changes)
766 -- Christian Schwarz <schwarz@debian.org> Fri, 30 Jan 1998 21:58:34 +0100
768 developers-reference (0.3) unstable; urgency=low
770 * Put lost sections from Policy Manual 2.1.3.3 back in:
771 - Generating the changes file (for uploads)
772 - Announcing package uploads
773 * New section about Debian Mentors
774 * debian/rules: Don't use debstd anymore
775 * debian/rules: Compress changelog file (fixes:#15441)
776 * Fixed link to WNPP list (fixes:#16201)
777 * Added menu entry (fixes:#15708)
779 -- Christian Schwarz <schwarz@debian.org> Wed, 24 Dec 1997 13:54:33 +0100
781 developers-reference (0.2) unstable; urgency=low
783 * New chapter about `The Debian Archive' describing the structure
784 of our FTP server and the development process
785 * Added note that new maintainers have to read the Social Contract
786 and have to know where to find the Policy and Packaging Manuals
787 * PGP key ring is not distributed via dpkg but in doc/ of the FTP
789 * Added note that cross posting between Debian lists is depreciated
790 * New list of advantages why new packages should be discussed on
791 debian-devel before they are uploaded
792 * Added section about how packages are uploaded
793 * Added note that the Security Managers may do interim releases without
794 contacting the maintainer
795 * Removed chapter about bug tracking system (will be included in
796 a new manual released soon)
798 * Include SGML source in package
799 * Don't use `2-up' style for PostScript version
800 * Upgraded to Standards 2.3.0.1
802 -- Christian Schwarz <schwarz@debian.org> Sun, 2 Nov 1997 20:53:26 +0100
804 developers-reference (0.1) unstable; urgency=low
808 -- Christian Schwarz <schwarz@debian.org> Tue, 8 Jul 1997 00:19:49 +0200