chiark / gitweb /
added best practices for debian/changelog, based on a patch from Daniel Kobras, close...
[developers-reference.git] / debian / changelog
index fa2a9fd007e4994ab3b65386c0dd83acf4d9818d..b6a9212e09ff7e7dbbbab97d2ee75818bf448308 100644 (file)
@@ -1,3 +1,197 @@
+developers-reference (3.3) unstable; urgency=low
+
+  * Frédéric Bothamy:
+    - French translation update to latest version
+    - 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.
+  * 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
+    - 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
+
+ -- Adam Di Carlo <aph@debian.org>  
+
+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:
 developers-reference (3.0) unstable; urgency=low
 
   * Adam Di Carlo:
@@ -8,7 +202,6 @@ developers-reference (3.0) unstable; urgency=low
       the former chapters
        Ch "Mailing Lists, Servers, and Other Machines"
        Ch "The Debian Archive"
       the former chapters
        Ch "Mailing Lists, Servers, and Other Machines"
        Ch "The Debian Archive"
-      New Sec "Documentation" stubbed out
   
     - new Chapter "Managing Packages", incorporating former chapters
        Ch "Package uploads"
   
     - new Chapter "Managing Packages", incorporating former chapters
        Ch "Package uploads"
@@ -26,8 +219,9 @@ developers-reference (3.0) unstable; urgency=low
       Sec "QA" moved here from old Sec "Quality Assurance effort"
       Sec "Dealing with unreachable maintainers"
 
       Sec "QA" moved here from old Sec "Quality Assurance effort"
       Sec "Dealing with unreachable maintainers"
 
-    - Sec "Voting" stubbed in Developer Duties
     - Sec "The Developers Database" added under Resources
     - 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",
 
     - Sec "Getting started": add link to New Maintainers' Guide
     - Sec "Debian Mentors" renamed to "Debian Mentors and Sponsors",
@@ -36,25 +230,82 @@ developers-reference (3.0) unstable; urgency=low
     - 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.
     - 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
     - update copyright date
     - some simplifications on the TeX suffix rule
-    - spell check
+    - spell check and grammar corrections
     - s/GPG/GnuPG/
 
   * Raphael Hertzog:
     - s/GPG/GnuPG/
 
   * Raphael Hertzog:
-    - changed -e by -m in the dpkg-buildpackage command line example.
+    - 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
       closes: #110310
     - clarify wording between "porter upload", "binary-only NMU", "simple
       recompile"; closes: #102626
     - extended "removing a package"; closes: #135560
-    - Added best packaging practices chapter.
-    - Added "Writing useful descriptions" as a first entry in that
-      chapter. Closes: #53109, #129848
+    - 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
 
 
   * Antoine Hulin:
     - update French translation
 
- -- Adam Di Carlo <aph@debian.org>  Mon,  6 May 2002 19:52:15 -0700
+ -- Adam Di Carlo <aph@debian.org>  Fri, 14 Jun 2002 01:18:19 -0400
 
 developers-reference (2.11) unstable; urgency=low
 
 
 developers-reference (2.11) unstable; urgency=low
 
@@ -846,6 +1097,3 @@ developers-reference (0.1) unstable; urgency=low
 
  -- Christian Schwarz <schwarz@debian.org>  Tue, 8 Jul 1997 00:19:49 +0200
 
 
  -- Christian Schwarz <schwarz@debian.org>  Tue, 8 Jul 1997 00:19:49 +0200
 
-Local variables:
-mode: auto-fill
-End: