[developers-reference.git] / debian / changelog

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 DSA keys rather than
    RSA
  * Sec. "Maintaining Your Public Key": remove PGP-centric stuff
  * 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>  Sat, 11 Sep 1999 21:22:10 -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 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
    sent to prospective new maintainers.  Improve this text a bit for
    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" 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.
  * add a Makefile for use in the DDP manual hierarchy
  * debian/rules: comment out my 'source-depends' hack; it's just slowing
    things down

 -- Adam P. Harris <aph@debian.org>  Thu,  1 Oct 1998 03:42:43 -0400

developers-reference (2.4.1.4) unstable; urgency=low

  * fill in Section "The master server" a bit; other servers to follow
  * in Section "Distribution directories", mention that distributions
    are always in 'dists' subdir of the Debian archive; talk about
    'proposed-updates'
  * in Section "Release code names", talk about 'sid' a bit
  * in Section "Interim releases", talk about how non-maintainers should
    use the BTS, and bug severity "fixed" (closes Bug#17524)
  * in Section "Generating the changes file", talk about how to set the
    distribution in the debian/changelog file (i.e., "frozen unstable")
  * add a new Section "Checking the package prior to upload" to Section
    "Uploading a package", mentioning lintian and other tests one should
    do prior to uploading
  * add new Section "Notification that a new package has been installed"
    in Section "Uploading a package", talking about dinstall and the
    override file a bit
  * add new Sections "Moving packages", "Removing packages", "Replacing or
    renaming packages", and "Orphaning a package" (closes Bug#26650)
  * add new Section "Bugs in your packages", talking about maintainer
    duties with respect to bugs
  * add new Section "Lintian reports" under "Handling bugs reports",
    talking about how maintainers should check their packages with lintian 
    every now and then, alternatively pointing them to the lintian web
    pages
  * clarify, a bit, the use of "section" and "subsection", bringing it
    into line with the usage in the Policy Manual and Packaging Manual
  * grammar and markup changes throughout
  * debian/rules: added a crude source-depends rule, which renders more
    explicit what is used to build this package

 -- Adam P. Harris <aph@debian.org>  Mon, 21 Sep 1998 00:51:46 -0400

developers-reference (2.4.1.3) unstable; urgency=low

  * new maintainer
  * version number and date are automatically populated now
  * changed doc-base section to "debian"
  * debian/rules: better abstraction and organization
  * reformat SGML like I happen to like it
  * utilize the new URL tag
  * build PostScript on letter size, I hear thats better for A4 and US
    letter printing

 -- Adam P. Harris <aph@debian.org>  Thu, 16 Jul 1998 00:52:35 -0400

developers-reference (2.4.1.2) frozen unstable; urgency=low

  * non-maintainer release
  * rebuilt since HTML versions of Chapters 1 and 2 were truncated
    (important bug, no number yet, bugs.debian.org isn't working;
    regardless, this should go in hamm because a broken developers
    reference won't win us many friends in hamm, and after all, it's just
    text, it can't hurt you.)
  * no content changes, except that the version number in the SGML file
    reflect this packages version number
  * debian/rule: clean is cleaner now

 -- Adam P. Harris <aph@debian.org>  Tue, 16 Jun 1998 01:35:39 -0400

developers-reference (2.4.1.1) frozen unstable; urgency=low

  * Orphaned package

 -- Christian Schwarz <schwarz@debian.org>  Thu, 14 May 1998 21:56:36 +0200

developers-reference (2.4.1.0) frozen unstable; urgency=low

  * New version numbering scheme:
  
    - The version numbers are independent of dpkg now, but all policy
      manuals (the Debian Policy Manual, the Debian Packaging Manual, and
      the Debian Developer's Reference) share the same version numbering
      scheme.
    
    - The first three digits of the version number specify the
      `Standards-Version.' This number is incremented with each policy
      change. The fourth digit represents the `patch-level,' which may
      differ between the manuals. 
  
      If only the patch-level digit is incremented, no changes in policy
      have been made, except bug fixes and clarifications. Packages only
      have to specify the first three digits of the version number in the
      `Standards-Version' field of their source packages.
  
  * Uploaded to frozen and unstable. This is a documentation-only
    package and the changes to the manual are relevant for hamm.

  * No changes to the Developer's Reference
  
 -- Christian Schwarz <schwarz@debian.org>  Mon, 13 Apr 1998 17:54:43 +0200

developers-reference (0.5) unstable; urgency=low

  * Changes to the Developer's Reference:
  
    - Changed section 1.2 Registering as a Debian developer:
      + signatures from formal certification service are _NOT_ accepted
        anymore
      + images of ID documents have to be PGP or RSA signed
      (as requested by James Troup)
  
    - Use current date instead of <date> in manual
    
  * Updated FSF's address (reported by Lintian)

 -- Christian Schwarz <schwarz@debian.org>  Sat,  7 Mar 1998 13:52:15 +0100

developers-reference (0.4) unstable; urgency=low

  * Changes to the Developer's Reference:

    - Renamed chapter 4 into `Package uploads'

    - New section 4.2.5 Uploading to the non-us server

    - Changed section 4.4 Interim releases:
      + non-maintainer releases should not close bugs
      + normal maintainer must at least read the patch provided with
        the non-maintainer release

    - New chapter 5 Handling bug reports:
      + when reporting more then 10 bugs on the same topic, a message
        has to be sent to debian-devel and the `maintonly' address
        should be used

    - Lots of typos fixed

  * Compressed SGML source code

  * Added support for doc-base to register the Developer's Reference
    to the online documentation systems dwww and dhelp

  * Upgraded to standards version 2.4.0.0 (no changes)
  
 -- Christian Schwarz <schwarz@debian.org>  Fri, 30 Jan 1998 21:58:34 +0100
  
developers-reference (0.3) unstable; urgency=low

  * Put lost sections from Policy Manual 2.1.3.3 back in:
      - Generating the changes file (for uploads)
      - Announcing package uploads
  * New section about Debian Mentors
  * debian/rules: Don't use debstd anymore
  * debian/rules: Compress changelog file (fixes:#15441)
  * Fixed link to WNPP list (fixes:#16201)
  * Added menu entry (fixes:#15708)
  
 -- Christian Schwarz <schwarz@debian.org>  Wed, 24 Dec 1997 13:54:33 +0100
  
developers-reference (0.2) unstable; urgency=low

  * New chapter about `The Debian Archive' describing the structure
    of our FTP server and the development process
  * Added note that new maintainers have to read the Social Contract
    and have to know where to find the Policy and Packaging Manuals
  * PGP key ring is not distributed via dpkg but in doc/ of the FTP
    server
  * Added note that cross posting between Debian lists is depreciated
  * New list of advantages why new packages should be discussed on
    debian-devel before they are uploaded
  * Added section about how packages are uploaded
  * Added note that the Security Managers may do interim releases without 
    contacting the maintainer
  * Removed chapter about bug tracking system (will be included in
    a new manual released soon)
  * Some minor changes
  * Include SGML source in package
  * Don't use `2-up' style for PostScript version
  * Upgraded to Standards 2.3.0.1

 -- Christian Schwarz <schwarz@debian.org>  Sun,  2 Nov 1997 20:53:26 +0100
  
developers-reference (0.1) unstable; urgency=low

  * Initial Release.

 -- Christian Schwarz <schwarz@debian.org>  Tue, 8 Jul 1997 00:19:49 +0200

Local variables:
mode: debian-changelog
mode: auto-fill
End: