chiark / gitweb /
added best practices for debian/changelog, based on a patch from Daniel Kobras, close...
[developers-reference.git] / debian / changelog
index 3ffe064057f87c62b3a23b6e2aba3eb1eea98609..b6a9212e09ff7e7dbbbab97d2ee75818bf448308 100644 (file)
@@ -1,9 +1,153 @@
+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:
-    - Updated IRC stuff, thanks to Ben Armstrong, closes: #161403.
+    - 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>  UNRELEASED
+ -- Adam Di Carlo <aph@debian.org>  Tue, 12 Nov 2002 23:15:03 -0500
 
 developers-reference (3.1) unstable; urgency=low