debian/changelog

   1 developers-reference (2.6.2) unstable; urgency=low
   2
   3   * Sec. "fakeroot": libtricks is not replacing anything after all
   4   * developers-reference.sgml: use public declaration
   5   * BTW, if any maintainers of translated versions of this document would
   6     like to talk to me about folding your version into the
   7     developers-reference CVS area, please get in touch with me
   8
   9  -- Adam Di Carlo <aph@debian.org>  Sun,  4 Apr 1999 04:42:29 -0400
  10
  11 developers-reference (2.6.1) unstable; urgency=low
  12
  13   * include Debian constitution (closes Bug#30694)
  14   * Sec. "fakeroot": libtricks is replacing fakeroot, not libtool
  15   * Sec. "Maintaining Your Public Key" -- give email addresses as
  16     {pgp,gpg}-update@debian.org, at James Troup's request (note to Jameas,
  17     if you see this: /usr/doc/debian-keyring/README.gz talks about
  18     <keyring-maint> instead)
  19   * Ch. "Overview of Debian Maintainer Tools" -- add Sec. "debget"
  20   * developers-reference.sgml: minor typo correction from Tril
  21     <dem@tunes.org>
  22   * doc-base stuff: add abstract to developers-reference, new file for
  23     constitution
  24   * debian/rules: minor cleanup and consistency; build PDF, not PS file;
  25     ship PDF file;.text file now has .txt extension
  26   * debian/control: set priority to optional, matching archive
  27
  28  -- Adam Di Carlo <aph@debian.org>  Sat,  3 Apr 1999 17:17:06 -0500
  29
  30 developers-reference (2.6.0) frozen unstable; urgency=low
  31
  32   * would be nice to sneak this into slink; it's just documentation!
  33   * Ch. "Porting and Being Ported": porter information broken out into it's
  34     own chapter, Sec. "Guidelines for Porter Uploads" and "When to do a
  35     source NMU if you are a porter" moved to this chapter; porter tool
  36     descriptions such as 'quinn-diff' moved to this section.  Sec. "Being
  37     Kind to Porters" added, with tips for how to avoid making problems for
  38     porters.
  39   * Ch. "Non-Maintainer Uploads (NMUs)": update for the new chapter, and
  40     tighten up the language a bit
  41   * Sec. "Monitoring bugs": add a little cron job to get an 'index maint'
  42     of outstanding bugs (closes Bug#31259), loosen language a tiny bit
  43     w.r.t. non-maintainers or submitters closing bugs (closes Bug#30394)
  44   * Sec. "Scope of This Document": point out that this file is not
  45     official policy
  46   * Ch. "Handling Bugs": renamed from "Handling Bug Reports", incorporate
  47     some suggestions from James Troup, namely, don't mail from your root
  48     account, don't close bugs via control@bugs.debian.org; break out new
  49     sections, "Submitting Bugs" and "Responding to Bugs"
  50   * Ch. "Overview of Debian Maintainer Tools": remove attribution for
  51     package maintainers, since I can't keep up; add entries for fakeroot
  52     and devscripts
  53   * Ch. "Maintaining Your Debian Information": new chapter, quite small
  54     right now; it mentions keyring-maint@debian.org for key modification,
  55     warns against putting private keys on multi-user machines, and talks
  56     about how to depart Debian gracefully
  57   * typo correction from Christian Hudon (closes Bug#32052)
  58   * menu file removed, obsoleted by doc-base file
  59   * parameterize some often-changing values with SGML entities, update
  60     number of available packages
  61   * use new way of notating multiple copyrights
  62   * change <tt> elements to <file> where appropriate
  63
  64  -- Adam Di Carlo <aph@debian.org>  Thu, 11 Feb 1999 02:53:55 -0500
  65
  66 developers-reference (2.5.0.5) unstable; urgency=low
  67
  68   * add version.ent to docdir, needed to reconstruct from SGML
  69     (closes Bug#31034)
  70
  71  -- Adam Di Carlo <aph@debian.org>  Tue, 29 Dec 1998 02:42:50 -0500
  72
  73 developers-reference (2.5.0.4) unstable; urgency=low
  74
  75   * not officially released
  76   * more spelling corrections
  77   * s/ppc/powerpc/ (thanks, James Troup)
  78
  79  -- Adam Di Carlo <aph@debian.org>  Fri, 18 Dec 1998 00:07:40 -0500
  80
  81 developers-reference (2.5.0.3) unstable; urgency=low
  82
  83   * not officially released
  84   * Sec. "Removing a package from Incoming": tiny section added
  85   * some PGP-centricity removed
  86   * Sec. "Adopting a package": point out that hijacking packages is not ok
  87   * Ch. "Non-Maintainer Uploads (NMUs) and Porters": change 'NMU' to
  88     'source NMU', 'port' to 'binary NMU', shorten the window for porters a
  89     tad; fix spelling; stress that non-maintainer patches must be
  90     non-disruptive and that aesthetic issues are not suitable for fixing
  91     by non-maintainers; other fixes as suggested by interested parties
  92
  93  -- Adam Di Carlo <aph@debian.org>  Wed, 25 Nov 1998 00:01:27 -0500
  94
  95 developers-reference (2.5.0.2) frozen unstable; urgency=low
  96
  97   * not officially released
  98   * maintainer name change (but it's still me)
  99   * Ch. "Non-Maintainer Uploads (NMUs) and Porters":  new chapter
 100     discussing NMUs and porters; Section "Interim Releases" integrated out
 101     of existance.  New TOC for this section is:
 102          * 6 Non-Maintainer Uploads (NMUs) and Porters
 103             + 6.1 Who can do a port or an NMU
 104             + 6.2 When to do a port or an NMU
 105                  o 6.2.1 When to do an NMU if you are a porter
 106             + 6.3 How to do an NMU
 107                  o 6.3.1 NMU version numbering
 108                  o 6.3.2 NMUs must create a changelog entry
 109                  o 6.3.3 NMUs must send patches, if any, to the BTS
 110                  o 6.3.4 Building the NMU
 111             + 6.4 Guidelines for Porters
 112
 113   * Sec. "Maintainer changes": renamed to "Adopting a package" and moved
 114     to Chapter "Moving, Removing, Renaming, Adopting, and Orphaning
 115     Packages".
 116   * Sec. "Reporting lots of bugs at once": more forcefully deprecate this
 117     practice
 118   * Sec. "Adopting a package": mention that the BTS maintainer update can
 119     take a couple of weeks
 120   * Sec. "Overview of Debian Maintainer Tools": give credit where credit
 121     is due and attribute current maintainers; add `apt'; add `quinn-diff';
 122     add mention of as yet unreleased 'buildd' package, since I'm so
 123     excited about it and can't wait
 124   * Sec. "Removing packages": talk about how apt-cache can be used to look
 125     at reverse depends, a good step to take prior to removing a package
 126     from the archive
 127   * show *full* TOC, including sect2
 128   * of course the obligatory typo, grammar, and spelling corrections
 129
 130   * Makefile: small changes to accomodate DDP autobuild
 131   * debian/dirs: obsolete, removed
 132   * debian/rules: use changelog date for SGML timestamping, not current date
 133
 134  -- Adam Di Carlo <aph@debian.org>  Fri, 20 Nov 1998 12:27:53 -0500
 135
 136 developers-reference (2.5.0) frozen unstable; urgency=low
 137
 138   * move to 3-level version number:
 139     top-level version number probably won't change for a whil, it is the
 140     "major", the second-level number means significant content changes,
 141     and the third-level change means corrections and minor improvements.
 142     Since this version has significant content changes, we are now 2.5.0.
 143     Since I'm going to put porter instructions in the next major rev, that
 144     will be 2.6.0...
 145
 146   * use new <package> tag where appropriate (Ardo, you rock)
 147   * replace 'm86k' with 'm68k'
 148   * rename 'Whirlwind Tour of ...' section to 'Overview of ...' (suggested
 149     by James Troup)
 150   * typos and "red-pen" corrections, fix cosmetic problems in PostScript
 151     version
 152   * remove the one case I use an URL fragment identifier, since
 153     debiandoc-sgml doesn't like it (bug filed against debiandoc-sgml)
 154   * debian/rules: cosmetic cleanups, loosen check for root
 155   * debian/rules: build PostScript version during build, since it's nice
 156     to have all my debiandoc2* scripts together
 157   * debian/control: policy compliant to 2.5.0
 158
 159   * advise against uploading when a package has lintian problems of
 160     severity 'E'
 161   * "Mailing Lists and Servers":
 162     - "The master server": mention how master is the home of the BTS;
 163       mention how users need to take care with their accounts on master
 164     - "The WWW servers": fill in www.debian.org, first pass, and discuss
 165       how to put up your own web pages on va or master
 166     - "The CVS server": new section added
 167     - "Mirrors of Debian servers": new section added; point to info about
 168        how to mirror
 169   * "Applying to Become a Maintainer": do not advise resending initial
 170     application; instead, simply mail a followup asking new maintainers
 171     whether they go the initial application (closes Bug #28739); mention
 172     that calls usually come in the evening; mention that if you use PGP
 173     v5, you need to generate an RSA key (right?); clarify our intentions
 174     with respect to GPG.
 175   * "Release code names": Debian 2.2 is 'potato'
 176   * "Distribution directories": give concrete examples, hopefully making
 177     it clearer where to look in Debian archives for specific stuff;
 178     mention that old distributions are moved to archive servers (is there
 179     a canonical location?)
 180   * "The override file": new section, added under "Notification that a new
 181     package has been installed"; fill it out quite a bit
 182   * "Uploading to *": reiterate thrice not to upload export
 183     controlled-software to master, or the European queues on erlangen and
 184     chiark
 185   * "Picking a distribution": section broken out from "Generating the
 186     changes file"
 187   * "Uploading to frozen": new section, almost straight from Brian White
 188     (hope you don't mind!) -- isn't that topical?
 189   * "Interim releases": if you NMU a new upstream version (0.1), run
 190     'dpkg-buildpackage -sa'
 191
 192  -- Adam P. Harris <aph@debian.org>  Thu, 12 Nov 1998 00:03:43 -0500
 193
 194 developers-reference (2.4.1.5) unstable; urgency=low
 195
 196   * Fix instructions for new maintainers, incorporating the actual text
 197     sent to prospective new maintainers.  Improve this text a bit for
 198     readability, coverage, and organization.  Significant changes were
 199     patched back to the new-maintainers group, if they care to use
 200     them. (closes Bug#26948)
 201   * Add an introductory "Scope" chapter which helps delineate what should
 202     and should not be included in this Reference.
 203   * Add a new chapter, "Whirlwind Tour of Debian Maintainer Tools".  Let
 204     me know what useful tools I forgot -- remember, Debian-specific
 205     maintainer tools only!
 206   * Add discussion of the "experimental" distribution, culled from an email
 207     from Guy Maor on debian-devel.
 208   * Incorporated suggestions from Branden Robinson (closes Bug#27211).
 209   * Point to doc-debian's mailing list instructions where relevant.
 210   * Made references to online documentation into URLs where possible.
 211   * Little corrections here and there.
 212   * add a Makefile for use in the DDP manual hierarchy
 213   * debian/rules: comment out my 'source-depends' hack; it's just slowing
 214     things down
 215
 216  -- Adam P. Harris <aph@debian.org>  Thu,  1 Oct 1998 03:42:43 -0400
 217
 218 developers-reference (2.4.1.4) unstable; urgency=low
 219
 220   * fill in Section "The master server" a bit; other servers to follow
 221   * in Section "Distribution directories", mention that distributions
 222     are always in 'dists' subdir of the Debian archive; talk about
 223     'proposed-updates'
 224   * in Section "Release code names", talk about 'sid' a bit
 225   * in Section "Interim releases", talk about how non-maintainers should
 226     use the BTS, and bug severity "fixed" (closes Bug#17524)
 227   * in Section "Generating the changes file", talk about how to set the
 228     distribution in the debian/changelog file (i.e., "frozen unstable")
 229   * add a new Section "Checking the package prior to upload" to Section
 230     "Uploading a package", mentioning lintian and other tests one should
 231     do prior to uploading
 232   * add new Section "Notification that a new package has been installed"
 233     in Section "Uploading a package", talking about dinstall and the
 234     override file a bit
 235   * add new Sections "Moving packages", "Removing packages", "Replacing or
 236     renaming packages", and "Orphaning a package" (closes Bug#26650)
 237   * add new Section "Bugs in your packages", talking about maintainer
 238     duties with respect to bugs
 239   * add new Section "Lintian reports" under "Handling bugs reports",
 240     talking about how maintainers should check their packages with lintian
 241     every now and then, alternatively pointing them to the lintian web
 242     pages
 243   * clarify, a bit, the use of "section" and "subsection", bringing it
 244     into line with the usage in the Policy Manual and Packaging Manual
 245   * grammar and markup changes throughout
 246   * debian/rules: added a crude source-depends rule, which renders more
 247     explicit what is used to build this package
 248
 249  -- Adam P. Harris <aph@debian.org>  Mon, 21 Sep 1998 00:51:46 -0400
 250
 251 developers-reference (2.4.1.3) unstable; urgency=low
 252
 253   * new maintainer
 254   * version number and date are automatically populated now
 255   * changed doc-base section to "debian"
 256   * debian/rules: better abstraction and organization
 257   * reformat SGML like I happen to like it
 258   * utilize the new URL tag
 259   * build PostScript on letter size, I hear thats better for A4 and US
 260     letter printing
 261
 262  -- Adam P. Harris <aph@debian.org>  Thu, 16 Jul 1998 00:52:35 -0400
 263
 264 developers-reference (2.4.1.2) frozen unstable; urgency=low
 265
 266   * non-maintainer release
 267   * rebuilt since HTML versions of Chapters 1 and 2 were truncated
 268     (important bug, no number yet, bugs.debian.org isn't working;
 269     regardless, this should go in hamm because a broken developers
 270     reference won't win us many friends in hamm, and after all, it's just
 271     text, it can't hurt you.)
 272   * no content changes, except that the version number in the SGML file
 273     reflect this packages version number
 274   * debian/rule: clean is cleaner now
 275
 276  -- Adam P. Harris <aph@debian.org>  Tue, 16 Jun 1998 01:35:39 -0400
 277
 278 developers-reference (2.4.1.1) frozen unstable; urgency=low
 279
 280   * Orphaned package
 281
 282  -- Christian Schwarz <schwarz@debian.org>  Thu, 14 May 1998 21:56:36 +0200
 283
 284 developers-reference (2.4.1.0) frozen unstable; urgency=low
 285
 286   * New version numbering scheme:
 287
 288     - The version numbers are independent of dpkg now, but all policy
 289       manuals (the Debian Policy Manual, the Debian Packaging Manual, and
 290       the Debian Developer's Reference) share the same version numbering
 291       scheme.
 292
 293     - The first three digits of the version number specify the
 294       `Standards-Version.' This number is incremented with each policy
 295       change. The fourth digit represents the `patch-level,' which may
 296       differ between the manuals.
 297
 298       If only the patch-level digit is incremented, no changes in policy
 299       have been made, except bug fixes and clarifications. Packages only
 300       have to specify the first three digits of the version number in the
 301       `Standards-Version' field of their source packages.
 302
 303   * Uploaded to frozen and unstable. This is a documentation-only
 304     package and the changes to the manual are relevant for hamm.
 305
 306   * No changes to the Developer's Reference
 307
 308  -- Christian Schwarz <schwarz@debian.org>  Mon, 13 Apr 1998 17:54:43 +0200
 309
 310 developers-reference (0.5) unstable; urgency=low
 311
 312   * Changes to the Developer's Reference:
 313
 314     - Changed section 1.2 Registering as a Debian developer:
 315       + signatures from formal certification service are _NOT_ accepted
 316         anymore
 317       + images of ID documents have to be PGP or RSA signed
 318       (as requested by James Troup)
 319
 320     - Use current date instead of <date> in manual
 321
 322   * Updated FSF's address (reported by Lintian)
 323
 324  -- Christian Schwarz <schwarz@debian.org>  Sat,  7 Mar 1998 13:52:15 +0100
 325
 326 developers-reference (0.4) unstable; urgency=low
 327
 328   * Changes to the Developer's Reference:
 329
 330     - Renamed chapter 4 into `Package uploads'
 331
 332     - New section 4.2.5 Uploading to the non-us server
 333
 334     - Changed section 4.4 Interim releases:
 335       + non-maintainer releases should not close bugs
 336       + normal maintainer must at least read the patch provided with
 337         the non-maintainer release
 338
 339     - New chapter 5 Handling bug reports:
 340       + when reporting more then 10 bugs on the same topic, a message
 341         has to be sent to debian-devel and the `maintonly' address
 342         should be used
 343
 344     - Lots of typos fixed
 345
 346   * Compressed SGML source code
 347
 348   * Added support for doc-base to register the Developer's Reference
 349     to the online documentation systems dwww and dhelp
 350
 351   * Upgraded to standards version 2.4.0.0 (no changes)
 352
 353  -- Christian Schwarz <schwarz@debian.org>  Fri, 30 Jan 1998 21:58:34 +0100
 354
 355 developers-reference (0.3) unstable; urgency=low
 356
 357   * Put lost sections from Policy Manual 2.1.3.3 back in:
 358       - Generating the changes file (for uploads)
 359       - Announcing package uploads
 360   * New section about Debian Mentors
 361   * debian/rules: Don't use debstd anymore
 362   * debian/rules: Compress changelog file (fixes:#15441)
 363   * Fixed link to WNPP list (fixes:#16201)
 364   * Added menu entry (fixes:#15708)
 365
 366  -- Christian Schwarz <schwarz@debian.org>  Wed, 24 Dec 1997 13:54:33 +0100
 367
 368 developers-reference (0.2) unstable; urgency=low
 369
 370   * New chapter about `The Debian Archive' describing the structure
 371     of our FTP server and the development process
 372   * Added note that new maintainers have to read the Social Contract
 373     and have to know where to find the Policy and Packaging Manuals
 374   * PGP key ring is not distributed via dpkg but in doc/ of the FTP
 375     server
 376   * Added note that cross posting between Debian lists is depreciated
 377   * New list of advantages why new packages should be discussed on
 378     debian-devel before they are uploaded
 379   * Added section about how packages are uploaded
 380   * Added note that the Security Managers may do interim releases without
 381     contacting the maintainer
 382   * Removed chapter about bug tracking system (will be included in
 383     a new manual released soon)
 384   * Some minor changes
 385   * Include SGML source in package
 386   * Don't use `2-up' style for PostScript version
 387   * Upgraded to Standards 2.3.0.1
 388
 389  -- Christian Schwarz <schwarz@debian.org>  Sun,  2 Nov 1997 20:53:26 +0100
 390
 391 developers-reference (0.1) unstable; urgency=low
 392
 393   * Initial Release.
 394
 395  -- Christian Schwarz <schwarz@debian.org>  Tue, 8 Jul 1997 00:19:49 +0200
 396
 397 Local variables:
 398 mode: debian-changelog
 399 mode: auto-fill
 400 End: