chiark / gitweb /
version 2.6.7
[developers-reference.git] / debian / changelog
index 2903f4011c7bbf6e8df646fc27e2b8249a504d19..51f0958ab4f19aac1a73b60f999f31c2ec87c3f2 100644 (file)
@@ -1,3 +1,261 @@
+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 whil, 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...
+
+  * use new <package> tag where appropriate (Ardo, you rock)
+  * replace 'm86k' with 'm68k'
+  * rename 'Whirlwind Tour of ...' section to 'Overview of ...' (suggested 
+    by James Troup)
+  * 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
 
   * Fix instructions for new maintainers, incorporating the actual text
@@ -5,10 +263,14 @@ developers-reference (2.4.1.5) unstable; urgency=low
     readability, coverage, and organization.  Significant changes were
     patched back to the new-maintainers group, if they care to use
     them. (closes Bug#26948)
-  * Add an introductory "Scope" section which helps delineate what should
+  * Add an introductory "Scope" chapter which helps delineate what should
     and should not be included in this Reference.
+  * Add a new chapter, "Whirlwind Tour of Debian Maintainer Tools".  Let
+    me know what useful tools I forgot -- remember, Debian-specific
+    maintainer tools only!
   * Add discussion of the "experimental" distribution, culled from an email
     from Guy Maor on debian-devel.
+  * Incorporated suggestions from Branden Robinson (closes Bug#27211).
   * Point to doc-debian's mailing list instructions where relevant.
   * Made references to online documentation into URLs where possible.
   * Little corrections here and there.
@@ -16,7 +278,7 @@ developers-reference (2.4.1.5) unstable; urgency=low
   * debian/rules: comment out my 'source-depends' hack; it's just slowing
     things down
 
- -- Adam P. Harris <aph@debian.org>  Mon, 28 Sep 1998 00:59:41 -0400
+ -- Adam P. Harris <aph@debian.org>  Thu,  1 Oct 1998 03:42:43 -0400
 
 developers-reference (2.4.1.4) unstable; urgency=low