Russ Allbery [Wed, 7 Jul 2010 15:59:45 +0000 (08:59 -0700)]
Merge branch 'master' into bug459868-rra
Russ Allbery [Wed, 7 Jul 2010 15:52:11 +0000 (08:52 -0700)]
Changelog and upgrading-checklist for #402721
Russ Allbery [Wed, 7 Jul 2010 15:48:14 +0000 (08:48 -0700)]
Merge branch 'master' into bug459868-rra
Russ Allbery [Wed, 7 Jul 2010 15:48:14 +0000 (08:48 -0700)]
Merge branch 'master' into bug402721-rra
Russ Allbery [Wed, 7 Jul 2010 15:47:46 +0000 (08:47 -0700)]
Changelog and upgrading-checklist for #400322
Russ Allbery [Sun, 4 Jul 2010 05:25:04 +0000 (22:25 -0700)]
Architecture restrictions are supported for binary packages
Document architecture restrictions for binary relationship fields
as well as build relationships, with their limitation that they're
only valid in source package control files and are used to generate
the fields in the binary package.
Russ Allbery [Sat, 3 Jul 2010 20:24:03 +0000 (13:24 -0700)]
Breaks/Conflicts should not be used unless necessary
State explicitly that Breaks and Conflicts should only be used where
needed, and should not be used if two packages merely provide similar
functionality.
Russ Allbery [Sat, 3 Jul 2010 19:58:37 +0000 (12:58 -0700)]
Clarify Maintainer, make Uploaders mandatory for team maintainers
Clarify the duties of the maintainer and state that the maintainer's
e-mail address must accept non-spam BTS mail and automated mail from
the project software. Rephrase the package orphaning; this does not
only happen when someone retires from the project. Require the
Uploaders field for a team-maintained package and, in that case,
require that it contains at least one human and personal address.
Russ Allbery [Sat, 3 Jul 2010 18:52:02 +0000 (11:52 -0700)]
Wording tweak to the shlibs.local description
Suggestion from Steve Langasek.
Russ Allbery [Sat, 3 Jul 2010 18:17:02 +0000 (11:17 -0700)]
Add changelog and upgrading-checklist for #509932
Russ Allbery [Sat, 3 Jul 2010 18:11:06 +0000 (11:11 -0700)]
Merge branch 'master' into bug509932-rra
Russ Allbery [Thu, 1 Jul 2010 19:51:39 +0000 (12:51 -0700)]
Document the alternate SONAME format used by libtool -release
Document the SONAME format where the version number comes before
the .so and after a hyphen and provide another example.
Russ Allbery [Sat, 3 Jul 2010 18:05:07 +0000 (11:05 -0700)]
Add changelog and upgrading-checklist for #218897
Russ Allbery [Thu, 1 Jul 2010 19:15:46 +0000 (12:15 -0700)]
Remove obsolete shlibs.local information
Remove the instructions for how to create shlibs.local files and the
encouragement to do so if one runs into errors with dpkg-shlibdeps, since
the archive coverage for shlibs is now complete and writing a shlibs.local
file is unlikely to be an appropriate solution to one's problem.
Russ Allbery [Thu, 1 Jul 2010 18:51:22 +0000 (11:51 -0700)]
Reformat and update the shlibs section
* Revise the footnote discussing shlibs creation to not talk about the
switch to objdump as if it were a new innovation and to explicitly
mention the NEEDED attribute as the source of dependency information.
Also fix markup, formatting, indentation, and phrasing in multiple
places.
Russ Allbery [Thu, 1 Jul 2010 17:36:02 +0000 (10:36 -0700)]
Merge branch 'master' into bug218897-rra
Russ Allbery [Thu, 1 Jul 2010 17:35:09 +0000 (10:35 -0700)]
Add changelog and upgrading-checklist for #561413
Russ Allbery [Thu, 1 Jul 2010 17:29:57 +0000 (10:29 -0700)]
dpkg-divert --package is only required when adding or removing
Russ Allbery [Wed, 30 Jun 2010 18:16:23 +0000 (11:16 -0700)]
Forbid dpkg-divert --local in package maintainer scripts
State that package maintainer scripts must use --package and must
not use --local when invoking dpkg-divert.
Russ Allbery [Wed, 30 Jun 2010 18:02:54 +0000 (11:02 -0700)]
Rewrite requirements around libtool .la file handling
State that .la files should normally not be included in Debian
packages, with special exceptions for libraries loaded by libltdl and
for .la files on which other .la files may depend. State that
dependency_libs should be emptied if the .la files have to be
retained. Exclude non-public libraries and loadable modules from
these requirements.
Russ Allbery [Tue, 29 Jun 2010 17:43:06 +0000 (10:43 -0700)]
Clarify the banned dependencies between main and non-main
* Add Pre-Depends and Build-Depends-Indep to the relationships not
allowed from main to contrib or non-free and mention that such
relationships are okay if the non-free package is only an
alternative. Thanks, Raphael Geissert. (Closes: #587279)
Russ Allbery [Tue, 29 Jun 2010 17:06:28 +0000 (10:06 -0700)]
Include GPL version 1 in common-licenses
Closes Bug#436105.
Russ Allbery [Mon, 28 Jun 2010 18:00:11 +0000 (11:00 -0700)]
Fix typos in upgrading-checklist
Russ Allbery [Mon, 28 Jun 2010 17:56:19 +0000 (10:56 -0700)]
Better explanation of the Perl module naming policy
* Explain the Perl module package naming policy more explicitly and
provide some examples. (Closes: #175202)
Russ Allbery [Mon, 28 Jun 2010 16:37:45 +0000 (09:37 -0700)]
Set the Perl Policy version to match the package version
* Set the version of the Perl Policy to match the version of the Policy
package.
Russ Allbery [Mon, 28 Jun 2010 04:46:53 +0000 (21:46 -0700)]
Switch to source format 3.0 (native)
Russ Allbery [Mon, 28 Jun 2010 04:42:03 +0000 (21:42 -0700)]
Finalize release for 3.9.0.0
Russ Allbery [Mon, 28 Jun 2010 03:49:52 +0000 (20:49 -0700)]
Add changelog and upgrading-checklist for #547272
Russ Allbery [Sat, 26 Jun 2010 22:32:01 +0000 (15:32 -0700)]
Further minor updates around the Format field description
Be clear which control files consist of a single paragraph and use
consistent terminology. Be more consistent about <file> markup. Use
an SGML entity for the .changes file version to avoid repeating it.
Russ Allbery [Tue, 22 Jun 2010 17:26:03 +0000 (10:26 -0700)]
Remove a stray misplaced paragraph from merging original patch
Russ Allbery [Tue, 22 Jun 2010 17:07:18 +0000 (10:07 -0700)]
Further revisions to the Format update
Drop historical information about the version changes in .changes
files. It doesn't seem useful at this point. Specify the format
of Format for source packages separately since referring to the
version format with exceptions and additions is more confusing and
it's not really a version in the same sense. Add the full list of
supported source package formats in a footnote. Add a bit more
explanation for how the source package format is used.
Charles Plessy [Sat, 29 May 2010 03:49:34 +0000 (12:49 +0900)]
Clarification of the Format field in control files -- patch for #547272.
The Format field has a different meaning for Debian source control files and
Debian changes files. This patch :
- documents the use and syntax of the Format field for these two types
of control files.
- Specifies the format 1.8 of Debian changes files, adds descriptions for
the Checksums-Sha1 and Checksums-Sha256 files, and provides some history
for the Closes, Changed-By and Maintainer fields.
Russ Allbery [Mon, 21 Jun 2010 16:41:46 +0000 (09:41 -0700)]
Bump revision for the next release
Russ Allbery [Mon, 21 Jun 2010 16:40:38 +0000 (09:40 -0700)]
Add changelog and upgrading-checklist for #578854
Russ Allbery [Mon, 21 Jun 2010 16:33:28 +0000 (09:33 -0700)]
Merge branch 'master' into bug578854-rra
Russ Allbery [Mon, 21 Jun 2010 16:30:46 +0000 (09:30 -0700)]
Add bug closer for SETTITLE
Russ Allbery [Mon, 21 Jun 2010 16:29:32 +0000 (09:29 -0700)]
Document debconf SETTITLE command
Document the SETTITLE command in the debconf policy. Inclusion of this
command should not pose any problems as it has been supported since 2003
(debconf version 1.3.22).
Patch from Frans Pop <elendil@planet.nl>.
Russ Allbery [Thu, 17 Jun 2010 18:30:01 +0000 (11:30 -0700)]
Avoid "Debianised" or "Debianized" in Policy wording
* Avoid "Debianised" or "Debianized" in favor of just "Debian" or
"Debian package" as appropriate. Patch from Ben Finney.
(Closes: #586163)
Russ Allbery [Thu, 17 Jun 2010 18:22:04 +0000 (11:22 -0700)]
Fix various wording problems with the new Breaks/Conflicts sections
Russ Allbery [Wed, 16 Jun 2010 18:19:15 +0000 (11:19 -0700)]
Fix a missing word in Breaks
Russ Allbery [Wed, 16 Jun 2010 18:02:21 +0000 (11:02 -0700)]
Merge branch 'master' into bug578854-rra
Russ Allbery [Wed, 16 Jun 2010 18:01:58 +0000 (11:01 -0700)]
Close the <qref> tag for f-Checksums
Russ Allbery [Wed, 16 Jun 2010 18:00:04 +0000 (11:00 -0700)]
Significantly rework the discussion of Breaks and Conflicts
Recommend Breaks over Conflicts for most purposes. List the places
Breaks should be used and the places Conflicts should be used. Add
Breaks to the example in Replaces, and add a footnote explaining
why Breaks is normally required along with Replaces when files are
moving between packages. Add additional discussion of conflicting
with a virtual package.
Russ Allbery [Mon, 14 Jun 2010 19:37:45 +0000 (12:37 -0700)]
Merge branch 'master' into bug575639-rra
Conflicts:
debian/changelog
Russ Allbery [Mon, 14 Jun 2010 19:36:39 +0000 (12:36 -0700)]
Add changelog and upgrading-checklist for #575639
Russ Allbery [Mon, 14 Jun 2010 17:51:57 +0000 (10:51 -0700)]
Fix some minor (pre-existing) Maintainer and Uploaders syntax
Terminate an HTML entity and be clearer about the cross-reference
to the Maintainer field in the Uploaders field.
Russ Allbery [Mon, 14 Jun 2010 17:47:59 +0000 (10:47 -0700)]
Add changelog and upgrading-checklist for #347581
Russ Allbery [Mon, 14 Jun 2010 17:44:28 +0000 (10:44 -0700)]
Merge branch 'master' into bug347581-rra
Russ Allbery [Sun, 13 Jun 2010 20:14:43 +0000 (13:14 -0700)]
Tighten requirements for maintainer-like fields
The syntax of Maintainer is a must, not a should. The comma
separator in Uploaders is a must, not a should. Now allow people
to use multi-line Uploaders fields freely. Be explicit that the
Changed-By field has the same syntax as Maintainer and be clearer
about what identity goes here.
Russ Allbery [Sun, 13 Jun 2010 19:36:43 +0000 (12:36 -0700)]
Changelog and upgrading-checklist for #555978
Russ Allbery [Sun, 13 Jun 2010 19:33:02 +0000 (12:33 -0700)]
Merge branch 'master' into bug555978-rra
Russ Allbery [Sun, 13 Jun 2010 19:30:48 +0000 (12:30 -0700)]
Merge branch 'master' into bug478295-rra
Russ Allbery [Sun, 13 Jun 2010 19:30:38 +0000 (12:30 -0700)]
Add changelog and upgrading-checklist for #478295
Russ Allbery [Sat, 12 Jun 2010 23:18:00 +0000 (16:18 -0700)]
Fix pluralization error in Checksums-* description
Russ Allbery [Sat, 12 Jun 2010 22:23:31 +0000 (15:23 -0700)]
Fix typo (in BSD license footnote)
Russ Allbery [Sat, 12 Jun 2010 20:26:28 +0000 (13:26 -0700)]
Document Checksums-Sha1 and Checksums-Sha256
Add documentation for the Checksums-Sha1 and Checksums-Sha256 fields
and mark them as recommended for both source and changes files. Also
reorder the field listing in source and changes files to match the
order in which dpkg-dev writes the fields.
Russ Allbery [Sat, 12 Jun 2010 19:57:40 +0000 (12:57 -0700)]
Relax requirement that library development files be in one package
Say instead that installing the library development package must
result in installation of all the required files, which allows for
further splits with appropriate Depends.
Russ Allbery [Sat, 12 Jun 2010 19:25:02 +0000 (12:25 -0700)]
Clarify the wording about which build dependencies must be satisfied
* Clarify the wording around which build dependencies must be satisfied
for different debian/rules targets and add a footnote to the
description of the build-arch and build-indep targets explaining why
this split does not currently work as desired. (Closes: #328951)
Russ Allbery [Sat, 12 Jun 2010 18:51:42 +0000 (11:51 -0700)]
Explicitly say that obsolete config files may be removed
* Explicitly state that packages may remove unmodified, obsolete
configuration files during upgrade. (Closes: #470633)
Russ Allbery [Sat, 12 Jun 2010 18:39:42 +0000 (11:39 -0700)]
Add an example of Replaces for a package split
* Add an example for Replaces when a package is split. Thanks, Uwe
Kleine-König. (Closes: #572253)
Russ Allbery [Sat, 12 Jun 2010 17:49:45 +0000 (10:49 -0700)]
Changelog and upgrading-checklist information for Bug#284340
Russ Allbery [Sat, 12 Jun 2010 17:43:32 +0000 (10:43 -0700)]
Wording improvement for forbidding duplicate fields
Russ Allbery [Fri, 11 Jun 2010 16:56:16 +0000 (09:56 -0700)]
Prohibit duplicate field names in a control paragraph
Bug#555978.
Russ Allbery [Thu, 10 Jun 2010 23:55:23 +0000 (16:55 -0700)]
Merge branch 'master' into bug284340-rra
Russ Allbery [Thu, 10 Jun 2010 23:54:48 +0000 (16:54 -0700)]
Some additional tweaks to the license count script
Also look for LPPL version 1.3a and for any version of the license.
Be case-insensitive when looking for the Artistic 2.0 license.
Russ Allbery [Thu, 10 Jun 2010 20:10:26 +0000 (13:10 -0700)]
Do not tell packagers to reference /usr/share/common-licenses/BSD
Remove the University of California BSD license from the list of
licenses that should be represented by references to
/usr/share/common-licenses and explain in the footnote why packages
should copy the license text instead.
Part of the resolution of Bug#284340.
Russ Allbery [Wed, 9 Jun 2010 18:34:41 +0000 (11:34 -0700)]
Some additional fixes to the license classification script
Add counts for any version of the GFDL, GPL, or LGPL. Clarify which
version of the LaTeX PPL this is checking. Add a total package count
to the bottom.
Russ Allbery [Wed, 9 Jun 2010 18:25:25 +0000 (11:25 -0700)]
Add a script to count license usage in Debian
Add tools/license-count, which takes the path to a Lintian lab and
counts license usage in Debian using regular expression matches
against the text of the debian/copyright file.
Russ Allbery [Mon, 7 Jun 2010 17:16:39 +0000 (10:16 -0700)]
Fix typo in footnote about help2man
Russ Allbery [Fri, 4 Jun 2010 16:57:37 +0000 (09:57 -0700)]
Minor editing, changelog, and upgrading-checklist for #569174
Charles Plessy [Tue, 1 Jun 2010 01:27:39 +0000 (10:27 +0900)]
Specification of date format -- bug #569174.
RFC 822 dates use only two digits for the years, but Debian changelogs
described by this paragraph (§4.4 in Policy 3.8.4) use four digits.
This patch replaces the reference to the RFC 822 by a specification that is
compatible with its successors, RFC 2822 and RFC 5322, but does not use their
full range of options.
Russ Allbery [Fri, 4 Jun 2010 16:43:00 +0000 (09:43 -0700)]
Reletter Process and update HTML style for *.org files
Reletter the process steps to not skip State C and use more
traditional foreground and background colors for Process.html and
README.html. (Closes: #584521)
Russ Allbery [Fri, 4 Jun 2010 16:24:20 +0000 (09:24 -0700)]
Perl: Recommend DESTDIR instead of PREFIX with Makefile.PL
Packages using Makefile.PL should use DESTDIR rather than PREFIX
to install into the package staging area. PREFIX only worked due
to a Debian-local patch.
Russ Allbery [Fri, 4 Jun 2010 05:55:51 +0000 (22:55 -0700)]
Move silly version ordering example to a footnote
Closes: #560839
Russ Allbery [Fri, 4 Jun 2010 05:44:14 +0000 (22:44 -0700)]
Remove footnote listing all known architectures
Remove the footnote listing every architecture known to dpkg. This
list can be trivially produced by dpkg-architecture -L (already
noted), is very long, and quickly becomes out-of-date.
Russ Allbery [Fri, 4 Jun 2010 05:33:36 +0000 (22:33 -0700)]
Add changelog and upgrading-checklist for Bug#224509
Russ Allbery [Fri, 4 Jun 2010 05:27:56 +0000 (22:27 -0700)]
Merge branch 'master' into bug224509-rra
Russ Allbery [Fri, 4 Jun 2010 05:21:46 +0000 (22:21 -0700)]
Add changelog and upgrading-checklist entries for Bug#530687
Russ Allbery [Fri, 4 Jun 2010 05:20:44 +0000 (22:20 -0700)]
Move Architecture Wildcards to a subsection
Make Architecture Wildcards a subsection of Architecture specification
strings so that we don't renumber all the subsequent sections (and
because it seems to make slightly more sense).
Russ Allbery [Fri, 4 Jun 2010 05:12:39 +0000 (22:12 -0700)]
The architecture value "any" may not be combined with others
Adjust the wording for architecture wildcards to reflect that dpkg
requires "any" be alone if it is used.
Russ Allbery [Fri, 4 Jun 2010 05:10:21 +0000 (22:10 -0700)]
Merge branch 'master' into bug530687-rra
Russ Allbery [Thu, 3 Jun 2010 17:06:08 +0000 (10:06 -0700)]
Fix SGML error in upgrading-checklist entry for init.d scripts
Russ Allbery [Thu, 3 Jun 2010 17:04:11 +0000 (10:04 -0700)]
Perl Policy: Change perlapi provides to use an ABI version
Perl now provides perlapi-<abiversion> where <abiversion> may be
more than just the version of Perl. Packages must update their
dependencies accordingly, using $Config{debian_abi} to form the
package dependency if set and falling back on $Config{version}
otherwise.
Russ Allbery [Thu, 3 Jun 2010 16:51:52 +0000 (09:51 -0700)]
Rephrase architecture wildcard description somewhat
Reorganize and rephrase the description of architecture wildcards
to combine related paragraphs and to ensure consistency of wording
between the source control section and the *.dsc section.
Russ Allbery [Thu, 3 Jun 2010 16:44:53 +0000 (09:44 -0700)]
Remove some extraneous information about architecture wildcards
Remove some details in footnotes that are internal implementation
details or just confusing and reword somewhat based on feedback from
Guillem Jover.
Russ Allbery [Thu, 3 Jun 2010 16:34:56 +0000 (09:34 -0700)]
Merge branch 'master' into bug530687-rra
Russ Allbery [Thu, 3 Jun 2010 16:31:35 +0000 (09:31 -0700)]
Allow abort if a required prompt can't be answered
Allow, but caution against, maintainer scripts to abort if a required
prompt has no reasonable default and there is no controlling terminal.
Russ Allbery [Thu, 3 Jun 2010 16:26:14 +0000 (09:26 -0700)]
Merge branch 'master' into bug224509-rra
Russ Allbery [Thu, 3 Jun 2010 16:23:48 +0000 (09:23 -0700)]
Add changelog and upgrading checklist for Bug#562506
Russ Allbery [Thu, 3 Jun 2010 16:19:41 +0000 (09:19 -0700)]
Merge branch 'master' into bug562506-rra
Russ Allbery [Wed, 2 Jun 2010 17:05:17 +0000 (10:05 -0700)]
Fix additional typo in architecture wildcards
Found by Cyril Brulebois.
Russ Allbery [Wed, 2 Jun 2010 17:04:50 +0000 (10:04 -0700)]
Merge branch 'master' into bug530687-rra
Russ Allbery [Wed, 2 Jun 2010 17:04:22 +0000 (10:04 -0700)]
Ignore upgrading-checklist.html
Russ Allbery [Wed, 2 Jun 2010 17:02:43 +0000 (10:02 -0700)]
Document debian-installer section and link to section list
Document the special debian-installer section in the list of current
sections and add a link to the list of sections in unstable, which
contains longer descriptions. (Closes: #577666)
Russ Allbery [Wed, 2 Jun 2010 16:53:15 +0000 (09:53 -0700)]
Clarify Perl Policy about essentialness of perl-base
Clarify in the Perl Policy that perl-base is essential, not perl, and
don't imply packages need to depend on perl-base. (Closes: #576594)
Russ Allbery [Wed, 2 Jun 2010 16:46:03 +0000 (09:46 -0700)]
Remove obsolete footnote comment about dpkg-statoverride
Remove obsolete footnote sentence saying that dpkg-statoverride is a
new feature and not well-known. (Closes: #563425)
Russ Allbery [Wed, 2 Jun 2010 16:37:39 +0000 (09:37 -0700)]
Remove documentation of alternative changelog formats
Remove documentation of alternative changelog formats. This feature
is not allowed in the Debian archive and will be documented in the
dpkg-dev documentation instead. The documentation that was in Policy
was also somewhat outdated. (Closes: #555009, see #584141)
Russ Allbery [Tue, 1 Jun 2010 22:55:05 +0000 (15:55 -0700)]
Merge branch 'master' into bug562506-rra
Russ Allbery [Tue, 1 Jun 2010 22:51:25 +0000 (15:51 -0700)]
Merge branch 'master' into bug224509-rra
Russ Allbery [Tue, 1 Jun 2010 22:51:25 +0000 (15:51 -0700)]
Merge branch 'master' into bug530687-rra