Russ Allbery [Sun, 16 Mar 2008 22:06:34 +0000 (22:06 +0000)]
Clarify mandatory config files in /etc
Add the /etc/cron.hourly directory to the list of cron directories.
/etc/cron.* files now must be configuration files (upgraded from
should). Mention the various scripts that must be configuration files
in the section about configuration files. Thanks, Frank Küster.
Closes #403391.
Russ Allbery [Sun, 16 Mar 2008 21:08:56 +0000 (21:08 +0000)]
Add README.source and the patch target
Specifies the debian/README.source file to document any package that
uses a source or package management system or that has a complex source
layout or build system. Specifies and recommends the patch target
for putting a source package into an editable state. Allowed referring
to external documentation in README.source if it's specific and not a
general manual.
Russ Allbery [Sun, 16 Mar 2008 20:43:55 +0000 (20:43 +0000)]
Add parallel=n and move DEB_BUILD_OPTS section
Add the build option parallel=n, requesting a parallel build. Standardize
the format of DEB_BUILD_OPTIONS, require tags be whitespace-separated,
allow packages to assume non-conflicting tags, and require unknown flags
be ignored. Move the section documenting DEB_BUILD_OPTS under the
debian/rules section and away from the binaries section, leaving a
cross-reference behind. Thanks to Loïc Minier, Peter Samuelson,
Robert Millan, and Guillem Jover for wording suggestions.
Russ Allbery [Sun, 16 Mar 2008 19:45:52 +0000 (19:45 +0000)]
non-free and contrib packages should explain in copyright
Packages in the non-free and contrib categories should state in their
copyright files that the package is not part of the Debian GNU/Linux
distribution and briefly explain why.
Russ Allbery [Wed, 5 Mar 2008 03:56:25 +0000 (03:56 +0000)]
Update section list and base system definition
Remove the base section; it's no longer used. Remove contrib and
non-free sections which probably predate the category/section convention.
Revise the definition of the base system to use priorities instead.
Thanks to Colin Watson for verification and wording suggestions.
Closes #442070.
Russ Allbery [Wed, 5 Mar 2008 03:08:25 +0000 (03:08 +0000)]
New Breaks dependency field
Documents the new Breaks field supported by dpkg. This is Ian Jackson's
patch with minor formatting changes and an added note that Breaks should
not be used until Debian stable supports it. Recommend Breaks instead
of versioned Conflicts once Debian stable supports it.
Remove the paragraph about suidmanager in dpkg-statoverride entirely
since that package no longer exists even in oldstable.
Russ Allbery [Wed, 5 Mar 2008 02:55:59 +0000 (02:55 +0000)]
Debian packages should not use convenience libraries
Document that Debian packages should not use convenience copies of
libraries and instead link to the library that's already present in
Debian. Thanks to Neil McGovern, Bill Allombert, Kurt Roeckx,
Steve Langasek, Colin Watson, and others for wording suggestions.
Closes #392362.
Russ Allbery [Wed, 5 Mar 2008 02:38:57 +0000 (02:38 +0000)]
Standardize manual page encoding
Standardize manual page encoding to either the legacy encoding for a
locale or UTF-8. Country names should not be included in locale-specific
directory names unless there is a significant difference in language.
Characters in the manual page must be representable in the legacy encoding
for now.
Russ Allbery [Wed, 2 Jan 2008 02:18:27 +0000 (02:18 +0000)]
Add Emacs indent-tab-mode setting
Set indent-tab-mode to t as a local variable for *.sgml files for
consistency with the existing formatting even if a user overrides the
Emacs default and disables use of tabs.
Russ Allbery [Tue, 1 Jan 2008 23:24:50 +0000 (23:24 +0000)]
FHS and FSSTND build and copyright cleanup
Remove the remaining (mostly commented-out) build rules for FHS 2.1 and
FSSTND. Remove the groff patch needed for building some versions of
FHS 2.1 ourselves.
Remove the (non-free) FSSTND license from debian/copyright since no
FSSTND files are still part of Policy. FHS replaced it.
Update the copyright years for FHS in debian/copyright.
Russ Allbery [Mon, 31 Dec 2007 05:02:42 +0000 (05:02 +0000)]
Fix capitalization of Idempotency in heading
Make Idempotency lowercase, matching other headings. This was the only
remaining uncontroversial wording change in the original bug report
that had not already been made.
Russ Allbery [Mon, 31 Dec 2007 04:38:41 +0000 (04:38 +0000)]
Mention apt and aptitude as examples of dpkg frontends
The discussion of binary dependency fields said that fields other than
Depends were only used by dpkg frontends such as dselect. List apt and
aptitude before dselect as they're more often used these days.
Russ Allbery [Mon, 3 Dec 2007 06:41:32 +0000 (06:41 +0000)]
Drop docbook-xml from the doc-base file for debconf-spec
docbook-xml is not one of the supported format types in the doc-base
specification and all stanzas are supposed to be for a supported
format. Drop this stanza (and thereby also fix a lintian warning).
Russ Allbery [Mon, 3 Dec 2007 03:33:10 +0000 (03:33 +0000)]
Add ttf-japanese-gothic and ttf-japanese-mincho virtual packages
Add ttf-japanese-gothic and ttf-japanese-mincho for Japanese font
packages providing particular styles of fonts, at the request of the
Debian Japanese Task Force.
Russ Allbery [Mon, 3 Dec 2007 02:52:44 +0000 (02:52 +0000)]
Update the common-licenses list
Update the list of licenses in /usr/share/common-licenses to mention
specific version numbers, include GFDL 1.2, and include GPL 3 and
LGPL 3. List all of the specific file names in the footnote rather
than only giving examples.
Russ Allbery [Mon, 3 Dec 2007 02:18:26 +0000 (02:18 +0000)]
Packages using debconf must support internationalization
Packages that follow the Debian Configuration management specification
must support internationalization by using a gettext-based system such
as po-debconf.
Russ Allbery [Mon, 3 Dec 2007 01:56:10 +0000 (01:56 +0000)]
Document the type field in shlibs and its use with udebs
The shlibs file syntax now supports an optional type field specifying
the type of packages to which the line applies. Currently, the only
supported type is udeb. Include documentation of the syntax, the use
with udeb, and an example. Based on a patch from Frans Pop with input
from Raphael Hertzog.
Russ Allbery [Fri, 30 Nov 2007 04:49:56 +0000 (04:49 +0000)]
Merge lists of urgency values and include a complete list
Remove the footnote in the changelog description that provides one
incomplete list of urgency values. Add a normative list instead of
examples in the description of the Urgency field, and move the rest
of the footnote content about dak behavior to there.
Russ Allbery [Fri, 30 Nov 2007 03:43:56 +0000 (03:43 +0000)]
Source in .changes may contain a version number
Per recent mail from Guillem Jover, the version number is also added
to the Source field of .changes files for binNMUs. This change was
made in dpkg 1.13.22 and is therefore currently in stable. dak also
now supports it.
Russ Allbery [Fri, 30 Nov 2007 03:35:30 +0000 (03:35 +0000)]
fix FTBFS when built twice in a row
Don't unpack the FHS tarball since it overwrites our own build system and
we don't use the files inside the tarball anyway. Don't install the FHS
files twice.
Rename inetd-superserver to inet-superserver in the virtual package list.
The latter is the virtual package currently in use (by inetutils-inetd,
openbsd-inetd, and rlinetd), and Marco d'Itri confirmed that the correct
package name is inet-superserver.
Formatting and alphabetization of the virtual package list
Wrapped the descriptions of virtual packages at 80 columns, cleaned up
trailing whitespace, and alphabetized the list of virtual packages
within sections except where there was clear benefit to having two
packages adjacent (audio-mixer and x-audio-mixer).
Recommend ${binary:Version} instead of ${Source-Version}
${Source-Version} was confusing (since it actually is replaced with the
binary package version in, for example, binNMUs) and has been deprecated
in dpkg. ${binary:Version} should be used instead. Update Policy's
recommendation accordingly.
Russ Allbery [Mon, 4 Jun 2007 01:05:51 +0000 (01:05 +0000)]
Add test -a/-o and local to shell policy, update wording
Scripts may now assume that /bin/sh supports local (in a limited form)
and, if they use a built-in test, that built-in supports test -a/-o
binary logical operators. Reword to include echo -n as another case
of additional required features. Replace references to POSIX with
SUSv3 and add a link.
Russ Allbery [Mon, 4 Jun 2007 00:50:10 +0000 (00:50 +0000)]
Document ~ behavior in version numbers
Allow ~ in package versions and update the sorting rules to reflect ~'s
behavior of sorting before any other character or the empty string.
Thanks to Nicolas François and Marc Brockschmidt for wording
suggestions.
Manoj Srivastava [Thu, 16 Jun 2005 10:57:54 +0000 (10:57 +0000)]
Synchronized with patch 276 from Manojs tree
Synchronized with patch 276 from Manojs tree
Patches applied:
* srivasta@debian.org--etch/debian-policy--devel--3.0--patch-276
Added the FHS 2.3 files, and removed the 2.2 version. Arranged for the FHS 2.3 files to be installed. No changes to policy.
Manoj Srivastava [Thu, 16 Jun 2005 10:50:13 +0000 (10:50 +0000)]
Synchronized with patch 264 from Manojs tree
Synchronized with patch 264 from Manojs tree
Patches applied:
* srivasta@debian.org--etch/debian-policy--devel--3.0--patch-264
removed the long obsolete notion of specific directory names within source tarballs, closes: #79210
Manoj Srivastava [Thu, 16 Jun 2005 10:49:01 +0000 (10:49 +0000)]
Synchronized with patch 262 from Manojs tree
Synchronized with patch 262 from Manojs tree
Patches applied:
* srivasta@debian.org--etch/debian-policy--devel--3.0--patch-262
linked f-Format in the list of fields of the .dsc file, not mandatory according to my skimming of dpkg-source, closes: #70742
Manoj Srivastava [Thu, 16 Jun 2005 10:47:49 +0000 (10:47 +0000)]
Synchronized with patch 260 from Manojs tree
Synchronized with patch 260 from Manojs tree
Patches applied:
* srivasta@debian.org--etch/debian-policy--devel--3.0--patch-260
clarified the section about the Architecture field and added footnotes to indicate recommended actions, closes: #51832
Manoj Srivastava [Thu, 16 Jun 2005 10:47:12 +0000 (10:47 +0000)]
Synchronized with patch 259 from Manojs tree
Synchronized with patch 259 from Manojs tree
Patches applied:
* srivasta@debian.org--etch/debian-policy--devel--3.0--patch-259
generalized the dpkg-shlibdeps example and added a current example in a footnote, set proper section ids and linked the d-sd section better, closes: #50565
Manoj Srivastava [Thu, 16 Jun 2005 10:42:30 +0000 (10:42 +0000)]
Synchronized with patch 252 from Manojs tree
Synchronized with patch 252 from Manojs tree
Patches applied:
* srivasta@debian.org--etch/debian-policy--devel--3.0--patch-252
[AMENDMENT 15/09/2003] Move documentation of behavior of ancient dpkg in 6.6 to a footnote. closes: Bug#209855
Manoj Srivastava [Thu, 16 Jun 2005 10:37:45 +0000 (10:37 +0000)]
Synchronized with patch 246 from Manojs tree
Synchronized with patch 246 from Manojs tree
Patches applied:
* srivasta@debian.org--etch/debian-policy--devel--3.0--patch-246
updated the old libgdbm example which was potentially confusing due to the extra letter g from the days of libc5->glibc transition