[developers-reference.git] / debian / changelog

developers-reference (3.3.2) unstable; urgency=low

  * Frédéric Bothamy:
    - French translation updated to version 3.3.1
    - proofread by Philippe Batailler and Patrice Karatchentzeff

 -- Adam Di Carlo <aph@debian.org>  Fri, 18 Apr 2003 09:21:52 -0400

developers-reference (3.3.1) unstable; urgency=low

  * Josip Rodin:
    - package description said it contained French and Japanese, fixed,
      closes: #182614
    - Sec "Experimental": sources.list entries
    - Sec "Basic rules for [mailing list] use": cosmetic, link to this sec
    - Sec "Handling bugs": retitle and expand section
  * Adam Di Carlo:
    - more improvements to package synopsis and description
    - the synopsis formula changed to either
       <package-name> is a <synopsis>
      or
       <package-name> is <synopsis>
      or
       <package-name> are <synopsis>
      closes: #182956
    - the synopsis itself should not start with an article
    - Sec "Best practices for debian/control": expand intro
    - fix doc-check URL; closes: #187144
    - Sec "Multiple binary packages": fix awkward wording about vim source
      package; closes: #187143

 -- Adam Di Carlo <aph@debian.org>  Fri,  4 Apr 2003 14:26:52 -0500

developers-reference (3.3) unstable; urgency=low

  * Frédéric Bothamy:
    - French translation updated to version 3.2.2 (more or less)
    - proofread by Philippe Batailler
  * Raphaël Hertzog:
    - added "ddtp" keyword in the PTS documentation
  * Josip Rodin:
    - split out the doc-files per language, closes: #177448
    - shuffled stuff around in the packages chapter
    - added a section describing how to handle large amounts of
      architecture-independent data bundled with programs
    - added best practices on debian/changelog files, based on a patch
      kindly provided by Daniel Kobras, closes: #166388
    - described debdiff and dpkg-depcheck, and linked to them from the
      right places in the document, closes: #172897
    - describe the current practice in writing synopsis lines,
      closes: #174161
  * Adam Di Carlo:
    - update (c) year
    - convert to debhelper (compat mode 4); maintainer scripts no longer
      needed
    - split -ja and -fr versions out into separate packages
    - top-level makefile deletes targets on error; clean is cleaner
    - replace the manual debian/control processing to show the document's
      table of contents (TOC) with a new script 'debian/tocsubstvars';
      note that the TOC displayed in the developers-reference-{fr,ja}
      package descriptions are in English until UTF8 control files are
      allowed; proper escaping of single quotes here requires newest
      debhelper
    - editorial changes on material added in this version
    - reorder "Best Packaging Practices" a bit
    - rework "Best practices for debian/control" based on contributions
      from Colin Walters, Branden Robinson, Sebastian Rittau and others;
      closes: #139957, #108416
    - primary author is developers-reference@packages.debian.org; remove
      emails from other authors to prevent spam and confusion

 -- Adam Di Carlo <aph@debian.org>  Mon, 24 Feb 2003 13:29:07 -0500

developers-reference (3.2.2) unstable; urgency=low

  * Josip Rodin:
    - slightly rewrote and updated links in the mirrors section
  * Adam Di Carlo:
    - Policy compliance checked and updated to 3.5.8, no changes needed
    - TODO: remove some tasks which are done
    - ship README-contrib and TODO in the doc dir
    - Sec "Upstream home page": some revisions based on discussion on
      policy list
    - Sec "Documentation" added under Sec "Common packaging situations"
      for best practices for documentation
    - Add tools entries for autotools-dev, dpkg-repack, alien, debsums;
      new Sec "Documentation and information", add entries there for
      debview, debiandoc-sgml, debian-keyring; we believe this manual now
      covers all of the established, general Debian maintainer tool
      packages
    - spell-checking pass

 -- Adam Di Carlo <aph@debian.org>  Thu, 12 Dec 2002 13:45:23 -0500

developers-reference (3.2.1) unstable; urgency=low

  * Adam Di Carlo:
    - Sec "Best practices for debian/control" added, Sec "Writing useful
      descriptions" moved under there
    - Sec "Upstream home page" added in debian/control section
    - Sec "Miscellaneous advice" empty, removed
    - Sec "Overview of maintainer tools": tools now categorized into
      subgroups; do cross-linking from this section into other parts of
      the document where these tools are discussed
    - Sec "Overview of maintainer tools": add entries for sbuild,
      build-essential, linda; improved entries for pbuilder, devscripts
    - Sec "Tools for porters" renamed and readapted to "Porting
      infrastructure and automation"; move tool discussion down to the
      appendix; improve Sec "buildd" a bit
    - README-contrib added giving information for authors, contributors,
      and translators
    - eliminate the ByHand stuff, I'm pretty sure it's not needed now
      with the DDP builder process, or if it is needed, it's a probably
      that can be fixed by DDP folks
    - stop shipping SGML source -- use 'apt-get source developers-reference'
      after all, this is supposed to be a binary package, right?
    - simply PS and PDF building rules
  
 -- Adam Di Carlo <aph@debian.org>  Mon,  9 Dec 2002 03:04:19 -0500

developers-reference (3.2) unstable; urgency=low

  * Josip Rodin:
    - merged a bit misplaced lintian-reports section within the lintian
      section and adjusted links
    - added the missing description of dh-make and adjusted links
  * Adam Di Carlo:
    - ChangeLog attribution updates
    - fix typos, closes: #171781
    - expand the doc-base abstract and authors
    - Ch "Packaging Practices" rewritten intro
    - Sec "Packaging tools and common cases" renamed to "Best Practices
      for debian/rules", and write an intro
    - Sec "Helper scripts" in practices section rewritten, giving
      arguments for and against debhelper, mostly for :)
    - Sec "Package with multiple patches" renamed to "Patching source
      versus patching at build time" and rewritten
    - Sec "Multiple binary packages" rewritten
    - Sec "Handling debconf translations" moved under an
      "Internationalization" section, and some edits
    - Sec "Internationalized Documentation" added under Sec
      "Internationalization"
    - Sec "Specific packaging practices" renamed to "Common packaging situations"
    - Sec "Packages using autoconf/automake" rewritten
    - Sec "Configuration management" moved forward in practices chapter
    - Sec "Other specific packages" renamed to "Specific types of
      packages", add info for SGML/XML and Lisp packages
    - Sec "Writing useful descriptions" heavily edited
    - Sec "Best practices for maintainer scripts" added, special credit
      here to Charles Briscoe-Smith for work dating back to 1998; include
      a POSIX shell snippet showing how to check if a command is the PATH,
      closes: #150384
    - Apdx "Overview of Debian Maintainer Tools": remove debget, it's
      rather useless and broken
    - normalize up-casing on sections, which should only up-case proper
      names and the first word
    - new 'translation-status' script to check status of translations,
      adapted from doc-check in boot-floppies, source pkg only --
      oh my, French translation is 54 CVS revisions behind, and Japanese
      is 108 behind
    - postinst: don't set /usr/doc symlink, aesthetics
    - prerm: don't use 'command -v', it's not POSIX
    - rules: produce md5sums file; break out a 'test' target

 -- Adam Di Carlo <aph@debian.org>  Sat,  7 Dec 2002 02:28:06 -0500

developers-reference (3.1.2) unstable; urgency=low

  * Josip Rodin:
    - DDP publishing update
  * Adam Di Carlo:
    - doc-base file includes French and Japanese files
    - debsign invocation was slightly wrong, closes: #170523
    - Sec "Handling debconf translations", updates from Martin Quinson
      for po-debconf with minimal editorial changes, closes: #169007

 -- Adam Di Carlo <aph@debian.org>  Wed, 27 Nov 2002 21:16:30 -0500

developers-reference (3.1.1) unstable; urgency=low

  * Josip Rodin:
    - updated IRC stuff, thanks to Ben Armstrong, closes: #161403
    - fixed/updated/extended stuff about bugs, hoping to address the
      issue of people abusing the changelog bug closing feature
  * Raphaël Hertzog:
    - added myself as co-author
    - fix a typo in Sec "Collaborative maintenance", closes: #161488
  * Matt Zimmerman:
    - updated security information, merging in Joey's stuff from the
      Security Team FAQ and various updates and clarifications
  * Adam Di Carlo
    - fix some bad URLs, closes: #168357
    - fix a grammar typo, closes: #166098

 -- Adam Di Carlo <aph@debian.org>  Tue, 12 Nov 2002 23:15:03 -0500

developers-reference (3.1) unstable; urgency=low

  * Raphaël Hertzog:
    - Corrected several errors with &mdash;
    - Applied patch from Peter Palfrader, correcting
      the URL for the Debian Voting Information page. closes: #150427
    - Applied patch from Matej Vela, dpkg-buildpackage does no more
      require -sa for version -0.1. closes: #150861
    - Applied the reformulations proposed by David Kimdon. closes: #150572
    - Applied the patch of Matt Zimmerman. Thanks Matt! closes: #145287
    - Added the explanation about how to replace an .orig.tar.gz.
      closes: #150392
    - Mostly deleted the paragraph about security upload in the
      section explaining source NMU. Just added a link to point to
      "Handling security-related bugs". closes: #159935
    - Added a link to the Technical Committee web page (in the "Bug
      housekeeping" section). closes: #151365
    - Explain uploads to testing-proposed-updates, mentions briefly
      stable-security and testing-security. closes: #149666
      Removed the comment about uploads to frozen.
    - Documented the "Developer's packages overview" web portal.
      closes: #158650
    - Added a reference to debian-l10n-english in "Writing useful
      descriptions". closes: #158609
    - Added a Best Packaging Practice section for "Packages using
      autoconf/automake". closes: #158045
    - Documented associated features to db.debian.org like SSH key
      replication and *.debian.net DNS entry. closes: #155389
    - Added a section about "Bug Squashing Parties".
  * Josip Rodin:
    - removed obsolete, needless dupload variables
    - applied linguistic fixes from David Kimdon, closes: #150572
    - random proofreading, mostly changing he -> they
    - added people.d.o and non-us.d.o to the Debian servers section, and
      mostly rewrote it to exclude real machine names and be better organized
    - updated the mailing lists section
  * Adam Di Carlo
    - debian/changelog: remove obsolete Emacs variables
    - editorial review of the changes above, minor tagging changes,
      spelling fixes

 -- Adam Di Carlo <aph@debian.org>  Tue, 10 Sep 2002 21:57:41 -0400

developers-reference (3.0) unstable; urgency=low

  * Adam Di Carlo:
    - welcome Manoj Srivastava as a co-maintainer
    - welcome Raphael Hertzog as a co-maintainer

    - new Chapter "Resource for Debian Developers", incorporating
      the former chapters
       Ch "Mailing Lists, Servers, and Other Machines"
       Ch "The Debian Archive"
  
    - new Chapter "Managing Packages", incorporating former chapters
       Ch "Package uploads"
       Ch "Non-Maintainer Uploads (NMUs)"
       Ch "Porting and Being Ported"
       Ch "Moving, Removing, Renaming, Adopting, and Orphaning Packages"
       Ch "Handling Bugs" (retitled "Handling package bugs")
       Sec "Bug housekeeping" (new section, some parts stubbed out)
     
    - new Chapter "Beyond Packaging" recommends ways to contribute
      to Debian beyond issues of package maintenance; incoporates
      Ch "Interaction with Prospective Developers", retitled to
          Sec "Interacting with Prospective Debian Developers"
      Sec "Submitting Bugs", renamed to "Reporting Bugs"
      Sec "QA" moved here from old Sec "Quality Assurance effort"
      Sec "Dealing with unreachable maintainers"

    - Sec "The Developers Database" added under Resources
    - new Sec "Collaborative Maintenance" concerning multiple maintainers
      for one package

    - Sec "Getting started": add link to New Maintainers' Guide
    - Sec "Debian Mentors" renamed to "Debian Mentors and Sponsors",
      we add some info on sponsoring; also in Sec "Sponsoring packages"
    - Section's first word capitalized, rest are normal case
    - purge a reference to the Packaging Manual; closes: #145039
    - misc. cross-referencing with new or moved sections
    - change some literal quotes to &lsquo;, &rdquo;, etc.
    - tagging improvements: replace <tt> with <file> for files and
      directories; since <tt><var> and <example><var> doesn't look right,
      work-around with &lt;...&gt;
    - entity'ize master.debian.org, us-upload-dir, non-us-upload-dir
    - update copyright date
    - some simplifications on the TeX suffix rule
    - spell check and grammar corrections
    - s/GPG/GnuPG/

  * Raphael Hertzog:
    - changed -e by -m in the dpkg-buildpackage command line example;
      closes: #110310
    - clarify wording between "porter upload", "binary-only NMU", "simple
      recompile"; closes: #102626
    - extended "removing a package"; closes: #135560
    - Ch "Best Packaging Practices": new chapter, including new
      Sec "Writing useful descriptions" as a first entry in that
      chapter; closes: #53109, #129848
    - indicate that the list of subsections is defined in the policy;
      closes: #123586
    - removed some cruft in `Announcing package uploads'
    - document the testing scripts; closes: #129445
    - explain how to reassign/close bugs of removed packages; 
      closes: #130255
    - updates the note about software subject to US patents; 
      closes: #142798
    - new Section "Contacting other maintainers" under "Beyond packaging"
      Document the package@packages.debian.org alias; closes: #114553
    - new Section "Package's information" under Resources
      Document http://packages.debian.org/<package>,
      http://bugs.debian.org/<package> and the madison utility
    - Sec "Reporting bugs": added http://bugs.debian.org/from:email@isp.com
    - Sec "Handling bugs": added http://bugs.debian.org/login@debian.org
    - Sec "The Incoming system" in "Resources", describe how it works and
      also speak of the DELAYED directory; closes: #135562, #136774
    - spelling fixes
    - Sec "Developer Database": added a sentence about finger
      login@debian.org
    - update the total number of packages and the example directory tree
      of a Debian archive
    - updated the list of available architectures.
    - commented out the "Subsections" section since it will RSN have nothing
      to with the Debian archive. It's just a generic information field
      of the package and nothing more.
    - added more incentive to use experimental since it doesn't cause
      any pain to the ftpmasters.
    - Sec "When to do a source NMU": updated the NMU "protocol" and suggest
      the use of the delayed queue.
    - new Section "Acknowledging the NMUs" to explain the need to integrate
      the changes introduced by NMUs. Insists on the fact that one shouldn't
      be upset by a NMU.
    - stubbed in new Section "Collaborative maintenance"
    - stubbed in new Section "The Package Tracking System"
    - Sec "The Package Tracking System": filled with content from
      Francesco Paolo Lovergine, heavily updated by myself
    - new Section "Managing sponsored packages" contributed by
      Francesco Paolo Lovergine, slightly updated by myself
    - new Sec "Bug housekeeping"; closes: #39519
    - new Sec "Voting"
    - new Sec "Documentation"
    - added Sec "IRC channels" in the Resources chapter
    - added Sec "pbuilder" in the appendix. Mention it in the section
      "Being kind to porter" too
    - extended Sec "devscripts" with info about "bts" and "uscan"
    - completed Sec "Helper scripts"
    - completed Sec "Package with multiple patches",
      "Multiple binary packages", "Libraries", "Other specific packages",
      "The wise use of debconf" -- all those are quite simplistic, they
      can be improved
    - integrated Sec "Handling debconf translations" contributed by
      Denis Barbier -- thanks, Denis!

  * Antoine Hulin:
    - update French translation

 -- Adam Di Carlo <aph@debian.org>  Fri, 14 Jun 2002 01:18:19 -0400

developers-reference (2.11) unstable; urgency=low

  * Antoine Hulin:
    - some grammar corrections
    - update French translation
  * Martin Michlmayr:
    - changes in upload situation, not possible to remove from Incoming
      anymore; closes: #135559
    - also talk about dput a tiny bit
  * Adam Di Carlo:
    - Ch "Overview of Debian Maintainer Tools":
      - improve the intro
      - Charles Briscoe-Smith deprecates yada (I think new maintainers of
        that would be welcome)
      - debconf-doc mentioned for debconf
      - debhelper: don't talk about debmake; mention how to get info on the dh-* pkgs
      - dput: new section, closes: #129378
      - debootstrap: new section, closes: #129377
      - dpkg-dev-el: new section
      - other minor wording changes
    - Sec "Mailing Lists": where to find private archives, closes: #96780
    - Ch "Package uploads":
      - new Sec "Adding an entry to debian/changelog"
      - rename Sec "Announcing new packages" to "New packages"
    - crypto is in main, non-US is for patent restrictions, so:
      - excise some text from "Registering as a Debian developer"
      - changes in Sec "Uploading to ftp-master"
      - changes in Sec "Uploading to non-US"
  * old bugs closed out, closes: #110573

 -- Adam Di Carlo <aph@debian.org>  Sun,  7 Apr 2002 23:34:08 -0700

developers-reference (2.10.0) unstable; urgency=low

  * from Martin Michlmayr
    - update the "Applying to Become a New Maintainer" section, with
      review by Raphael Hertzog, closes: #133965
    - bugs closed in NMUs should uses 'closes' changelog entries,
      closes: #133951
    - developers are not required to subscribe to debian-private
      closes: #133955
    - some suggestions on places to use the proper term, Debian GNU/Linux,
      closes: #133953
    - fix some typos, closes: #133956
  * Adam Di Carlo:
    - frozen doesn't exist anymore, just testing; note, however, that
      there is a way to upload to 'woody-proposed-updates' -- if I can
      find some description of that, I'll document it; closes: #133948
    - minor build tweaks
    - minor cosmetics
    - isolate a few more language-independent bits
  * from Chris Tillman
    - change /usr/doc to /usr/share/doc, and typo in debian/copyright,
      closes: #126924

 -- Adam Di Carlo <aph@debian.org>  Sun, 24 Feb 2002 14:46:46 -0500

developers-reference (2.9.0) unstable; urgency=low

  * Josip Rodin: 
    - created a new subsection about uploading to stable, and elaborated
      about that subject
    - removed a stray sentence about stable from the paragraph about
      security uploads (which apply to all distributions equally)
    - replaced the nonexistent term "Security Manager" with "security officer"
    - uploading to stable and unstable is deprecated; updated the section
      about the experimental distribution; other fixes in the section
      talking about uploading to distributions
    - better organize some subsections in the section about package uploads
    - replaced some bogus <ftppath>s with <tt>s
    - noted how there is an upload queue on pandora, too
  * Antoine Hulin:
    - French translation updated
  * Adam Di Carlo:
    - normalize '--' as &mdash; for prettier output
    - integrate changes from James Troup, part of #102626
    - typo fix thanks to Mark Hodge

 -- Adam Di Carlo <aph@debian.org>  Sun, 21 Oct 2001 01:03:01 -0400

developers-reference (2.8.8) unstable; urgency=low

  * from Josip Rodin:
    - a few more strong words about sponsoring
    - started a new chapter about the relationship between old and new
      developers

 -- Adam Di Carlo <aph@debian.org>  Fri, 20 Jul 2001 17:53:47 -0400

developers-reference (2.8.7) unstable; urgency=low

  * French updates
  * fix a typo in a link
  * dpkg-buildpackage -m<addr> flag was changed for -e<addr> when NMU'ing;
    update documentation accordingly
    closes: #101676
  * Matt Zimmerman fixes up some wording in the section talking about
    forwarding bugs upstream
    closes: #98312
  * provide proper l10n for SGML date entities; now we have &date-<LANG>
    entities which should be used
  * debian/rules: fixes for new debiandoc-sgml
  * debian/control: depend on debiandoc-sgml 1.1.48 or better

 -- Adam Di Carlo <aph@debian.org>  Thu, 21 Jun 2001 14:43:42 -0400

developers-reference (2.8.6) unstable; urgency=low

  * fix a typo, thanks to Antoine Hulin
  * French version: completely up-to-date now
  * Makefile: add a 'validate' target
  * prepare and ship "upstream" ChangeLog; move the debian changelog to
    changelog.Debian.gz
  * all versions: change the email address to use when orphaning
    closes: #93727

 -- Adam Di Carlo <aph@debian.org>  Fri, 13 Apr 2001 03:32:08 -0400

developers-reference (2.8.5) unstable; urgency=low

  * expunge references to the Debian Packaging Manual, which is now in the
    Policy
  * Japanese version: also comment out some references packaging manual;
    this translation needs updating
  * deny request to shut down non-maintainer bug maintenance bug closure
    practices (closes: Bug#88623)
  * add some advice about U.S. citizens uploading to non-US
    (closes: Bug#89694)
  * debian/control: Build-Depends should have been Build-Depends-Indep
  * French version: First complete translation of the Debian developer's
    reference guide.  Much work done by Antoine Hulin. Reviewed by Nicolas
    Bertolissio.
  * Portuguese version: work is started by Carlos Laviola, nothing
    included yet, however

 -- Adam Di Carlo <aph@debian.org>  Sun,  8 Apr 2001 01:25:51 -0400

developers-reference (2.8.4) unstable; urgency=low

  * debian/control: remove reference to obsolete packaging-manual package
    (closes: Bug#86505)
  * debian/control: fill in the description a bit more
  * doc-base: index.html corrected to be index.en.html
    (closes: Bug#85933)
  * Makefile: clean is cleaner

 -- Adam Di Carlo <aph@debian.org>  Sun, 25 Feb 2001 12:47:06 -0500

developers-reference (2.8.3) unstable; urgency=low

  * build and provide French and Japanese versions
  * devolve build logic from debian/rules to top-level Makefile
  * developers-reference.jp.sgml: minor changes so it will build (is out
    of date)
  * debian/rules: stop making useless /usr/share/developers-reference dir

 -- Adam Di Carlo <aph@debian.org>  Mon, 22 Jan 2001 02:02:02 -0500

developers-reference (2.8.2) unstable; urgency=low

  * Josip Rodin:
    - fix typographic errors reported by David Martinez (closes: Bug#80740)
    - common.ent: upped the numbers a little bit, updated lintian reports URL
    - updated regarding va->klecker move, and www->people move, changed
      most mentions of dinstall to a generic term "archive maintenance
      software", removed full path to it because it is in PATH now,
      mentioned "dak" and "katie" (somewhat vaguely), changed week to
      month regarding FTP archive waiting time since that\'s more often
      the case, and changed weeks to hours regarding Maintainers file
      updates since that\'s also more often the case now, updated some
      URLs to entities, s/debian-doc/doc-debian/
    - replaced evil latin1-only quotation marks, replaced mentions of
      important severity (in RCB context) with serious severity, some
      details fixed
    - common.ent (1.10): fixed email-debian-user alias; updated
      sample-dist-dirtree (with more to come)
    - described testing; described package pools (this particular part
      required quite a bit of changes, and it might be a bit rough, but
      it's a start); described the frozen test cycles et al; some other
      smaller fixes
    - another update WRT sid/unstable/testing, from Colin Watson
      (closes: Bug#80896)
  * debian/control: add Recommends for debian-policy, packaging-manual 
  * update copyright notice for 2001
  * fix for WNPP bug filing severities from David Schleef
  * clarify the status of the Developers's reference as "normative"
  * add a reference to debconf (closes: Bug#82413)

 -- Adam Di Carlo <aph@debian.org>  Sun, 21 Jan 2001 18:10:21 -0500

developers-reference (2.8.1) unstable; urgency=low

  * update WNPP instructions, based on patch from Marcelo E. Magallon 
    (closes: Bug#69435)
  * spelling corrections, awkward grammar suggestions from Andreas Krueger 
    (closes: Bug#72810)
  * debian/rules: remove some obsolete source-depends stuff

 -- Adam Di Carlo <aph@debian.org>  Sat,  4 Nov 2000 13:22:21 -0500

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...

  * 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