Clarify the definition and restrictions on Essential
Add a brief rationale for Essential to the section on Essential, moving
it from an earlier footnote. Say that maintainers should take care in
adding any functionality to essential packages because it's very
difficult to remove such functionality later, moving some additional
text from the earlier footnote.
local must support multiple variables and assignment
All Bourne-type shells in Debian support localizing multiple variables
in one command, and all except posh support assignment. Supporting
multiple variables and assignment brings the behavior of local in line
with export and readonly. Permit /bin/sh scripts to assume that local
can take multiple variables and assignment.
Russ Allbery [Wed, 25 Jun 2008 21:50:45 +0000 (14:50 -0700)]
Use <user>:<group> instead of <user>.<group>
Use the newer <user>:<group> notation rather than <user>.<group>, which
is ambiguous for usernames containing periods and deprecated in chown.
Thanks to Kurt Roeckx for identifying instances in the Policy manual.
Russ Allbery [Thu, 5 Jun 2008 20:13:43 +0000 (13:13 -0700)]
Don't attempt to register debian-policy-process
There were stray calls to register debian-policy-process in the postinst
and prerm scripts left behind when that document was removed. Remove
them as well.
Russ Allbery [Mon, 2 Jun 2008 20:58:48 +0000 (13:58 -0700)]
Policy: minor typos in dpkg-shlibdeps and dpkg-architecture
Fix minor typos in appendix C in the sections on dpkg-shlibdeps and
dpkg-architecture. Also remove the note that future versions of
dpkg-shlibdeps will be called on shared libraries as well and just
say that it acts on both executables and shared libraries.
Thanks to Sandro Tosi <matrixhasu@gmail.com> for the corrections. Closes: #481954
Russ Allbery [Mon, 2 Jun 2008 20:05:07 +0000 (13:05 -0700)]
Policy: bugs fixed in NMUs are now closed
Remove the reference to the fixed tag and describe NMU and regular
package uploads the same. Both close the bug using the version of
the changelog entry.
Thanks to Sandro Tosi for the report. Closes: #481640
Russ Allbery [Mon, 2 Jun 2008 19:51:32 +0000 (12:51 -0700)]
Policy: remove obsolete app-defaults and Xresources provisions
No longer require packages providing files in /etc/X11/Xresources to
conflict with an ancient version of xbase which is no longer even in
oldstable.
Drop the explicit prohibition on /usr/X11R6/lib/X11/app-defaults,
which is no longer used by Debian at all and already covered by the
rest of the paragraph.
Remove old ChangeLog files. They haven't been updated and the VCS now
records more and better history. Remove headers from debian/postinst.in,
debian/prerm.in, and debian/rules as now redundant with the VCS metadata.
Document that an empty Debian revision is equivalent to a Debian
revision of 0 and clarify the way version numbers are compared. Thanks
to Raphael Hertzog for information about what dpkg does.
Clarify support file handling for shared libraries
Combine the discussion of run-time support files for shared libraries
in a renamed section. Be explicit that shared library packages may not
contain any file whose name does not change when the soname changes,
and be clearer about when files should be put into versioned directories
in the shared library package and when files should go into a separate
package. Files useful only when compiling against the library should
go into the -devel package (and other run-time support programs should
not).
Suggest -tools instead of -runtime for the package containing support
files or binaries built against a library and usable by any version of
the library. Thanks, Raphael Hertzog.
Underscores are already widely used in debconf template names, even though
not allowed by the specification, and both debconf and cdebconf permit
them. Patch from Colin Watson. (Bug#473761)
Reference deb-substvars for source variable substitutions
As of dpkg 1.14.3, source variable substitutions are now documented in
deb-substvars(5) rather than dpkg-source(1). Update the reference in
Policy. Patch from Ian Beckwith.
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
projects / debian / debian-policy.git / log