-developers-reference (2.4.2) frozen unstable; urgency=low
+developers-reference (2.8.0) unstable; urgency=low
+
+ * Almost all changes for this release are from Josip Rodin
+ <joy@debian.org>. Thanks, Josip!
+
+ * debian/control, postinst, prerm, rules: Policy 3.2.1 (closes:
+ Bug#68929, Bug#70384)
+ * fixed bug closing example (closes: Bug#71198)
+ * update the perl regexp from current /usr/lib/dpkg/parsechangelog/debian
+ * updated keyring/keyserver information (closes: Bug#67783)
+ * updated new-maintainer stuff (closes: Bug#67841)
+ * updated for master -> ftp-master move (closes: Bug#68369)
+ * noted www.d.o is the right host for web pages, but all other machines
+ could be used if necessary
+ * reorder mentions of scp to come before FTP, as it is more secure;
+ mention the rsync dupload method
+ * reorder mentions of pandora <-> non-us, canonical name non-us is
+ better
+ * other small corrections
+ * fixed orphaning/adopting instructions with regard to the new WNPP
+ * common.ent: fix urls for cvs.d.o, wnpp, Debian machines page,
+ lists-archives, www.d.o BTS
+ * common.ent: changed link for machines from devel/maintainer_contacts
+ to the db.d.o CGI
+ * Makefile: remove unnecessary subshell
+
+ * Adam's change: update debian/copyright for new Policy, and put my name
+ in there a bit with updated years; update doc-base file for FHS
+
+ -- Adam Di Carlo <aph@debian.org> Sun, 15 Oct 2000 03:25:21 -0400
+
+developers-reference (2.7.2) frozen unstable; urgency=medium
+
+ * I believe this should go into frozen because (a) it's only
+ documentation, so it can't introduce RC bugs, and (b) it fixes an
+ error which prevented it from building properly; however, whatever
+ ftpmaster feels is best is fine
+ *
+ * include common.ent as well as version.ent
+ (closes: Bug#52582, Bug#48926)
+ * debian/rules: fix build error caused by newer debiandoc-sgml; remove
+ constitution.en.html, since that is now located in the doc-debian
+ package (closes: Bug#54778, Bug#42014); don't compress .pdf file
+ *
+ * All changes below from Raphael Hertzog <hertzog@debian.org>
+ *
+ * Sec. "Uploading to master" and "Uploading to pandora":
+ explained dinstall -n (closes: Bug#45079)
+ * Sec. "Picking a distribution": added reference to the debian-release
+ team (closes: Bug#52906)
+ * Sec. "Announcing package uploads": rewrote it to take care of the fact
+ that dinstall is doing it automatically (closes: Bug#43877)
+ * Sec. "Mailing lists": added a paragraph about debian-email
+ (closes: Bug#40258)
+ * Changed the "Maintaining Your Debian Information" into "Debian
+ Developer's Duties" (closes: Bug#28908)
+ - added a section about the LDAP database
+ - added a section about the "on vacation" message
+ - added a section about the coordination with upstream developers
+ (closes: Bug#43878)
+ - added a section about managing Release Critical bugs
+ - added a section about Quality Assurance effort
+
+ -- Adam Di Carlo <aph@debian.org> Sun, 16 Apr 2000 23:24:33 -0400
+
+developers-reference (2.7.1) unstable; urgency=low
+
+ * Sec. "Registering as a Debian developer": we are transitioning away
+ from non-free PGP -- remove allusions to non-free software such as
+ PGPv2 or v5 insofar as possible; recommend use of DSS keys rather than
+ RSA
+ * Sec. "Maintaining Your Public Key": remove PGP-centric stuff
+ * Sec. "When bugs are closed by new uploads": describe how to close bugs
+ via a magic changelog entry (closes: Bug#43690)
+ * Sec. "Generating the changes file": refer to Sec. "When bugs are
+ closed by new uploads" for closing bugs via a changelog entry
+ * developers-reference.sgml: re-enable RCS variables in CVS sources
+ * debian/control,rules: dynamically generate the TOC in the package
+ description from developers-reference.sgml
+
+ -- Adam Di Carlo <aph@debian.org> Sun, 12 Sep 1999 18:15:59 -0400
+
+developers-reference (2.7.0) unstable; urgency=low
+
+ * developers-reference.sgml: separated out language-independant elements
+ into common.ent (not content changes); misc minor grammar changes
+ throughout
+ * doc-base: change section for *constitution* to Debian (not 'debian')
+ (closes Bug#37392)
+ * Sec. "Stable, unstable, and sometimes frozen": mention how old stable
+ releases are available at archive.debian.org
+ * Sec. "Uploading to pandora (non-us)" added, remove stale
+ information about the old anonymous ftp area (closes Bug#39541);
+ Sec. "Other Upload Queues" added about that upload queues, added
+ samosa and master.debian.org.jp (closes Bug#37804)
+ * Sec. "Yada": mention that yada might not be as robust as other package
+ producing systems, at request of the author; Sec. "equivs" added
+ * Sec. "Moving packages": at the request of Guy Maor, clarify that this
+ procedure is for moving packages in sections (i.e., free, contrib)
+ only
+ * Sec. "Registering as a Debian developer": talk about RSA keys rather
+ than PGP keys, since I think GPG can create/handle them now; mention
+ that the official pkg maintainer address much match an ID on your key;
+ * Sec. "Maintaining Your Public Key": beef up the warnings a bit; point
+ to the PGP FAQ
+ * Sec. "Mailing Lists, Servers, and Other Machines": clean up and
+ clarify section; mention that all developers are expected to be
+ subscribed to debian-private and debian-devel-announce
+ * Sec. "Other Debian Machines": remove list of machines; point to
+ http://www.debian.org/devel/machines instead
+ * Sec. "Release code names": potato is 2.2
+ * Sec. "Guidelines for Porter Uploads": talk about recompile only
+ uploads and version numbers for this (i.e., foo_2.4-1.0.1), from a
+ suggestion from James Troup
+ * Sec. "buildd": mention andrea, and buildd.debian.org
+ * Sec. "Removing packages": correct apt-cache usage
+ * debain/rules: update standards to 3.0.1 -- since I'm not moving
+ /usr/doc to /usr/share/doc yet, no changes were required except in the
+ text here and there
+
+ -- Adam Di Carlo <aph@debian.org> Mon, 16 Aug 1999 23:29:45 -0400
+
+developers-reference (2.6.8) unstable; urgency=low
+
+ * when applying as a new user, the login name can be *eight* characters,
+ not seven (thanks to Rafael Caetano dos Santos)
+
+ -- Adam Di Carlo <aph@debian.org> Fri, 21 May 1999 21:50:04 -0400
+
+developers-reference (2.6.7) unstable; urgency=low
+
+ * SGML'ish: normalize SGML elements, refill paragraphs (closes Bug#37987)
+ * doc-base: change section to Debian -- hmm, this looks like a doc-base
+ bug, really, but hey, who am I to refile bugs to another one of my own
+ packages? (closes Bug#37392)
+ * Ch. "Overview of Debian Maintainer Tools": new section for yada (um,
+ someone who uses this should check my description), correct build ->
+ debuild in the devscripts section (closes Bug#38053)
+
+ -- Adam Di Carlo <aph@debian.org> Fri, 21 May 1999 01:41:45 -0400
+
+developers-reference (2.6.6) unstable; urgency=low
+
+ * Sec. "The master server": note that problems on Debian ftp can be sent
+ to ftpmaster@debian.org also
+ * Secs. "Uploads via chiark" and "Uploads via erlangen": remove
+ 'cron-driven' (thanks Roman Hodek)
+ * Sec. "Being Kind to Porters": typos corrected, note that binary-arch
+ and binary-indep targets should work independantly (thanks Roman
+ Hodek)
+ * Sec. "buildd": remove erroneous reference to debbuild, reorganize the
+ section and correct typos (thank again Roman -- boy, this is the all
+ Roman release)
+ * debian/rules: re-enable letter-sized PDFs
+
+ -- Adam Di Carlo <aph@debian.org> Sun, 9 May 1999 01:17:29 -0400
+
+developers-reference (2.6.5) unstable; urgency=low
+
+ * Sec. "Architectures": correction on supported architecture in Linux
+ 2.2, from Job Bogan
+ * Sec. "Experimental": other reasons to use or not use the experiment
+ archive "section", from comments by Guy Maor
+ * Sec. "Being Kind to Porters": replace x86 with i386 (closes Bug#36485)
+ * debian/rules: date printing protected from local l10n (closes Bug#36891)
+ * Ch. "Mailing Lists, Servers, and Other Machines": renamed chapter; add
+ intro paragraph
+ * Sec. "Debian Servers": new, for talking about the standard servers,
+ with intro; demoted server sections under that
+ * Sec. "The FTP servers": was empty, removed
+ * Sec. "The master server": fill in more info and cross-refs on how to
+ report problems
+ * Sec. "The CVS server": add some more detail which should be included
+ when requesting cvs areas; mention the cvsweb URL
+ * Sec. "Other Debian Machines": new section, list the machines for which
+ a normal developer may have access.
+
+ -- Adam Di Carlo <aph@debian.org> Tue, 4 May 1999 03:32:21 -0400
+
+developers-reference (2.6.4) unstable; urgency=low
+
+ * debian/rules: hack 'byhand' file entries to include debian version
+ number in it, so subsequent uploads of the package into Incoming don't
+ step all over each other
+
+ -- Adam Di Carlo <aph@debian.org> Fri, 9 Apr 1999 20:04:04 -0400
+
+developers-reference (2.6.3) unstable; urgency=low
+
+ * correction from James Troup -- <keyring-maint> is indeed the correct
+ address for PGP key updates
+
+ -- Adam Di Carlo <aph@debian.org> Sun, 4 Apr 1999 13:28:58 -0400
+
+developers-reference (2.6.2) unstable; urgency=low
+
+ * Sec. "fakeroot": libtricks is not replacing anything after all
+ * developers-reference.sgml: use public declaration
+ * BTW, if any maintainers of translated versions of this document would
+ like to talk to me about folding your version into the
+ developers-reference CVS area, please get in touch with me
+
+ -- Adam Di Carlo <aph@debian.org> Sun, 4 Apr 1999 04:42:29 -0400
+
+developers-reference (2.6.1) unstable; urgency=low
+
+ * include Debian constitution (closes Bug#30694)
+ * Sec. "fakeroot": libtricks is replacing fakeroot, not libtool
+ * Sec. "Maintaining Your Public Key" -- give email addresses as
+ {pgp,gpg}-update@debian.org, at James Troup's request (note to Jameas,
+ if you see this: /usr/doc/debian-keyring/README.gz talks about
+ <keyring-maint> instead)
+ * Ch. "Overview of Debian Maintainer Tools" -- add Sec. "debget"
+ * developers-reference.sgml: minor typo correction from Tril
+ <dem@tunes.org>
+ * doc-base stuff: add abstract to developers-reference, new file for
+ constitution
+ * debian/rules: minor cleanup and consistency; build PDF, not PS file;
+ ship PDF file;.text file now has .txt extension
+ * debian/control: set priority to optional, matching archive
+
+ -- Adam Di Carlo <aph@debian.org> Sat, 3 Apr 1999 17:17:06 -0500
+
+developers-reference (2.6.0) frozen unstable; urgency=low
+
+ * would be nice to sneak this into slink; it's just documentation!
+ * Ch. "Porting and Being Ported": porter information broken out into it's
+ own chapter, Sec. "Guidelines for Porter Uploads" and "When to do a
+ source NMU if you are a porter" moved to this chapter; porter tool
+ descriptions such as 'quinn-diff' moved to this section. Sec. "Being
+ Kind to Porters" added, with tips for how to avoid making problems for
+ porters.
+ * Ch. "Non-Maintainer Uploads (NMUs)": update for the new chapter, and
+ tighten up the language a bit
+ * Sec. "Monitoring bugs": add a little cron job to get an 'index maint'
+ of outstanding bugs (closes Bug#31259), loosen language a tiny bit
+ w.r.t. non-maintainers or submitters closing bugs (closes Bug#30394)
+ * Sec. "Scope of This Document": point out that this file is not
+ official policy
+ * Ch. "Handling Bugs": renamed from "Handling Bug Reports", incorporate
+ some suggestions from James Troup, namely, don't mail from your root
+ account, don't close bugs via control@bugs.debian.org; break out new
+ sections, "Submitting Bugs" and "Responding to Bugs"
+ * Ch. "Overview of Debian Maintainer Tools": remove attribution for
+ package maintainers, since I can't keep up; add entries for fakeroot
+ and devscripts
+ * Ch. "Maintaining Your Debian Information": new chapter, quite small
+ right now; it mentions keyring-maint@debian.org for key modification,
+ warns against putting private keys on multi-user machines, and talks
+ about how to depart Debian gracefully
+ * typo correction from Christian Hudon (closes Bug#32052)
+ * menu file removed, obsoleted by doc-base file
+ * parameterize some often-changing values with SGML entities, update
+ number of available packages
+ * use new way of notating multiple copyrights
+ * change <tt> elements to <file> where appropriate
+
+ -- Adam Di Carlo <aph@debian.org> Thu, 11 Feb 1999 02:53:55 -0500
+
+developers-reference (2.5.0.5) unstable; urgency=low
+
+ * add version.ent to docdir, needed to reconstruct from SGML
+ (closes Bug#31034)
+
+ -- Adam Di Carlo <aph@debian.org> Tue, 29 Dec 1998 02:42:50 -0500
+
+developers-reference (2.5.0.4) unstable; urgency=low
+
+ * not officially released
+ * more spelling corrections
+ * s/ppc/powerpc/ (thanks, James Troup)
+
+ -- Adam Di Carlo <aph@debian.org> Fri, 18 Dec 1998 00:07:40 -0500
+
+developers-reference (2.5.0.3) unstable; urgency=low
+
+ * not officially released
+ * Sec. "Removing a package from Incoming": tiny section added
+ * some PGP-centricity removed
+ * Sec. "Adopting a package": point out that hijacking packages is not ok
+ * Ch. "Non-Maintainer Uploads (NMUs) and Porters": change 'NMU' to
+ 'source NMU', 'port' to 'binary NMU', shorten the window for porters a
+ tad; fix spelling; stress that non-maintainer patches must be
+ non-disruptive and that aesthetic issues are not suitable for fixing
+ by non-maintainers; other fixes as suggested by interested parties
+
+ -- Adam Di Carlo <aph@debian.org> Wed, 25 Nov 1998 00:01:27 -0500
+
+developers-reference (2.5.0.2) frozen unstable; urgency=low
+
+ * not officially released
+ * maintainer name change (but it's still me)
+ * Ch. "Non-Maintainer Uploads (NMUs) and Porters": new chapter
+ discussing NMUs and porters; Section "Interim Releases" integrated out
+ of existance. New TOC for this section is:
+ * 6 Non-Maintainer Uploads (NMUs) and Porters
+ + 6.1 Who can do a port or an NMU
+ + 6.2 When to do a port or an NMU
+ o 6.2.1 When to do an NMU if you are a porter
+ + 6.3 How to do an NMU
+ o 6.3.1 NMU version numbering
+ o 6.3.2 NMUs must create a changelog entry
+ o 6.3.3 NMUs must send patches, if any, to the BTS
+ o 6.3.4 Building the NMU
+ + 6.4 Guidelines for Porters
+
+ * Sec. "Maintainer changes": renamed to "Adopting a package" and moved
+ to Chapter "Moving, Removing, Renaming, Adopting, and Orphaning
+ Packages".
+ * Sec. "Reporting lots of bugs at once": more forcefully deprecate this
+ practice
+ * Sec. "Adopting a package": mention that the BTS maintainer update can
+ take a couple of weeks
+ * Sec. "Overview of Debian Maintainer Tools": give credit where credit
+ is due and attribute current maintainers; add `apt'; add `quinn-diff';
+ add mention of as yet unreleased 'buildd' package, since I'm so
+ excited about it and can't wait
+ * Sec. "Removing packages": talk about how apt-cache can be used to look
+ at reverse depends, a good step to take prior to removing a package
+ from the archive
+ * show *full* TOC, including sect2
+ * of course the obligatory typo, grammar, and spelling corrections
+
+ * Makefile: small changes to accomodate DDP autobuild
+ * debian/dirs: obsolete, removed
+ * debian/rules: use changelog date for SGML timestamping, not current date
+
+ -- Adam Di Carlo <aph@debian.org> Fri, 20 Nov 1998 12:27:53 -0500
+
+developers-reference (2.5.0) frozen unstable; urgency=low
+
+ * move to 3-level version number:
+ top-level version number probably won't change for a while, it is the
+ "major", the second-level number means significant content changes,
+ and the third-level change means corrections and minor improvements.
+ Since this version has significant content changes, we are now 2.5.0.
+ Since I'm going to put porter instructions in the next major rev, that
+ will be 2.6.0...
- * move to 3-level version number -- still not sure why I shouldn't just
- go with a 2-level scheme, that needs more thought. For now,
- top-level version number probably won't change for a while, the
- second-level number means significant content changes, and the
- third-level change means corrections and minor improvements.
* use new <package> tag where appropriate (Ardo, you rock)
- * advise against uploading when a package has lintian problems of
- severity 'E'
* replace 'm86k' with 'm68k'
* rename 'Whirlwind Tour of ...' section to 'Overview of ...' (suggested
by James Troup)
- * debian/rules: cosmetic cleanups
- * fill in the Servers chapter a bit more; mention how master is the home
- of the BTS; mention how users need to take care with their accounts on
- master; fill in www.debian.org, first pass, and discuss how to put up
- your own web pages on va or master; add new section, "The CVS server";
- add new section, "Mirrors of Debian servers", and point to info about
- mirrors.
-
- -- Adam P. Harris <aph@debian.org> Sun, 1 Nov 1998 18:24:18 -0500
+ * typos and "red-pen" corrections, fix cosmetic problems in PostScript
+ version
+ * remove the one case I use an URL fragment identifier, since
+ debiandoc-sgml doesn't like it (bug filed against debiandoc-sgml)
+ * debian/rules: cosmetic cleanups, loosen check for root
+ * debian/rules: build PostScript version during build, since it's nice
+ to have all my debiandoc2* scripts together
+ * debian/control: policy compliant to 2.5.0
+
+ * advise against uploading when a package has lintian problems of
+ severity 'E'
+ * "Mailing Lists and Servers":
+ - "The master server": mention how master is the home of the BTS;
+ mention how users need to take care with their accounts on master
+ - "The WWW servers": fill in www.debian.org, first pass, and discuss
+ how to put up your own web pages on va or master
+ - "The CVS server": new section added
+ - "Mirrors of Debian servers": new section added; point to info about
+ how to mirror
+ * "Applying to Become a Maintainer": do not advise resending initial
+ application; instead, simply mail a followup asking new maintainers
+ whether they go the initial application (closes Bug #28739); mention
+ that calls usually come in the evening; mention that if you use PGP
+ v5, you need to generate an RSA key (right?); clarify our intentions
+ with respect to GPG.
+ * "Release code names": Debian 2.2 is 'potato'
+ * "Distribution directories": give concrete examples, hopefully making
+ it clearer where to look in Debian archives for specific stuff;
+ mention that old distributions are moved to archive servers (is there
+ a canonical location?)
+ * "The override file": new section, added under "Notification that a new
+ package has been installed"; fill it out quite a bit
+ * "Uploading to *": reiterate thrice not to upload export
+ controlled-software to master, or the European queues on erlangen and
+ chiark
+ * "Picking a distribution": section broken out from "Generating the
+ changes file"
+ * "Uploading to frozen": new section, almost straight from Brian White
+ (hope you don't mind!) -- isn't that topical?
+ * "Interim releases": if you NMU a new upstream version (0.1), run
+ 'dpkg-buildpackage -sa'
+
+ -- Adam P. Harris <aph@debian.org> Thu, 12 Nov 1998 00:03:43 -0500
developers-reference (2.4.1.5) unstable; urgency=low