debian/changelog

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