-developers-reference (3.1.3) unstable; urgency=low
+developers-reference (3.3.1) unstable; urgency=low
+
+ * Josip Rodin:
+ - package description said it contained French and Japanese, fixed,
+ closes: #182614
+ * 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> Wed, 2 Apr 2003 15:01:07 -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