chiark / gitweb /
Improvements to security section
[developers-reference.git] / debian / changelog
index 0d82cf8f9f89fbfaabedd985ed894459ab09f3d0..eae153afc4e434787c3cfc68681b9a4b96f4c00e 100644 (file)
+developers-reference (3.3.5) unstable; urgency=low
+
+  * Matt Zimmerman
+    - Security uploads get urgency=high
+    - Be even more explicit about not uploading security updates
+
+ -- Matt Zimmerman <mdz@debian.org>  Sat, 12 Jun 2004 09:34:32 -0700
+
+developers-reference (3.3.4) unstable; urgency=low
+
+  * Josip Rodin:
+    - fixed language in the PTS section, prompted by a patch from
+      Romain FRANCOISE, thank you; closes: #197741
+    - updated the mailing lists section (again)
+    - documented Alioth, somewhat
+  * Frédéric Bothamy
+    - French translation updated to version 3.3.3 (more or less)
+    - proofread by Patrice Karatchentzeff
+  * Matt Zimmerman
+    - Don't upload security updates directly to stable
+    - Always include an external reference in security changelog entries
+    - Be careful not to re-use a version number in security uploads
+    - More explicit instructions about what is appropriate for a security
+      upload
+
+  * Adam Di Carlo
+    - replace <!entity...> with <!ENTITY...> and other SGML hygenics
+    - build refinements
+    - Release this package as is to flush changes between June and now.
+      Yes, its been an age between releases here, for which I apologize.
+      Since CVS upstream for this package is back, I'm working on closing
+      bugs in this package now, I just wanted to get it out as is before I
+      started.
+
+ -- Adam Di Carlo <aph@debian.org>  Sun, 29 Feb 2004 14:09:48 -0500
+
+developers-reference (3.3.3) unstable; urgency=low
+
+  * Frédéric Bothamy
+    - corrections by Michel Grentzinger
+  * Raphaël Hertzog
+    - updated documentation concerning the PTS
+    - added a paragraph about the PTS web interface
+    - documented how to add custom news item in the PTS
+  * Matt Zimmerman
+    - updates and clarifications to instructions for security bugs
+    - deprecate uploads to stable for security fixes, reference
+      section on security bugs; closes: #196516
+    - use dpkg-buildpackage -B to test binary-arch, not -b;
+      closes: #196555
+  * Adam Di Carlo
+    - Sec "Managing sponsored packages": remove unnecessary 'debsign' cmd;
+      closes: #192417
+    - fix debconf-devel(7) man page section; closes: #189512
+    - Sec "Responding to bugs": mention what FTBFS means; closes: #186605
+    - Sec "Distribution directories" renamed "Distributions"
+    - Sec "The testing distribution" moved under Sec "Distribution
+      directories" and renamed "More information about the testing
+      distribution"
+    - Secs "Uploads to {stable,testing-proposed-updates}" retitled to make
+      it clear these are special cases
+    - Sec "Uploading to ftp-master": xref to "Delayed incoming"; 
+      closes: #195997
+    - check compliance with Policy version 3.5.10
+
+ -- Adam Di Carlo <aph@debian.org>  Mon, 16 Jun 2003 04:08:29 -0400
+
+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:
+    - French translation requires debiandoc-sgml 1.1.76 or better
+
+ -- Adam Di Carlo <aph@debian.org>  Fri, 18 Apr 2003 09:48:59 -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:
-    - some simplifications on the TeX suffix rule
     - welcome Manoj Srivastava as a co-maintainer
     - welcome Raphael Hertzog as a co-maintainer
-    - update copyright date
-    - Sec "Getting started": link to New Maintainers' Guide
+
+    - 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"
-    - new Chapter "Beyond Packaging" for recommended ways to contribute
-      to Debian beyond issues of package maintenance; Ch "Interaction with
-      Prospective Developers" moved into this chapter and renamed to Sec
-      "Interacting with Prospective Debian Developers"
     - 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>  Sun,  5 May 2002 13:24:03 -0700
+ -- Adam Di Carlo <aph@debian.org>  Fri, 14 Jun 2002 01:18:19 -0400
 
 developers-reference (2.11) unstable; urgency=low
 
@@ -807,6 +1211,3 @@ developers-reference (0.1) unstable; urgency=low
 
  -- Christian Schwarz <schwarz@debian.org>  Tue, 8 Jul 1997 00:19:49 +0200
 
-Local variables:
-mode: auto-fill
-End: