policy: html txt ps pdf
leavealone := $(FHS_HTML) $(FHS_FILES) $(FHS_ARCHIVE) \
- libc6-migration.txt \
- upgrading-checklist.html virtual-package-names-list.txt
+ libc6-migration.txt
.PHONY: distclean
distclean:
sanitycheck := debian/rules policy.sgml
-SGML_FILES := policy menu-policy mime-policy perl-policy
+SGML_FILES := policy menu-policy mime-policy perl-policy upgrading-checklist
DESC_FILES := debian-policy debian-menu-policy debian-perl-policy \
debian-mime-policy debconf-spec fhs
FHS_NEW_FILES :=
POLICY_FILES = $(SGML_FILES:=.sgml) $(SGML_FILES:=.txt.gz) \
- virtual-package-names-list.txt upgrading-checklist.html \
- upgrading-checklist.txt libc6-migration.txt version.ent \
+ virtual-package-names-list.txt \
+ libc6-migration.txt version.ent \
debconf_spec/debconf_specification.html \
debconf_spec/debconf_specification.txt.gz \
policy.ps.gz policy.pdf.gz README.txt README.html \
all build: stamp-build
-stamp-build: version.ent $(sanitycheck) upgrading-checklist.html \
- upgrading-checklist.txt README.txt README.html \
+stamp-build: version.ent $(sanitycheck) README.txt README.html \
Process.txt Process.html
$(MAKE) $(SGML_FILES:=.sgml.validate) \
$(SGML_FILES:=.html.tar.gz) \
+++ /dev/null
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"
-lang="en" xml:lang="en">
-<head>
-<title>Policy checklist for upgrading your packages</title>
-<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"/>
-<meta name="generator" content="Org-mode"/>
-<meta name="generated" content="2010-01-26 13:43:10 CET"/>
-<meta name="author" content="Bill Allombert, Josip Rodin, Julian Gilbey, Russ Allbery, and Manoj Srivastava"/>
-<meta name="description" content=""/>
-<meta name="keywords" content=""/>
-
-<style type="text/css">
- html { font-family: Times, serif; font-size: 12pt; }
- .title { text-align: center; }
- p.verse { margin-left: 3% }
- pre {
- border: 1pt solid #AEBDCC;
- color: #000000;
- background-color: LightSlateGray;
- padding: 5pt;
- font-family: "Courier New", courier, monospace;
- font-size: 90%;
- overflow:auto;
- }
- dt { font-weight: bold; }
- div.figure { padding: 0.5em; }
- div.figure p { text-align: center; }
- .linenr { font-size:smaller }
- .code-highlighted {background-color:#ffff00;}
- .org-info-js_info-navigation { border-style:none; }
- #org-info-js_console-label { font-size:10px; font-weight:bold;
- white-space:nowrap; }
- .org-info-js_search-highlight {background-color:#ffff00; color:#000000;
- font-weight:bold; }
-
- body {
- color: DarkSlateGrey;
- background-color: gainsboro;
- font-family: Palatino, "Palatino Linotype", "Hoefler Text", "Times New Roman", Times, Georgia, Utopia, serif;
- }
- .org-agenda-date { color: #87cefa; }
- .org-agenda-structure { color: #87cefa; }
- .org-scheduled { color: #98fb98; }
- .org-scheduled-previously { color: #ff7f24; }
- .org-scheduled-today { color: #98fb98; }
- .org-tag { font-weight: bold; }
- .org-todo {
- color: #ffc0cb;
- font-weight: bold;
- }
-
- a {
- color: inherit;
- background-color: inherit;
- font: inherit;
- text-decoration: inherit;
- }
- a:hover { text-decoration: underline; }
- .todo { font-weight:bold; }
- .done { font-weight:bold; }
- .TODO { color:red; }
- .WAITING { color:orange; }
- .DONE { color:green; }
- .timestamp { color: grey }
- .timestamp-kwd { color: CadetBlue }
- .tag { background-color:lightblue; font-weight:normal }
- .target { background-color: lavender; }
-table {
- border-collapse: collapse; /*separate; */
- border: outset 3pt;
- border-spacing: 0pt;
- /* border-spacing: 5pt; */
- }
-table td { vertical-align: top; border: 1px solid; }
-table th { vertical-align: top; border: 2px solid; }
-</style>
-<script ="text/javascript" language="JavaScript" src="/styles/org-info.js"></script>
-<script type="text/javascript" language="JavaScript">
-/* <![CDATA[ */
-org_html_manager.set("LOCAL_TOC", 0);
-org_html_manager.set("VIEW_BUTTONS", 1);
-org_html_manager.set("VIEW", "info");
-org_html_manager.set("TOC", 1);
-org_html_manager.set("MOUSE_HINT", "underline"); // could be a background-color like #eeeeee
-org_html_manager.setup ();
-/* ]]> */
-</script>
-
-<script type="text/javascript">
-<!--/*--><![CDATA[/*><!--*/
- function CodeHighlightOn(elem, id)
- {
- var target = document.getElementById(id);
- if(null != target) {
- elem.cacheClassElem = elem.className;
- elem.cacheClassTarget = target.className;
- target.className = "code-highlighted";
- elem.className = "code-highlighted";
- }
- }
- function CodeHighlightOff(elem, id)
- {
- var target = document.getElementById(id);
- if(elem.cacheClassElem)
- elem.className = elem.cacheClassElem;
- if(elem.cacheClassTarget)
- target.className = elem.cacheClassTarget;
- }
-/*]]>*///-->
-</script>
-</head>
-<body>
-<div id="content">
-<div id="org-div-home-and-up" style="text-align:right;font-size:70%;white-space:nowrap;">
- <a accesskey="h" href="http://www.debian.org/"> UP </a>
- |
- <a accesskey="H" href="http://wiki.debian.org/Teams/Policy"> HOME </a>
-</div>
-
-<h1 class="title">Policy checklist for upgrading your packages</h1>
-
-
-<div id="outline-container-1" class="outline-3">
-<h3 id="sec-1">About the checklist </h3>
-<div class="outline-text-3" id="text-1">
-
-
-<p>
-The checklist below has been created to simplify the upgrading process
-of old packages. Note that this list is not "official"; it simply
-gives an indication of what has changed and whether you are likely to
-need to make changes to your package in light of this. If you have
-doubts about a certain topic, if you need more details, or if you
-think some other package does not comply with policy, please refer to
-the Policy Manual itself. All of the changes from version 3.0.0
-onwards indicate which section of the Policy Manual discusses the
-issue: [3.4] means section 3.4. The section numbering changed when
-the packaging manual was incorporated into policy; the section numbers
-used below refer to the current version.
-</p>
-<p>
-Here is how the check list works: Check which policy version your
-package was checked against last (indicated in the "Standards-Version"
-field of the source package). Then move upwards until the top and
-check which of the items on the list might concern your package. Note
-which sections of policy discuss this, and then check out the Policy
-Manual for details. If you are upgrading from Policy version < 2.5.0,
-it may be easier to check through the whole of policy instead of
-picking your way through this list.
-</p>
-</div>
-
-</div>
-
-<div id="outline-container-2" class="outline-3">
-<h3 id="sec-2">The checklist </h3>
-<div class="outline-text-3" id="text-2">
-
-
-
-</div>
-
-<div id="outline-container-2.1" class="outline-4">
-<h4 id="sec-2.1"><a name="v3.8.4.0" id="v3.8.4.0"></a>3.8.4.0 </h4>
-<div class="outline-text-4" id="text-2.1">
-
-
-<p>
-Released Jan 2010.
-</p>
-<ul>
-<li>
-<b>9.1.1</b> : An FHS exception has been granted for multiarch libraries.
-Permitting files to instead be installed to <code>/lib/triplet</code> and
-<code>/usr/lib/triplet</code> directories.
-</li>
-<li>
-<b>10.6</b> : Explicitly state that packages may not contain named pipes and
-should instead create them in postinst and remove them in prerm or postrm.
-</li>
-<li>
-<b>9.1.1</b> : <code>/sys</code> and <code>/selinux</code> directories are explicitly allowed as an
-exception to the FHS.
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.2" class="outline-4">
-<h4 id="sec-2.2"><a name="v3.8.3.0" id="v3.8.3.0"></a>3.8.3.0 </h4>
-<div class="outline-text-4" id="text-2.2">
-
-
-<p>
-Released Aug 2009.
-</p>
-<ul>
-<li>
-<b>4.9</b> : Add DEB_*_ARCH_CPU and DEB_*_ARCH_OS variables and
-recommend them over GNU-style variables for that information.
-</li>
-<li>
-<b>5.6.8</b>: Source package Architecture fields may contain <i>all</i> in
-combination with other architectures. Clarify when <i>all</i> and <i>any</i>
-may be used in different versions of the field.
-</li>
-<li>
-<b>5.6.14</b> : The Debian archive software does not support uploading
-to multiple distributions with one <code>*.changes</code> file.
-</li>
-<li>
-<b>5.6.19</b> : The Binary field may span multiple lines.
-</li>
-<li>
-<b>10.2</b> : Remove the permission for shared library packages to
-install libraries in a non-standard location and modify ld.so.conf.
-Packages should either be installed in a standard library directory
-or packages using them should be built with RPATH.
-</li>
-<li>
-<b>11.8.7</b> : Clarify installation directories for X programs and
-remove the requirement to pre-depend on x11-common before installing
-into <code>/usr/include/X11</code> and <code>/usr/lib/X11</code>.
-</li>
-<li>
-<b>12.1</b> : Remove the requirement that all characters in a manual
-page be representable in the legacy encoding for that language.
-</li>
-<li>
-<b>12.1</b> : Localized man pages should either be kept up-to-date with
-the original version or warn that they're not up-to-date, either
-with warning text or by showing missing or changed portions in the
-original language.
-</li>
-<li>
-<b>12.2</b> : install-info is now handled via triggers so packages no
-longer need to invoke it in maintainer scripts. Info documents
-should now have directory sections and entries in the document.
-Packages containing info documents should add a dependency to
-support partial upgrades.
-</li>
-<li>
-<b>perl</b> : The requirement for Perl modules to have a versioned
-Depend and Build-Depend on perl >= 5.6.0-16 has been removed.
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.3" class="outline-4">
-<h4 id="sec-2.3"><a name="v3.8.2.0" id="v3.8.2.0"></a>3.8.2.0 </h4>
-<div class="outline-text-4" id="text-2.3">
-
-
-<p>
-Released Jun 2009.
-</p>
-<ul>
-<li>
-<b>2.4</b>: The list of archive sections has been significantly expanded. See
-<a href="http://lists.debian.org/debian-devel-announce/2009/03/msg00010.html">http://lists.debian.org/debian-devel-announce/2009/03/msg00010.html</a>
-for the list of new sections and rules for how to categorize
-packages.
-</li>
-<li>
-<b>3.9.1</b>: All packages must use debconf or equivalent for user prompting,
-though essential packages or their dependencies may also fall
-back on other methods.
-</li>
-<li>
-<b>5.6.1</b>: The requirements for source package names are now explicitly
-spelled out.
-</li>
-<li>
-<b>9.1</b>: Legacy XFree86 servers no longer get a special exception from the
-FHS permitting <code>/etc/X11/XF86Config-4</code>.
-</li>
-<li>
-<b>9.1.3</b>: Removed obsolete dependency requirements for packages that use
-<code>/var/mail</code>.
-</li>
-<li>
-<b>11.8.5</b>: Speedo fonts are now deprecated. The X backend was disabled
-starting in lenny.
-</li>
-<li>
-<b>12.5</b>: The GNU Free Documentation License version 1.3 is included in
-common-licenses and should be referenced from there.
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.4" class="outline-4">
-<h4 id="sec-2.4"><a name="v3.8.1.0" id="v3.8.1.0"></a>3.8.1.0 </h4>
-<div class="outline-text-4" id="text-2.4">
-
-
-<p>
-Released Mar 2009.
-</p>
-<ul>
-<li>
-<b>3.8</b>: Care should be taken when adding functionality to essential and
-such additions create an obligation to support that functionality
-in essential forever unless significant work is done.
-</li>
-<li>
-<b>4.4</b>: Changelog files must be encoded in UTF-8.
-</li>
-<li>
-<b>4.4</b>: Tighten some format requirements for changelog files from a should
-to a must.
-</li>
-<li>
-<b>4.4.1</b>: Remove alternative changelog formats. Debian only supports one
-changelog format for the Debian Archive.
-</li>
-<li>
-<b>4.9.1</b>: New nocheck option for DEB_BUILD_OPTIONS indicating any build-time
-test suite provided by the package should not be run.
-</li>
-<li>
-<b>5.1</b>: All control files must be encoded in UTF-8.
-</li>
-<li>
-<b>5.2</b>: <code>debian/control</code> allows comment lines starting with # with no
-preceding whitespace.
-</li>
-<li>
-<b>9.3</b>: Init scripts ending in .sh are not handled specially. They are not
-sourced and are not guaranteed to be run by <code>/bin/sh</code> regardless of
-the #! line. This brings Policy in line with the long-standing
-behavior of the init system in Debian.
-</li>
-<li>
-<b>9.3.2</b>: The start action of an init script must exit successfully and not
-start the daemon again if it's already running.
-</li>
-<li>
-<b>9.3.2</b>: <code>/var/run</code> and <code>/var/lock</code> may be mounted as temporary filesystems,
-and init scripts must therefore create any necessary subdirectories
-dynamically.
-</li>
-<li>
-<b>10.4</b>: <code>/bin/sh</code> scripts may assume that local can take multiple variable
-arguments and supports assignment.
-</li>
-<li>
-<b>11.6</b>: User mailboxes may be mode 600 and owned by the user rather than
-mode 660, owned by user, and group mail.
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.5" class="outline-4">
-<h4 id="sec-2.5"><a name="v3.8.0.0" id="v3.8.0.0"></a>3.8.0.0 </h4>
-<div class="outline-text-4" id="text-2.5">
-
-
-<p>
-Released Jun 2008.
-</p>
-<ul>
-<li>
-<b>2.4, 3.7</b>: The base section has been removed. contrib and non-free have been
-removed from the section list; they are only categories. The base
-system is now defined by priority.
-</li>
-<li>
-<b>4.9</b>: If dpkg-source -x doesn't provide the source that will be compiled,
-a debian/rules patch target is recommended and should do whatever
-else is necessary.
-</li>
-<li>
-<b>4.9.1, 10.1</b>: Standardized the format of DEB_BUILD_OPTIONS. Specified permitted
-characters for tags, required that tags be whitespace-separated,
-allowed packages to assume non-conflicting tags, and required
-unknown flags be ignored.
-</li>
-<li>
-<b>4.9.1</b>: Added parallel=n to the standardized DEB_BUILD_OPTIONS tags,
-indicating that a package should be built using up to n parallel
-processes if the package supports it
-</li>
-<li>
-<b>4.13</b>: Debian packages should not use convenience copies of code from other
-packages unless the included package is explicitly intended to be
-used that way.
-</li>
-<li>
-<b>4.14</b>: If dpkg-source -x doesn't produce source ready for editing and
-building with dpkg-buildpackage, packages should include a
-<code>debian/README.source</code> file explaining how to generate the patched
-source, add a new modification, and remove an existing
-modification. This file may also be used to document packaging a
-new upstream release and any other complexity of the Debian build
-process.
-</li>
-<li>
-<b>5.6.3</b>: The Uploaders field in <code>debian/control</code> may be wrapped.
-</li>
-<li>
-<b>5.6.12</b>: An empty Debian revision is equivalent to a Debian revision of 0 in
-a version number.
-</li>
-<li>
-<b>5.6.23</b>: New Homepage field for upstream web sites.
-</li>
-<li>
-<b>6.5, 6.6, 7</b>: The Breaks field declares that this package breaks another and
-prevents installation of the breaking package unless the package
-named in Breaks is deconfigured first. This field should not be
-used until the dpkg in Debian stable supports it.
-</li>
-<li>
-<b>8.1, 8.2</b>: Clarify which files should go into a shared library package, into a
-separate package, or into the -dev package. Suggest -tools instead
-of -runtime for runtime support programs, since that naming is more
-common in Debian.
-</li>
-<li>
-<b>9.5</b>: Files in <code>/etc/cron.{hourly,daily,weekly,monthly}</code> must be
-configuration files (upgraded from should). Mention the hourly
-directory.
-</li>
-<li>
-<b>11.8.6</b>: Packages providing <code>/etc/X11/Xresources</code> files need not conflict
-with xbase (<< 3.3.2.3a-2), which is long-obsolete.
-</li>
-<li>
-<b>12.1</b>: Manual pages in locale-specific directories should use either the
-legacy encoding for that directory or UTF-8. Country names should
-not be included in locale-specific manual page directories unless
-indicating a significant difference in the language. All
-characters in the manual page source should be representable in the
-legacy encoding for a locale even if the man page is encoded in
-UTF-8.
-</li>
-<li>
-<b>12.5</b>: The Apache 2.0 license is now in common-licenses and should be
-referenced rather than quoted in <code>debian/copyright</code>.
-</li>
-<li>
-<b>12.5</b>: Packages in contrib and non-free should state in the copyright file
-that the package is not part of Debian GNU/Linux and briefly
-explain why.
-</li>
-<li>
-<b>debconf</b>: Underscore (_) is allowed in debconf template names.
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.6" class="outline-4">
-<h4 id="sec-2.6"><a name="v3.7.3.0" id="v3.7.3.0"></a>3.7.3.0 </h4>
-<div class="outline-text-4" id="text-2.6">
-
-
-<p>
-Released Dec 2007.
-</p>
-<ul>
-<li>
-<b>5.6.12</b>: Package version numbers may contain tildes, which sort before
-anything, even the end of a part.
-</li>
-<li>
-<b>10.4</b>: Scripts may assume that <code>/bin/sh</code> supports local (at a basic level)
-and that its test builtin (if any) supports -a and -o binary
-logical operators.
-</li>
-<li>
-<b>8.5</b>: The substitution variable ${binary:Version} should be used in place
-of ${Source-Version} for dependencies between packages of the same
-library.
-</li>
-<li>
-<b>menu policy</b>: Substantial reorganization and renaming of sections in the Debian
-menu structure. Packages with menu entries should be reviewed to
-see if the menu section has been renamed or if one of the new
-sections would be more appropriate.
-</li>
-<li>
-<b>5.6.1</b>: The Source field in a .changes file may contain a version number
-in parentheses.
-</li>
-<li>
-<b>5.6.17</b>: The acceptable values for the Urgency field are low, medium, high,
-critical, or emergency.
-</li>
-<li>
-<b>8.6</b>: The shlibs file now allows an optional type field, indicating the
-type of package for which the line is valid. The only currently
-supported type is udeb, used with packages for the Debian
-Installer.
-</li>
-<li>
-<b>3.9.1</b>: Packages following the Debian Configuration management
-specification must allow for translation of their messages by using
-a gettext-based system such as po-debconf.
-</li>
-<li>
-<b>12.5</b>: GFDL 1.2, GPL 3, and LGPL 3 are now in common-licenses and should
-be referenced rather than quoted in <code>debian/copyright</code>.
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.7" class="outline-4">
-<h4 id="sec-2.7"><a name="v3.7.2.2" id="v3.7.2.2"></a>3.7.2.2 </h4>
-<div class="outline-text-4" id="text-2.7">
-
-
-<p>
-Released Oct 2006.
-</p>
-<ul>
-<li>
-<b>6.1</b>: Maintainer scripts must not be world writeable (up from a
-should to a must)
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.8" class="outline-4">
-<h4 id="sec-2.8"><a name="v3.7.2.0" id="v3.7.2.0"></a>3.7.2.0 </h4>
-<div class="outline-text-4" id="text-2.8">
-
-
-<p>
-Released Apr 2006.
-</p>
-<ul>
-<li>
-<b>11.5</b>: Revert the cgi-lib change.
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.9" class="outline-4">
-<h4 id="sec-2.9"><a name="v3.7.1.0" id="v3.7.1.0"></a>3.7.1.0 </h4>
-<div class="outline-text-4" id="text-2.9">
-
-
-<p>
-Released Apr 2006.
-</p>
-<ul>
-<li>
-<b>10.2</b>: It is now possible to create shared libraries without
-relocatable code (using -fPIC) in certain exceptional cases,
-provided some procedures are followed, and for creating static
-libraries with relocatable code (again, using -fPIC).
-Discussion on debian-devel@lists.debian.org, getting a rough
-consensus, and documenting it in README.Debian constitute most
-of the process.
-</li>
-<li>
-<b>11.8.7</b>: Packages should install any relevant files into the directories
-<code>/usr/include/X11/</code> and <code>/usr/lib/X11/</code>, but if they do so, they
-must pre-depend on x11-common (>= 1:7.0.0)
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.10" class="outline-4">
-<h4 id="sec-2.10"><a name="v3.7.0.0" id="v3.7.0.0"></a>3.7.0.0 </h4>
-<div class="outline-text-4" id="text-2.10">
-
-
-<p>
-Released Apr 2006.
-</p>
-<ul>
-<li>
-<b>11.5</b>: Packages shipping web server CGI files are expected to install
-them in <code>/usr/lib/cgi-lib/</code> directories. This location change
-perhaps should be documented in NEWS
-</li>
-<li>
-<b>11.5</b>: Web server packages should include a standard scriptAlias of
-cgi-lib to <code>/usr/lib/cgi-lib</code>.
-</li>
-<li>
-<b>9.1.1</b>: The version of FHS mandated by policy has been upped to
-2.3. There should be no changes required for most packages,
-though new top level directories <code>/media</code>, <code>/srv</code>, etc may be of
-interest.
-</li>
-<li>
-<b>5.1, 5.6.3</b>: All fields, apart from the Uploaders field, in the control file
-are supposed to be a single logical line, which may be spread
-over multiple physical lines (newline followed by space is
-elided). However, any parser for the control file must allow
-the Uploaders field to be spread over multiple physical lines
-as well, to prepare for future changes.
-</li>
-<li>
-<b>10.4</b>: When scripts are installed into a directory in the system
-PATH, the script name should not include an extension that
-denotes the scripting language currently used to implement it.
-
-</li>
-<li>
-<b>9.3.3.2</b>: packages that invoke initscripts now must use invoke-rc.d to do
-so since it also pays attention to run levels and other local
-constraints.
-</li>
-<li>
-<b>11.8.5.2, 11.8.7, etc</b>: We no longer use <code>/usr/X11R6</code>, since we have
-migrated away to using Xorg paths. This means, for one thing, fonts
-live in <code>/usr/share/fonts/X11/</code> now, and <code>/usr/X11R6</code> is gone.
-
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.11" class="outline-4">
-<h4 id="sec-2.11"><a name="v3.6.2.0" id="v3.6.2.0"></a>3.6.2.0 </h4>
-<div class="outline-text-4" id="text-2.11">
-
-
-<p>
-Released 2005
-</p>
-<ul>
-<li>
-Recommend. doc-base, and not menu, for registering package documentation.
-</li>
-<li>
-<b>8.1</b>: Run time support programs should live in subdirectories of
-<code>/usr/lib/</code> or <code>/usr/share</code>, and preferably the shared lib is named
-the same as the package name (to avoid name collisions).
-</li>
-<li>
-<b>11.5</b>: It is recommended that HTTP servers provide an alias <code>/images</code> to
-allow packages to share image files with the web server
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.12" class="outline-4">
-<h4 id="sec-2.12"><a name="v3.6.1.0" id="v3.6.1.0"></a>3.6.1.0 </h4>
-<div class="outline-text-4" id="text-2.12">
-
-
-<p>
-Released Aug 2003.
-</p>
-<ul>
-<li>
-<b>3.10.1</b>: Prompting the user should be done using debconf. Non debconf
-user prompts are now deprecated.
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.13" class="outline-4">
-<h4 id="sec-2.13"><a name="v3.6.0.0" id="v3.6.0.0"></a>3.6.0 </h4>
-<div class="outline-text-4" id="text-2.13">
-
-
-<p>
-Released Jul 2003.
-</p>
-<ul>
-<li>
-Restructuring causing shifts in section numbers and bumping of
-the minor version number:
-</li>
-<li>
-Many packaging manual appendices that were integrated into policy
-sections are now empty, and replaced with links to the Policy.
-In particular, the appendices that included the list of control
-fields were updated (new fields like Closes, Changed-By were added)
-and the list of fields for each of control, .changes and .dsc files
-is now in Policy, and they're marked mandatory, recommended or
-optional based on the current practice and the behavior of the
-deb-building tool-chain.
-</li>
-<li>
-Elimination of needlessly deep section levels, primarily in the
-chapter Debian Archive, from which two new chapters were split out,
-Binary packages and Source packages. What remained was reordered
-properly, that is, some sect1s became sects etc.
-</li>
-<li>
-Several sections that were redundant, crufty or simply not designed
-with any sort of vision, were rearranged according to the formula that
-everything should be either in the same place or properly interlinked.
-Some things remained split up between different chapters when they
-talked about different aspects of files: their content, their syntax,
-and their placement in the file system. In particular, see the new
-sections about changelog files.
-</li>
-<li>
-<b>menu policy</b>: Added Games/Simulation and Apps/Education to menu
-sub-policy
-</li>
-<li>
-<b>C.2.2</b>: Debian changelogs should be UTF-8 encoded.
-</li>
-<li>
-<b>10.2</b>: shared libraries must be linked against all libraries that they
-use symbols from in the same way that binaries are.
-</li>
-<li>
-<b>7.6</b>: build-depends-indep need not be satisfied during clean
-target.
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.14" class="outline-4">
-<h4 id="sec-2.14"><a name="v3.5.10.0" id="v3.5.10.0"></a>3.5.10 </h4>
-<div class="outline-text-4" id="text-2.14">
-
-
-<p>
-Released May 2003.
-</p>
-<ul>
-<li>
-<b>11.8.3</b>: packages providing the x-terminal-emulator virtual package
-ought to ensure that they interpret the command line exactly
-like xterm does.
-</li>
-<li>
-<b>11.8.4</b>: Window managers compliant with the Window Manager Specification
-Project may add 40 points for ranking in the alternatives
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.15" class="outline-4">
-<h4 id="sec-2.15"><a name="v3.5.9.0" id="v3.5.9.0"></a>3.5.9.0 </h4>
-<div class="outline-text-4" id="text-2.15">
-
-
-<p>
-Released Mar 2003.
-</p>
-<ul>
-<li>
-<b>3.4.2</b>: The section describing the Description: package field once again has
-full details of the long description format.
-</li>
-<li>
-<b>4.2</b>: Clarified that if a package has non-build-essential
-build-dependencies, it should have them listed in the Build-Depends
-and related fields (i.e. it's not merely optional).
-</li>
-<li>
-<b>9.3.2</b>: When asked to restart a service that isn't already running,
-the init script should start the service.
-</li>
-<li>
-<b>12.6</b>: If the purpose of a package is to provide examples, then the
-example files can be installed into <code>/usr/share/doc/package</code> (rather
-than <code>/usr/share/doc/package/examples</code>).
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.16" class="outline-4">
-<h4 id="sec-2.16"><a name="v3.5.8.0" id="v3.5.8.0"></a>3.5.8.0 </h4>
-<div class="outline-text-4" id="text-2.16">
-
-
-<p>
-Released Nov 2002.
-</p>
-<ul>
-<li>
-<b>12.7</b>: It is no longer necessary to keep a log of changes to the upstream
-sources in the copyright file. Instead, all such changes should be
-documented in the changelog file.
-</li>
-<li>
-<b>7.6</b>: <code>Build-Depends</code>, <code>Build-Conflicts</code>, <code>Build-Depends-Indep</code>,
-and <code>Build-Conflicts-Indep</code> must also be satisfied when the clean
-target is called.
-</li>
-<li>
-<b>menu policy</b>: A new Apps/Science menu section is available
-</li>
-<li>
-<b>debconf policy</b>: debconf specification cleared up, various changes.
-</li>
-<li>
-<b>12.1</b>: It is no longer recommended to create symlinks from nonexistent
-manual pages to undocumented(7). Missing manual pages for programs
-are still a bug.
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.17" class="outline-4">
-<h4 id="sec-2.17"><a name="v3.5.7.0" id="v3.5.7.0"></a>3.5.7.0 </h4>
-<div class="outline-text-4" id="text-2.17">
-
-
-<p>
-Released Aug 2002.
-</p>
-<ul>
-<li>
-Packages no longer have to ask permission to call MAKEDEV in
-postinst, merely notifying the user ought to be enough.
-</li>
-<li>
-<b>2.2.4</b>: cryptographic software may now be included in the main
-archive.
-</li>
-<li>
-<b>3.9</b>: task packages are no longer permitted; tasks are now created by a
-special Tasks: field in the control file.
-</li>
-<li>
-<b>11.8.4</b>: window managers that support netwm can now add 20 points when
-they add themselves as an alternative for
-<code>/usr/bin/x-window-manager</code>
-</li>
-<li>
-<b>10.1</b>: The default compilation options have now changed, one should
-provide debugging symbols in all cases, and optionally step
-back optimization to -O0, depending on the DEB_BUILD_OPTIONS
-environment variable.
-</li>
-<li>
-<b>7.6, 4.8</b>: Added mention of build-arch, build-indep, etc, in describing
-the relationships with `Build-Depends', `Build-Conflicts',
-`Build-Depends-Indep', and `Build-Conflicts-Indep'. May need to
-review the new rules.
-</li>
-<li>
-<b>8</b>: Changed rules on how, and when, to invoke ldconfig in maintainer
-scripts. Long rationale.
-
-<p>
-<b>Added the last note in 3.5.6 upgrading checklist item regarding build rules, please see below</b>
-</p>
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.18" class="outline-4">
-<h4 id="sec-2.18"><a name="v3.5.6.0" id="v3.5.6.0"></a>3.5.6.0 </h4>
-<div class="outline-text-4" id="text-2.18">
-
-
-<p>
-Released Jul 2001.
-</p>
-<ul>
-<li>
-<b>2.5</b>: Emacs and TeX are no longer mandated by policy to be priority
-standard packages
-</li>
-<li>
-<b>11.5</b>: Programs that access docs need to do so via <code>/usr/share/doc</code>, and
-not via <code>/usr/doc/</code> as was the policy previously
-</li>
-<li>
-<b>12.3</b>: Putting documentation in <code>/usr/doc</code> versus <code>/usr/share/doc</code> is now
-a ``serious'' policy violation.
-</li>
-<li>
-<b>11.5</b>: For web servers, one should not provide non-local access to the
-<code>/usr/share/doc</code> hierarchy. If one can't provide access controls for
-the <a href="http://localhost/doc/">http://localhost/doc/</a> directory, then it is preferred that one
-ask permission to expose that information during the install.
-</li>
-<li>
-<b>7</b>: There are new rules for build-indep/build-arch targets and
-there is a new Build-Depend-Indep semantic.
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.19" class="outline-4">
-<h4 id="sec-2.19"><a name="v3.5.5.0" id="v3.5.5.0"></a>3.5.5.0 </h4>
-<div class="outline-text-4" id="text-2.19">
-
-
-<p>
-Released May 2001.
-</p>
-<ul>
-<li>
-<b>12.1</b>: Manpages should not rely on header information to have
-alternative manpage names available; it should only use
-symlinks or .so pages to do this
-</li>
-<li>
-*Clarified note in 3.5.3.0 upgrading checklist regarding
-examples and templates: this refers only to those examples used
-by scripts; see section 10.7.3 for the whole story*
-</li>
-<li>
-Included a new section 10.9.1 describing the use of
-dpkg-statoverride; this does not have the weight of policy
-</li>
-<li>
-Clarify Standards-Version: you don't need to rebuild your
-packages just to change the Standards-Version!
-</li>
-<li>
-<b>10.2</b>: Plugins are no longer bound by all the rules of shared
-libraries
-</li>
-<li>
-X Windows related things:
-<ul>
-<li>
-<b>11.8.1</b>: Clarification of priority levels of X Window System related
-packages
-</li>
-<li>
-<b>11.8.3</b>: Rules for defining x-terminal-emulator improved
-</li>
-<li>
-<b>11.8.5</b>: X Font policy rewritten: you must read this if you provide
-fonts for the X Window System
-</li>
-<li>
-<b>11.8.6</b>: Packages must not ship <code>/usr/X11R6/lib/X11/app-defaults/</code>
-</li>
-<li>
-<b>11.8.7</b>: X-related packages should usually use the regular FHS
-locations; imake-using packages are exempted from this
-</li>
-<li>
-<b>11.8.8</b>: OpenMotif linked binaries have the same rules as
-OSF/Motif-linked ones
-
-</li>
-</ul>
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.20" class="outline-4">
-<h4 id="sec-2.20"><a name="v3.5.4.0" id="v3.5.4.0"></a>3.5.4.0 </h4>
-<div class="outline-text-4" id="text-2.20">
-
-
-<p>
-Released Apr 2001.
-</p>
-<ul>
-<li>
-<b>11.6</b>: The system-wide mail directory is now <code>/var/mail</code>, no longer
-<code>/var/spool/mail</code>. Any packages accessing the mail spool should
-access it via <code>/var/mail</code> and include a suitable Depends field;
-details in
-</li>
-<li>
-<b>11.9; perl-policy</b>: The perl policy is now part of Debian policy
-proper. Perl programs and modules should follow the current Perl
-policy
-
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.21" class="outline-4">
-<h4 id="sec-2.21"><a name="v3.5.3.0" id="v3.5.3.0"></a>3.5.3.0 </h4>
-<div class="outline-text-4" id="text-2.21">
-
-
-<p>
-Apr 2001
-</p>
-<ul>
-<li>
-<b>7.1</b>: Build-Depends arch syntax has been changed to be less
-ambiguous. This should not affect any current packages
-</li>
-<li>
-<b>10.7.3</b>: Examples and templates files for use by scripts should now live
-in <code>/usr/share/<package></code> or <code>/usr/lib/<package></code>, with
-symbolic links from <code>/usr/share/doc/<package>/examples</code> as
-needed
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.22" class="outline-4">
-<h4 id="sec-2.22"><a name="v3.5.2.0" id="v3.5.2.0"></a>3.5.2.0 </h4>
-<div class="outline-text-4" id="text-2.22">
-
-
-<p>
-Released Feb 2001.
-</p>
-<ul>
-<li>
-<b>11.8.6</b>: X app-defaults directory has moved from
-<code>/usr/X11R6/lib/X11/app-defaults</code> to <code>/etc/X11/app-defaults</code>
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.23" class="outline-4">
-<h4 id="sec-2.23"><a name="v3.5.1.0" id="v3.5.1.0"></a>3.5.1.0 </h4>
-<div class="outline-text-4" id="text-2.23">
-
-
-<p>
-Released Feb 2001.
-</p>
-<ul>
-<li>
-<b>8.1</b>: dpkg-shlibdeps now uses objdump, so shared libraries have to be
-run through dpkg-shlibdeps as well as executables
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.24" class="outline-4">
-<h4 id="sec-2.24"><a name="v3.5.0.0" id="v3.5.0.0"></a>3.5.0.0 </h4>
-<div class="outline-text-4" id="text-2.24">
-
-
-<p>
-Released Jan 2001.
-</p>
-<ul>
-<li>
-<b>11.8.5</b>: Font packages for the X Window System must now declare a
-dependency on xutils (>= 4.0.2)
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.25" class="outline-4">
-<h4 id="sec-2.25"><a name="v3.2.1.1" id="v3.2.1.1"></a>3.2.1.1 </h4>
-<div class="outline-text-4" id="text-2.25">
-
-
-<p>
-Released Jan 2001.
-</p>
-<ul>
-<li>
-<b>9.3.2</b>: Daemon startup scripts in <code>/etc/init.d/</code> should not contain
-modifiable parameters; these should be moved to a file in
-<code>/etc/default/</code>
-</li>
-<li>
-<b>12.3</b>: Files in <code>/usr/share/doc</code> must not be referenced by any
-program. If such files are needed, they must be placed in
-<code>/usr/share/<package>/</code>, and symbolic links created as required
-in <code>/usr/share/doc/<package>/</code>
-</li>
-<li>
-Much of the packaging manual has now been imported into the
-policy document
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.26" class="outline-4">
-<h4 id="sec-2.26"><a name="v3.2.1.0" id="v3.2.1.0"></a>3.2.1.0 </h4>
-<div class="outline-text-4" id="text-2.26">
-
-
-<p>
-Released Aug 00.
-</p>
-<ul>
-<li>
-<b>11.8.1</b>: A package of priority standard or higher may provide two
-binaries, one compiled with support for the X Window System,
-and the other without
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.27" class="outline-4">
-<h4 id="sec-2.27"><a name="v3.2.0.0" id="v3.2.0.0"></a>3.2.0.0 </h4>
-<div class="outline-text-4" id="text-2.27">
-
-
-<p>
-Released Aug 00.
-</p>
-<ul>
-<li>
-<b>10.1</b>: By default executables should not be built with the debugging
-option -g. Instead, it is recommended to support building the
-package with debugging information optionally. Details in
-</li>
-<li>
-<b>12.8</b>: Policy for packages where the upstream uses HTML changelog
-files has been expanded. In short, a plain text changelog file
-should always be generated for the upstream changes
-</li>
-<li>
-Please note that the new release of the X window system (3.2)
-shall probably need sweeping changes in policy
-</li>
-<li>
-Policy for packages providing the following X-based features
-has been codified:
-<ul>
-<li>
-<b>11.8.2</b>: X server (virtual package xserver)
-</li>
-<li>
-<b>11.8.3</b>: X terminal emulator (virtual package x-terminal-emulator)
-</li>
-<li>
-<b>11.8.4</b>: X window manager (virtual package x-window-manager, and
-<code>/usr/bin/x-window-manager</code> alternative, with priority
-calculation guidelines)
-</li>
-<li>
-<b>12.8.5</b>: X fonts (this section has been written from scratch)
-</li>
-<li>
-<b>11.8.6</b>: X application defaults
-</li>
-</ul>
-</li>
-<li>
-<b>11.8.7</b>: Policy for packages using the X Window System and FHS issues
-has been clarified
-</li>
-<li>
-<b>11.7.3</b>: No package may contain or make hard links to conffiles
-</li>
-<li>
-<b>8</b>: Noted that newer dpkg versions do not require extreme care in
-always creating the shared lib before the symlink, so the unpack
-order be correct
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.28" class="outline-4">
-<h4 id="sec-2.28"><a name="v3.1.1.0" id="v3.1.1.0"></a>3.1.1.0 </h4>
-<div class="outline-text-4" id="text-2.28">
-
-
-<p>
-Released Nov 1999.
-</p>
-<ul>
-<li>
-<b>7.1</b>: Correction to semantics of architecture lists in Build-Depends
-etc. Should not affect many packages
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.29" class="outline-4">
-<h4 id="sec-2.29"><a name="v3.1.0.0" id="v3.1.0.0"></a>3.1.0.0 </h4>
-<div class="outline-text-4" id="text-2.29">
-
-
-<p>
-Released Oct 1999.
-</p>
-<ul>
-<li>
-<code>/usr/doc/<package></code> has to be a symlink pointing to
-<code>/usr/share/doc/<package></code>, to be maintained by postinst
-and prerm scripts. Details are in <b>defunct</b>
-</li>
-<li>
-<b>7.1, 7.6</b>: Introduced source dependencies (Build-Depends, etc.)
-</li>
-<li>
-<b>9.3.4</b>: <code>/etc/rc.boot</code> has been deprecated in favour of <code>/etc/rcS.d</code>.
-(Packages should not be touching this directory, but should use
-update-rc.d instead)
-</li>
-<li>
-<b>9.3.3</b>: update-rc.d is now the <b>only</b> allowable way of accessing the
-<code>/etc/rc?.d/[SK]??*</code> links. Any scripts which manipulate them
-directly must be changed to use update-rc.d instead. (This is
-because the file-rc package handles this information in an
-incompatible way.)
-</li>
-<li>
-<b>12.7</b>: Architecture-specific examples go in <code>/usr/lib/<package>/examples</code>
-with symlinks from <code>/usr/share/doc/<package>/examples/*</code> or from
-<code>/usr/share/doc/<package>/examples</code> itself
-</li>
-<li>
-<b>9.1.1</b>: Updated FHS to a 2.1 draft; this reverts <code>/var/state</code> to
-<code>/var/lib</code>
-</li>
-<li>
-<b>9.7; mime-policy</b>: Added MIME sub-policy document
-</li>
-<li>
-<b>12.4</b>: VISUAL is allowed as a (higher priority) alternative to EDITOR
-</li>
-<li>
-<b>11.6</b>: Modified liblockfile description, which affects
-mailbox-accessing programs. Please see the policy document for
-details
-</li>
-<li>
-<b>12.7</b>: If a package provides a changelog in HTML format, a text-only
-version should also be included. (Such a version may be prepared
-using lynx -dump -nolist.)
-</li>
-<li>
-<b>3.2.1</b>: Description of how to handle version numbers based on dates
-added
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.30" class="outline-4">
-<h4 id="sec-2.30"><a name="v3.0.1.0" id="v3.0.1.0"></a>3.0.1.0 </h4>
-<div class="outline-text-4" id="text-2.30">
-
-
-<p>
-Released Jul 1999.
-</p>
-<ul>
-<li>
-<b>10.2</b>: Added the clarification that the .la files are essential for
-the packages using libtool's libltdl library, in which case the .la
-files must go in the run-time library package
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.31" class="outline-4">
-<h4 id="sec-2.31"><a name="v3.0.0.0" id="v3.0.0.0"></a>3.0.0.0 </h4>
-<div class="outline-text-4" id="text-2.31">
-
-
-<p>
-Released Jun 1999.
-</p>
-<ul>
-<li>
-<b>9.1</b>: Debian formally moves from the FSSTND to the FHS. This is a
-major change, and the implications of this move are probably
-not all known.
-</li>
-<li>
-<b>4.1</b>: Only 3 digits of the Standards version need be included in
-control files, though all four digits are still permitted.
-</li>
-<li>
-<b>12.6</b>: The location of the GPL has changed to
-<code>/usr/share/common-licenses</code>. This may require changing the
-copyright files to point to the correct location of the GPL and
-other major licenses
-</li>
-<li>
-<b>10.2</b>: Packages that use libtool to create shared libraries must
-include the .la files in the -dev packages
-</li>
-<li>
-<b>10.8</b>: Use logrotate to rotate log files
-</li>
-<li>
-<b>11.8</b>: section 5.8 (now 11.8) has been rewritten (Programs for the X Window
-System)
-</li>
-<li>
-<b>9.6; menu-policy</b>: There is now an associated menu policy, in a separate document,
-that carries the full weight of Debian policy
-</li>
-<li>
-<b>11.3</b>: Programs which need to modify the files <code>/var/run/utmp</code>,
-<code>/var/log/wtmp</code> and <code>/var/log/lastlog</code> must be installed setgid utmp
-
-
-<p>
-<b>Please note that section numbers below this point may not be up to date</b>
-</p>
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.32" class="outline-4">
-<h4 id="sec-2.32"><a name="v2.5.0.0" id="v2.5.0.0"></a>2.5.0.0 </h4>
-<div class="outline-text-4" id="text-2.32">
-
-
-<p>
-Released Oct 1998.
-</p>
-<p>
-Policy Manual:
-</p><ul>
-<li>
-Rearranged the manual to create a new Section 4, Files
-<ul>
-<li>
-Section 3.3 ("Files") was moved to Section 4. The Sections
-that were Section 4 and Section 5 were moved down to become
-Section 5 and Section 6.
-</li>
-<li>
-What was Section 5.5 ("Log files") is now a subsection of the
-new Section 4 ("Files"), becoming section 4.8, placed after
-"Configuration files", moving the Section 4.8 ("Permissions
-and owners") to Section 4.9. All subsections of the old
-Section 5 after 5.5 were moved down to fill in the number
-gap.
-</li>
-</ul>
-</li>
-<li>
-Modified the section about changelog files to accommodate
-upstream changelogs which were formatted as HTML. These
-upstream changelog files should now be accessible as
-<code>/usr/doc/package/changelog.html.gz</code>
-<ul>
-<li>
-Symlinks are permissible to link the real, or upstream,
-changelog name to the Debian mandated name.
-</li>
-</ul>
-</li>
-<li>
-Clarified that HTML documentation should be present in some
-package, though not necessarily the main binary package.
-</li>
-<li>
-Corrected all references to the location of the copyright
-files. The correct location is <code>/usr/doc/package/copyright</code>
-</li>
-<li>
-Ratified the architecture specification strings to cater to the
-HURD.
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.33" class="outline-4">
-<h4 id="sec-2.33"><a name="v2.4.1.0" id="v2.4.1.0"></a>2.4.1.0 </h4>
-<div class="outline-text-4" id="text-2.33">
-
-
-<p>
-Released Apr 1998.
-</p>
-<ul>
-<li id="sec-2.33.1">Policy Manual: <br/>
-<ul>
-<li>
-Updated section 3.3.5 Symbolic links:
-<ul>
-<li>
-symbolic links within a toplevel directory should be relative,
-symbolic links between toplevel directories should be absolute
-(cf., Policy Weekly Issue#6, topic 2)
-
-</li>
-</ul>
-</li>
-<li>
-Updated section 4.9 Games:
-<ul>
-<li>
-manpages for games should be installed in <code>/usr/man/man6</code>
-(cf., Policy Weekly Issue#6, topic 3)
-
-</li>
-</ul>
-</li>
-</ul>
-</li>
-<li id="sec-2.33.2">Packaging Manual: <br/>
-<ul>
-<li>
-Updated prefix of chapter 12, Shared Libraries:
-ldconfig must be called in the postinst script if the package
-installs shared libraries
-(cf., Policy Weekly Issue #6, fixes:bug#20515)
-
-</li>
-</ul>
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.34" class="outline-4">
-<h4 id="sec-2.34"><a name="v2.4.0.0" id="v2.4.0.0"></a>2.4.0.0 </h4>
-<div class="outline-text-4" id="text-2.34">
-
-
-<p>
-Released Jan 1998
-</p>
-<ul>
-<li>
-Updated section 3.3.4 Scripts:
-<ul>
-<li>
-<code>/bin/sh</code> may be any POSIX compatible shell
-</li>
-<li>
-scripts including bashisms have to specify <code>/bin/bash</code> as
-interpreter
-</li>
-<li>
-scripts which create files in world-writable directories
-(e.g., in <code>/tmp</code>) should use tempfile or mktemp for creating
-the directory
-
-</li>
-</ul>
-</li>
-<li>
-Updated section 3.3.5 Symbolic Links:
-<ul>
-<li>
-symbolic links referencing compressed files must have the same
-file extension as the referenced file
-
-</li>
-</ul>
-</li>
-<li>
-Updated section 3.3.6 Device files:
-<ul>
-<li>
-<code>/dev/tty*</code> serial devices should be used instead of <code>/dev/cu*</code>
-
-</li>
-</ul>
-</li>
-<li>
-Updated section 3.4.2 Writing the scripts in <code>/etc/init.d</code>:
-<ul>
-<li>
-all <code>/etc/init.d</code> scripts have to provide the following options:
-start, stop, restart, force-reload
-</li>
-<li>
-the reload option is optional and must never stop and restart
-the service
-
-</li>
-</ul>
-</li>
-<li>
-Updated section 3.5 Cron jobs:
-<ul>
-<li>
-cron jobs that need to be executed more often than daily should
-be installed into <code>/etc/cron.d</code>
-
-</li>
-</ul>
-</li>
-<li>
-Updated section 3.7 Menus:
-<ul>
-<li>
-removed section about how to register HTML docs to `menu'
-(the corresponding section in 4.4, Web servers and applications,
-has been removed in policy 2.2.0.0 already, so this one was
-obsolete)
-
-</li>
-</ul>
-</li>
-<li>
-New section 3.8 Keyboard configuration:
-<ul>
-<li>
-details about how the backspace and delete keys should be
-handled
-
-</li>
-</ul>
-</li>
-<li>
-New section 3.9 Environment variables:
-<ul>
-<li>
-no program must depend on environment variables to get a
-reasonable default configuration
-
-</li>
-</ul>
-</li>
-<li>
-New section 4.6 News system configuration:
-<ul>
-<li>
-<code>/etc/news/organization</code> and <code>/etc/news/server</code> should be supported
-by all news servers and clients
-
-</li>
-</ul>
-</li>
-<li>
-Updated section 4.7 Programs for the X Window System:
-<ul>
-<li>
-programs requiring a non-free Motif library should be provided
-as foo-smotif and foo-dmotif package
-</li>
-<li>
-if lesstif works reliably for such program, it should be linked
-against lesstif and not against a non-free Motif library
-
-</li>
-</ul>
-</li>
-<li>
-Updated section 4.9 Games:
-<ul>
-<li>
-games for X Windows have to be installed in <code>/usr/games</code>, just as
-non-X games
-
-</li>
-</ul>
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.35" class="outline-4">
-<h4 id="sec-2.35"><a name="v2.3.0" id="v2.3.0"></a>2.3.0.1, 2.3.0.0 </h4>
-<div class="outline-text-4" id="text-2.35">
-
-
-<p>
-Released Sep 1997.
-</p>
-<ul>
-<li>
-new section `4.2 Daemons' including rules for
-<code>/etc/services</code>, <code>/etc/protocols</code>, <code>/etc/rpc</code>, and <code>/etc/inetd.conf</code>
-
-</li>
-<li>
-updated section about `Configuration files':
-packages may not touch other packages' configuration files
-
-</li>
-<li>
-MUAs and MTAs have to use liblockfile
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.36" class="outline-4">
-<h4 id="sec-2.36"><a name="v2.2.0.0" id="v2.2.0.0"></a>2.2.0.0 </h4>
-<div class="outline-text-4" id="text-2.36">
-
-
-<p>
-Released July 1997.
-</p>
-<ul>
-<li>
-added section 4.1 `Architecture specification strings':
-use
-<arch>-linux
-where <arch> is one of the following:
-i386, alpha, arm, m68k, powerpc, sparc.
-
-</li>
-<li>
-detailed rules for <code>/usr/local</code>
-
-</li>
-<li>
-user ID's
-
-</li>
-<li>
-editor/pager policy
-
-</li>
-<li>
-cron jobs
-
-</li>
-<li>
-device files
-
-</li>
-<li>
-don't install shared libraries as executable
-
-</li>
-<li>
-app-defaults files may not be conffiles
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.37" class="outline-4">
-<h4 id="sec-2.37"><a name="v2.1.3" id="v2.1.3"></a>2.1.3.2, 2.1.3.1, 2.1.3.0 </h4>
-<div class="outline-text-4" id="text-2.37">
-
-
-<p>
-Released Mar 1997.
-</p>
-<ul>
-<li>
-two programs with different functionality must not have the
-same name
-
-</li>
-<li>
-"Webstandard 3.0"
-
-</li>
-<li>
-"Standard for Console Messages"
-
-</li>
-<li>
-Libraries should be compiled with `-D_REENTRANT'
-
-</li>
-<li>
-Libraries should be stripped with "strip –strip-unneeded"
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.38" class="outline-4">
-<h4 id="sec-2.38"><a name="v2.1.2" id="v2.1.2"></a>2.1.2.2, 2.1.2.1, 2.1.2.0 </h4>
-<div class="outline-text-4" id="text-2.38">
-
-
-<p>
-Released Nov 1996.
-</p>
-<ul>
-<li>
-Some changes WRT shared libraries
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.39" class="outline-4">
-<h4 id="sec-2.39"><a name="v2.1.1" id="v2.1.1"></a>2.1.1.0 </h4>
-<div class="outline-text-4" id="text-2.39">
-
-
-<p>
-Released Sep 1996.
-</p>
-<ul>
-<li>
-No hard links in source packages
-
-</li>
-<li>
-Do not use dpkg-divert or update-alternatives without consultation
-
-</li>
-<li>
-Shared libraries must be installed stripped
-
-</li>
-</ul>
-</div>
-
-</div>
-
-<div id="outline-container-2.40" class="outline-4">
-<h4 id="sec-2.40"><a name="v2.1.0.0" id="v2.1.0.0"></a>2.1.0.0 </h4>
-<div class="outline-text-4" id="text-2.40">
-
-
-<p>
-Released Aug 1996.
-</p>
-<ul>
-<li>
-Upstream changelog must be installed too
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div id="postamble">
-<p class="author"> Author: Bill Allombert, Josip Rodin, Julian Gilbey, Russ Allbery, and Manoj Srivastava
-<a href="mailto:srivasta@debian.org"><srivasta@debian.org></a>
-</p>
-<p class="date"> Date: 2010-01-26 13:43:10 CET</p>
-<p class="creator">HTML generated by org-mode 6.33f in emacs 23</p>
-</div>
-</div>
-</body>
-</html>
+++ /dev/null
--*- mode: org; fill-column: 78 -*-
-#+STARTUP: showall
-#+STARTUP: lognotedone lognotestate
-#+OPTIONS: H:4 toc:2
-#+TITLE: Policy checklist for upgrading your packages
-#+AUTHOR: Bill Allombert, Josip Rodin, Julian Gilbey, Russ Allbery, and Manoj Srivastava
-#+EMAIL: srivasta@debian.org
-#+OPTIONS: H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:t -:t f:t *:t TeX:t LaTeX:nil skip:t d:nil tags:not-in-toc
-#+LINK_HOME: http://wiki.debian.org/Teams/Policy
-#+LINK_UP: http://www.debian.org/
-
-\usepackage{landscape}
-
-\setlength{\oddsidemargin}{0in} % default=0in
-\setlength{\textwidth}{9in} % default=9in
-
-\setlength{\columnsep}{0.5in} % default=10pt
-\setlength{\columnseprule}{1pt} % default=0pt (no line)
-
-\setlength{\textheight}{5.85in} % default=5.15in
-\setlength{\topmargin}{-0.15in} % default=0.20in
-\setlength{\headsep}{0.25in} % default=0.35in
-
-\setlength{\parskip}{1.2ex}
-\setlength{\parindent}{0mm}
-\pagestyle{empty}
-
-\setlength{\headheight}{0pt}
-\setlength{\headsep}{0pt}
-\setlength{\footskip}{5pt}
-\setlength{\textheight}{9.0in}
-\setlength{\textwidth}{6.5in}
-
-** About the checklist
-
-The checklist below has been created to simplify the upgrading process
-of old packages. Note that this list is not "official"; it simply
-gives an indication of what has changed and whether you are likely to
-need to make changes to your package in light of this. If you have
-doubts about a certain topic, if you need more details, or if you
-think some other package does not comply with policy, please refer to
-the Policy Manual itself. All of the changes from version 3.0.0
-onwards indicate which section of the Policy Manual discusses the
-issue: [3.4] means section 3.4. The section numbering changed when
-the packaging manual was incorporated into policy; the section numbers
-used below refer to the current version.
-
-Here is how the check list works: Check which policy version your
-package was checked against last (indicated in the "Standards-Version"
-field of the source package). Then move upwards until the top and
-check which of the items on the list might concern your package. Note
-which sections of policy discuss this, and then check out the Policy
-Manual for details. If you are upgrading from Policy version < 2.5.0,
-it may be easier to check through the whole of policy instead of
-picking your way through this list.
-
-** The checklist
-
-*** 3.8.4.0
-:PROPERTIES:
-:CUSTOM_ID: v3.8.4.0
-:END:
-#<<v3.8.4.0>>
-
-Released Jan 2010.
-
-+ *9.1.1* : An FHS exception has been granted for multiarch libraries.
- Permitting files to instead be installed to ~/lib/triplet~ and
- ~/usr/lib/triplet~ directories.
-+ *10.6* : Explicitly state that packages may not contain named pipes and
- should instead create them in postinst and remove them in prerm or postrm.
-+ *9.1.1* : ~/sys~ and ~/selinux~ directories are explicitly allowed as an
- exception to the FHS.
-
-*** 3.8.3.0
-:PROPERTIES:
-:CUSTOM_ID: v3.8.3.0
-:END:
-#<<v3.8.3.0>>
-
-Released Aug 2009.
-
-+ *4.9* : Add DEB\_*\_ARCH\_CPU and DEB\_*\_ARCH\_OS variables and
- recommend them over GNU-style variables for that information.
-+ *5.6.8*: Source package Architecture fields may contain /all/ in
- combination with other architectures. Clarify when /all/ and /any/
- may be used in different versions of the field.
-+ *5.6.14* : The Debian archive software does not support uploading
- to multiple distributions with one ~*.changes~ file.
-+ *5.6.19* : The Binary field may span multiple lines.
-+ *10.2* : Remove the permission for shared library packages to
- install libraries in a non-standard location and modify ld.so.conf.
- Packages should either be installed in a standard library directory
- or packages using them should be built with RPATH.
-+ *11.8.7* : Clarify installation directories for X programs and
- remove the requirement to pre-depend on x11-common before installing
- into ~/usr/include/X11~ and ~/usr/lib/X11~.
-+ *12.1* : Remove the requirement that all characters in a manual
- page be representable in the legacy encoding for that language.
-+ *12.1* : Localized man pages should either be kept up-to-date with
- the original version or warn that they're not up-to-date, either
- with warning text or by showing missing or changed portions in the
- original language.
-+ *12.2* : install-info is now handled via triggers so packages no
- longer need to invoke it in maintainer scripts. Info documents
- should now have directory sections and entries in the document.
- Packages containing info documents should add a dependency to
- support partial upgrades.
-+ *perl* : The requirement for Perl modules to have a versioned
- Depend and Build-Depend on perl >= 5.6.0-16 has been removed.
-
-*** 3.8.2.0
-:PROPERTIES:
-:CUSTOM_ID: v3.8.2.0
-:END:
-#<<v3.8.2.0>>
-
-Released Jun 2009.
-
-+ *2.4*: The list of archive sections has been significantly expanded. See
- [[http://lists.debian.org/debian-devel-announce/2009/03/msg00010.html]]
- for the list of new sections and rules for how to categorize
- packages.
-+ *3.9.1*: All packages must use debconf or equivalent for user prompting,
- though essential packages or their dependencies may also fall
- back on other methods.
-+ *5.6.1*: The requirements for source package names are now explicitly
- spelled out.
-+ *9.1*: Legacy XFree86 servers no longer get a special exception from the
- FHS permitting ~/etc/X11/XF86Config-4~.
-+ *9.1.3*: Removed obsolete dependency requirements for packages that use
- ~/var/mail~.
-+ *11.8.5*: Speedo fonts are now deprecated. The X backend was disabled
- starting in lenny.
-+ *12.5*: The GNU Free Documentation License version 1.3 is included in
- common-licenses and should be referenced from there.
-
-*** 3.8.1.0
-:PROPERTIES:
-:CUSTOM_ID: v3.8.1.0
-:END:
-#<<v3.8.1.0>>
-
-Released Mar 2009.
-
-+ *3.8*: Care should be taken when adding functionality to essential and
- such additions create an obligation to support that functionality
- in essential forever unless significant work is done.
-+ *4.4*: Changelog files must be encoded in UTF-8.
-+ *4.4*: Tighten some format requirements for changelog files from a should
- to a must.
-+ *4.4.1*: Remove alternative changelog formats. Debian only supports one
- changelog format for the Debian Archive.
-+ *4.9.1*: New nocheck option for DEB\_BUILD\_OPTIONS indicating any build-time
- test suite provided by the package should not be run.
-+ *5.1*: All control files must be encoded in UTF-8.
-+ *5.2*: ~debian/control~ allows comment lines starting with # with no
- preceding whitespace.
-+ *9.3*: Init scripts ending in .sh are not handled specially. They are not
- sourced and are not guaranteed to be run by ~/bin/sh~ regardless of
- the #! line. This brings Policy in line with the long-standing
- behavior of the init system in Debian.
-+ *9.3.2*: The start action of an init script must exit successfully and not
- start the daemon again if it's already running.
-+ *9.3.2*: ~/var/run~ and ~/var/lock~ may be mounted as temporary filesystems,
- and init scripts must therefore create any necessary subdirectories
- dynamically.
-+ *10.4*: ~/bin/sh~ scripts may assume that local can take multiple variable
- arguments and supports assignment.
-+ *11.6*: User mailboxes may be mode 600 and owned by the user rather than
- mode 660, owned by user, and group mail.
-
-*** 3.8.0.0
-:PROPERTIES:
-:CUSTOM_ID: v3.8.0.0
-:END:
-#<<v3.8.0.0>>
-
-Released Jun 2008.
-
-+ *2.4, 3.7*: The base section has been removed. contrib and non-free have been
- removed from the section list; they are only categories. The base
- system is now defined by priority.
-+ *4.9*: If dpkg-source -x doesn't provide the source that will be compiled,
- a debian/rules patch target is recommended and should do whatever
- else is necessary.
-+ *4.9.1, 10.1*: Standardized the format of DEB\_BUILD\_OPTIONS. Specified permitted
- characters for tags, required that tags be whitespace-separated,
- allowed packages to assume non-conflicting tags, and required
- unknown flags be ignored.
-+ *4.9.1*: Added parallel=n to the standardized DEB\_BUILD\_OPTIONS tags,
- indicating that a package should be built using up to n parallel
- processes if the package supports it
-+ *4.13*: Debian packages should not use convenience copies of code from other
- packages unless the included package is explicitly intended to be
- used that way.
-+ *4.14*: If dpkg-source -x doesn't produce source ready for editing and
- building with dpkg-buildpackage, packages should include a
- ~debian/README.source~ file explaining how to generate the patched
- source, add a new modification, and remove an existing
- modification. This file may also be used to document packaging a
- new upstream release and any other complexity of the Debian build
- process.
-+ *5.6.3*: The Uploaders field in ~debian/control~ may be wrapped.
-+ *5.6.12*: An empty Debian revision is equivalent to a Debian revision of 0 in
- a version number.
-+ *5.6.23*: New Homepage field for upstream web sites.
-+ *6.5, 6.6, 7*: The Breaks field declares that this package breaks another and
- prevents installation of the breaking package unless the package
- named in Breaks is deconfigured first. This field should not be
- used until the dpkg in Debian stable supports it.
-+ *8.1, 8.2*: Clarify which files should go into a shared library package, into a
- separate package, or into the -dev package. Suggest -tools instead
- of -runtime for runtime support programs, since that naming is more
- common in Debian.
-+ *9.5*: Files in ~/etc/cron.{hourly,daily,weekly,monthly}~ must be
- configuration files (upgraded from should). Mention the hourly
- directory.
-+ *11.8.6*: Packages providing ~/etc/X11/Xresources~ files need not conflict
- with xbase (<< 3.3.2.3a-2), which is long-obsolete.
-+ *12.1*: Manual pages in locale-specific directories should use either the
- legacy encoding for that directory or UTF-8. Country names should
- not be included in locale-specific manual page directories unless
- indicating a significant difference in the language. All
- characters in the manual page source should be representable in the
- legacy encoding for a locale even if the man page is encoded in
- UTF-8.
-+ *12.5*: The Apache 2.0 license is now in common-licenses and should be
- referenced rather than quoted in ~debian/copyright~.
-+ *12.5*: Packages in contrib and non-free should state in the copyright file
- that the package is not part of Debian GNU/Linux and briefly
- explain why.
-+ *debconf*: Underscore (_) is allowed in debconf template names.
-
-*** 3.7.3.0
-:PROPERTIES:
-:CUSTOM_ID: v3.7.3.0
-:END:
-#<<v3.7.3.0>>
-
-Released Dec 2007.
-
-+ *5.6.12*: Package version numbers may contain tildes, which sort before
- anything, even the end of a part.
-+ *10.4*: Scripts may assume that ~/bin/sh~ supports local (at a basic level)
- and that its test builtin (if any) supports -a and -o binary
- logical operators.
-+ *8.5*: The substitution variable ${binary:Version} should be used in place
- of ${Source-Version} for dependencies between packages of the same
- library.
-+ *menu policy*: Substantial reorganization and renaming of sections in the Debian
- menu structure. Packages with menu entries should be reviewed to
- see if the menu section has been renamed or if one of the new
- sections would be more appropriate.
-+ *5.6.1*: The Source field in a .changes file may contain a version number
- in parentheses.
-+ *5.6.17*: The acceptable values for the Urgency field are low, medium, high,
- critical, or emergency.
-+ *8.6*: The shlibs file now allows an optional type field, indicating the
- type of package for which the line is valid. The only currently
- supported type is udeb, used with packages for the Debian
- Installer.
-+ *3.9.1*: Packages following the Debian Configuration management
- specification must allow for translation of their messages by using
- a gettext-based system such as po-debconf.
-+ *12.5*: GFDL 1.2, GPL 3, and LGPL 3 are now in common-licenses and should
- be referenced rather than quoted in ~debian/copyright~.
-
-*** 3.7.2.2
-:PROPERTIES:
-:CUSTOM_ID: v3.7.2.2
-:END:
-#<<v3.7.2.2>>
-
-Released Oct 2006.
-
-+ *6.1*: Maintainer scripts must not be world writeable (up from a
- should to a must)
-
-*** 3.7.2.0
-:PROPERTIES:
-:CUSTOM_ID: v3.7.2.0
-:END:
-#<<v3.7.2.0>>
-
-Released Apr 2006.
-
-+ *11.5*: Revert the cgi-lib change.
-
-*** 3.7.1.0
-:PROPERTIES:
-:CUSTOM_ID: v3.7.1.0
-:END:
-#<<v3.7.1.0>>
-
-Released Apr 2006.
-
-+ *10.2*: It is now possible to create shared libraries without
- relocatable code (using -fPIC) in certain exceptional cases,
- provided some procedures are followed, and for creating static
- libraries with relocatable code (again, using -fPIC).
- Discussion on debian-devel@lists.debian.org, getting a rough
- consensus, and documenting it in README.Debian constitute most
- of the process.
-+ *11.8.7*: Packages should install any relevant files into the directories
- ~/usr/include/X11/~ and ~/usr/lib/X11/~, but if they do so, they
- must pre-depend on x11-common (>= 1:7.0.0)
-
-*** 3.7.0.0
-:PROPERTIES:
-:CUSTOM_ID: v3.7.0.0.
-:END:
-#<<v3.7.0.0>>
-
-Released Apr 2006.
-
-+ *11.5*: Packages shipping web server CGI files are expected to install
- them in ~/usr/lib/cgi-lib/~ directories. This location change
- perhaps should be documented in NEWS
-+ *11.5*: Web server packages should include a standard scriptAlias of
- cgi-lib to ~/usr/lib/cgi-lib~.
-+ *9.1.1*: The version of FHS mandated by policy has been upped to
- 2.3. There should be no changes required for most packages,
- though new top level directories ~/media~, ~/srv~, etc may be of
- interest.
-+ *5.1, 5.6.3*: All fields, apart from the Uploaders field, in the control file
- are supposed to be a single logical line, which may be spread
- over multiple physical lines (newline followed by space is
- elided). However, any parser for the control file must allow
- the Uploaders field to be spread over multiple physical lines
- as well, to prepare for future changes.
-+ *10.4*: When scripts are installed into a directory in the system
- PATH, the script name should not include an extension that
- denotes the scripting language currently used to implement it.
-
-+ *9.3.3.2*: packages that invoke initscripts now must use invoke-rc.d to do
- so since it also pays attention to run levels and other local
- constraints.
-+ *11.8.5.2, 11.8.7, etc*: We no longer use ~/usr/X11R6~, since we have
- migrated away to using Xorg paths. This means, for one thing, fonts
- live in ~/usr/share/fonts/X11/~ now, and ~/usr/X11R6~ is gone.
-
-
-*** 3.6.2.0
-:PROPERTIES:
-:CUSTOM_ID: v3.6.2.0
-:END:
-#<<v3.6.2.0>>
-
-Released 2005
-
-+ Recommend. doc-base, and not menu, for registering package documentation.
-+ *8.1*: Run time support programs should live in subdirectories of
- ~/usr/lib/~ or ~/usr/share~, and preferably the shared lib is named
- the same as the package name (to avoid name collisions).
-+ *11.5*: It is recommended that HTTP servers provide an alias ~/images~ to
- allow packages to share image files with the web server
-
-*** 3.6.1.0
-:PROPERTIES:
-:CUSTOM_ID: v3.6.1.0
-:END:
-#<<v3.6.1.0>>
-
-Released Aug 2003.
-
-+ *3.10.1*: Prompting the user should be done using debconf. Non debconf
- user prompts are now deprecated.
-
-*** 3.6.0
-:PROPERTIES:
-:CUSTOM_ID: v3.6.0.0
-:END:
-#<<v3.6.0.0>>
-
-Released Jul 2003.
-
-+ Restructuring causing shifts in section numbers and bumping of
- the minor version number:
-+ Many packaging manual appendices that were integrated into policy
- sections are now empty, and replaced with links to the Policy.
- In particular, the appendices that included the list of control
- fields were updated (new fields like Closes, Changed-By were added)
- and the list of fields for each of control, .changes and .dsc files
- is now in Policy, and they're marked mandatory, recommended or
- optional based on the current practice and the behavior of the
- deb-building tool-chain.
-+ Elimination of needlessly deep section levels, primarily in the
- chapter Debian Archive, from which two new chapters were split out,
- Binary packages and Source packages. What remained was reordered
- properly, that is, some sect1s became sects etc.
-+ Several sections that were redundant, crufty or simply not designed
- with any sort of vision, were rearranged according to the formula that
- everything should be either in the same place or properly interlinked.
- Some things remained split up between different chapters when they
- talked about different aspects of files: their content, their syntax,
- and their placement in the file system. In particular, see the new
- sections about changelog files.
-+ *menu policy*: Added Games/Simulation and Apps/Education to menu
- sub-policy
-+ *C.2.2*: Debian changelogs should be UTF-8 encoded.
-+ *10.2*: shared libraries must be linked against all libraries that they
- use symbols from in the same way that binaries are.
-+ *7.6*: build-depends-indep need not be satisfied during clean
- target.
-
-*** 3.5.10
-:PROPERTIES:
-:CUSTOM_ID: v3.5.10.0
-:END:
-#<<v3.5.10.0>>
-
-Released May 2003.
-
-+ *11.8.3*: packages providing the x-terminal-emulator virtual package
- ought to ensure that they interpret the command line exactly
- like xterm does.
-+ *11.8.4*: Window managers compliant with the Window Manager Specification
- Project may add 40 points for ranking in the alternatives
-
-*** 3.5.9.0
-:PROPERTIES:
-:CUSTOM_ID: v3.5.9.0
-:END:
-#<<v3.5.9.0>>
-
-Released Mar 2003.
-
-+ *3.4.2*: The section describing the Description: package field once again has
- full details of the long description format.
-+ *4.2*: Clarified that if a package has non-build-essential
- build-dependencies, it should have them listed in the Build-Depends
- and related fields (i.e. it's not merely optional).
-+ *9.3.2*: When asked to restart a service that isn't already running,
- the init script should start the service.
-+ *12.6*: If the purpose of a package is to provide examples, then the
- example files can be installed into ~/usr/share/doc/package~ (rather
- than ~/usr/share/doc/package/examples~).
-
-*** 3.5.8.0
-:PROPERTIES:
-:CUSTOM_ID: v3.5.8.0
-:END:
-#<<v3.5.8.0>>
-
-Released Nov 2002.
-
-+ *12.7*: It is no longer necessary to keep a log of changes to the upstream
- sources in the copyright file. Instead, all such changes should be
- documented in the changelog file.
-+ *7.6*: =Build-Depends=, =Build-Conflicts=, =Build-Depends-Indep=,
- and =Build-Conflicts-Indep= must also be satisfied when the clean
- target is called.
-+ *menu policy*: A new Apps/Science menu section is available
-+ *debconf policy*: debconf specification cleared up, various changes.
-+ *12.1*: It is no longer recommended to create symlinks from nonexistent
- manual pages to undocumented(7). Missing manual pages for programs
- are still a bug.
-
-*** 3.5.7.0
-:PROPERTIES:
-:CUSTOM_ID: v3.5.7.0
-:END:
-#<<v3.5.7.0>>
-
-Released Aug 2002.
-
-+ Packages no longer have to ask permission to call MAKEDEV in
- postinst, merely notifying the user ought to be enough.
-+ *2.2.4*: cryptographic software may now be included in the main
- archive.
-+ *3.9*: task packages are no longer permitted; tasks are now created by a
- special Tasks: field in the control file.
-+ *11.8.4*: window managers that support netwm can now add 20 points when
- they add themselves as an alternative for
- ~/usr/bin/x-window-manager~
-+ *10.1*: The default compilation options have now changed, one should
- provide debugging symbols in all cases, and optionally step
- back optimization to -O0, depending on the DEB\_BUILD\_OPTIONS
- environment variable.
-+ *7.6, 4.8*: Added mention of build-arch, build-indep, etc, in describing
- the relationships with `Build-Depends', `Build-Conflicts',
- `Build-Depends-Indep', and `Build-Conflicts-Indep'. May need to
- review the new rules.
-+ *8*: Changed rules on how, and when, to invoke ldconfig in maintainer
- scripts. Long rationale.
-
- *Added the last note in 3.5.6 upgrading checklist item regarding build rules, please see below*
-
-*** 3.5.6.0
-:PROPERTIES:
-:CUSTOM_ID: v3.5.6.0
-:END:
-#<<v3.5.6.0>>
-
-Released Jul 2001.
-
-+ *2.5*: Emacs and TeX are no longer mandated by policy to be priority
- standard packages
-+ *11.5*: Programs that access docs need to do so via ~/usr/share/doc~, and
- not via ~/usr/doc/~ as was the policy previously
-+ *12.3*: Putting documentation in ~/usr/doc~ versus ~/usr/share/doc~ is now
- a ``serious'' policy violation.
-+ *11.5*: For web servers, one should not provide non-local access to the
- ~/usr/share/doc~ hierarchy. If one can't provide access controls for
- the http://localhost/doc/ directory, then it is preferred that one
- ask permission to expose that information during the install.
-+ *7*: There are new rules for build-indep/build-arch targets and
- there is a new Build-Depend-Indep semantic.
-
-*** 3.5.5.0
-:PROPERTIES:
-:CUSTOM_ID: v3.5.5.0
-:END:
-#<<v3.5.5.0>>
-
-Released May 2001.
-
-+ *12.1*: Manpages should not rely on header information to have
- alternative manpage names available; it should only use
- symlinks or .so pages to do this
-+ *Clarified note in 3.5.3.0 upgrading checklist regarding
- examples and templates: this refers only to those examples used
- by scripts; see section 10.7.3 for the whole story*
-+ Included a new section 10.9.1 describing the use of
- dpkg-statoverride; this does not have the weight of policy
-+ Clarify Standards-Version: you don't need to rebuild your
- packages just to change the Standards-Version!
-+ *10.2*: Plugins are no longer bound by all the rules of shared
- libraries
-+ X Windows related things:
- * *11.8.1*: Clarification of priority levels of X Window System related
- packages
- * *11.8.3*: Rules for defining x-terminal-emulator improved
- * *11.8.5*: X Font policy rewritten: you must read this if you provide
- fonts for the X Window System
- * *11.8.6*: Packages must not ship ~/usr/X11R6/lib/X11/app-defaults/~
- * *11.8.7*: X-related packages should usually use the regular FHS
- locations; imake-using packages are exempted from this
- * *11.8.8*: OpenMotif linked binaries have the same rules as
- OSF/Motif-linked ones
-
-*** 3.5.4.0
-:PROPERTIES:
-:CUSTOM_ID: v3.5.4.0
-:END:
-#<<v3.5.4.0>>
-
-Released Apr 2001.
-
-+ *11.6*: The system-wide mail directory is now ~/var/mail~, no longer
- ~/var/spool/mail~. Any packages accessing the mail spool should
- access it via ~/var/mail~ and include a suitable Depends field;
- details in
-+ *11.9; perl-policy*: The perl policy is now part of Debian policy
- proper. Perl programs and modules should follow the current Perl
- policy
-
-
-*** 3.5.3.0
-:PROPERTIES:
-:CUSTOM_ID: v3.5.3.0
-:END:
-#<<v3.5.3.0>>
-
- Apr 2001
-
-+ *7.1*: Build-Depends arch syntax has been changed to be less
- ambiguous. This should not affect any current packages
-+ *10.7.3*: Examples and templates files for use by scripts should now live
- in ~/usr/share/<package>~ or ~/usr/lib/<package>~, with
- symbolic links from ~/usr/share/doc/<package>/examples~ as
- needed
-
-*** 3.5.2.0
-:PROPERTIES:
-:CUSTOM_ID: v3.5.2.0
-:END:
-#<<v3.5.2.0>>
-
-Released Feb 2001.
-
-+ *11.8.6*: X app-defaults directory has moved from
- ~/usr/X11R6/lib/X11/app-defaults~ to ~/etc/X11/app-defaults~
-
-*** 3.5.1.0
-:PROPERTIES:
-:CUSTOM_ID: v3.5.1.0
-:END:
-#<<v3.5.1.0>>
-
-Released Feb 2001.
-
-+ *8.1*: dpkg-shlibdeps now uses objdump, so shared libraries have to be
- run through dpkg-shlibdeps as well as executables
-
-*** 3.5.0.0
-:PROPERTIES:
-:CUSTOM_ID: v3.5.0.0
-:END:
-#<<v3.5.0.0>>
-
-Released Jan 2001.
-
-+ *11.8.5*: Font packages for the X Window System must now declare a
- dependency on xutils (>= 4.0.2)
-
-*** 3.2.1.1
-:PROPERTIES:
-:CUSTOM_ID: v3.2.1.1
-:END:
-#<<v3.2.1.1>>
-
-Released Jan 2001.
-
-+ *9.3.2*: Daemon startup scripts in ~/etc/init.d/~ should not contain
- modifiable parameters; these should be moved to a file in
- ~/etc/default/~
-+ *12.3*: Files in ~/usr/share/doc~ must not be referenced by any
- program. If such files are needed, they must be placed in
- ~/usr/share/<package>/~, and symbolic links created as required
- in ~/usr/share/doc/<package>/~
-+ Much of the packaging manual has now been imported into the
- policy document
-
-*** 3.2.1.0
-:PROPERTIES:
-:CUSTOM_ID: v3.2.1.0
-:END:
-#<<v3.2.1.0>>
-
-Released Aug 00.
-
-+ *11.8.1*: A package of priority standard or higher may provide two
- binaries, one compiled with support for the X Window System,
- and the other without
-
-*** 3.2.0.0
-:PROPERTIES:
-:CUSTOM_ID: v3.2.0.0
-:END:
-#<<v3.2.0.0>>
-
-Released Aug 00.
-
-+ *10.1*: By default executables should not be built with the debugging
- option -g. Instead, it is recommended to support building the
- package with debugging information optionally. Details in
-+ *12.8*: Policy for packages where the upstream uses HTML changelog
- files has been expanded. In short, a plain text changelog file
- should always be generated for the upstream changes
-+ Please note that the new release of the X window system (3.2)
- shall probably need sweeping changes in policy
-+ Policy for packages providing the following X-based features
- has been codified:
- - *11.8.2*: X server (virtual package xserver)
- - *11.8.3*: X terminal emulator (virtual package x-terminal-emulator)
- - *11.8.4*: X window manager (virtual package x-window-manager, and
- ~/usr/bin/x-window-manager~ alternative, with priority
- calculation guidelines)
- - *12.8.5*: X fonts (this section has been written from scratch)
- - *11.8.6*: X application defaults
-+ *11.8.7*: Policy for packages using the X Window System and FHS issues
- has been clarified
-+ *11.7.3*: No package may contain or make hard links to conffiles
-+ *8*: Noted that newer dpkg versions do not require extreme care in
- always creating the shared lib before the symlink, so the unpack
- order be correct
-
-*** 3.1.1.0
-:PROPERTIES:
-:CUSTOM_ID: v3.1.1.0
-:END:
-#<<v3.1.1.0>>
-
-Released Nov 1999.
-
-+ *7.1*: Correction to semantics of architecture lists in Build-Depends
- etc. Should not affect many packages
-
-*** 3.1.0.0
-:PROPERTIES:
-:CUSTOM_ID: v3.1.0.0
-:END:
-#<<v3.1.0.0>>
-
-Released Oct 1999.
-
-+ ~/usr/doc/<package>~ has to be a symlink pointing to
- ~/usr/share/doc/<package>~, to be maintained by postinst
- and prerm scripts. Details are in *defunct*
-+ *7.1, 7.6*: Introduced source dependencies (Build-Depends, etc.)
-+ *9.3.4*: ~/etc/rc.boot~ has been deprecated in favour of ~/etc/rcS.d~.
- (Packages should not be touching this directory, but should use
- update-rc.d instead)
-+ *9.3.3*: update-rc.d is now the *only* allowable way of accessing the
- ~/etc/rc?.d/[SK]??*~ links. Any scripts which manipulate them
- directly must be changed to use update-rc.d instead. (This is
- because the file-rc package handles this information in an
- incompatible way.)
-+ *12.7*: Architecture-specific examples go in ~/usr/lib/<package>/examples~
- with symlinks from ~/usr/share/doc/<package>/examples/*~ or from
- ~/usr/share/doc/<package>/examples~ itself
-+ *9.1.1*: Updated FHS to a 2.1 draft; this reverts ~/var/state~ to
- ~/var/lib~
-+ *9.7; mime-policy*: Added MIME sub-policy document
-+ *12.4*: VISUAL is allowed as a (higher priority) alternative to EDITOR
-+ *11.6*: Modified liblockfile description, which affects
- mailbox-accessing programs. Please see the policy document for
- details
-+ *12.7*: If a package provides a changelog in HTML format, a text-only
- version should also be included. (Such a version may be prepared
- using lynx -dump -nolist.)
-+ *3.2.1*: Description of how to handle version numbers based on dates
- added
-
-*** 3.0.1.0
-:PROPERTIES:
-:CUSTOM_ID: v3.0.1.0
-:END:
-#<<v3.0.1.0>>
-
-Released Jul 1999.
-
-+ *10.2*: Added the clarification that the .la files are essential for
- the packages using libtool's libltdl library, in which case the .la
- files must go in the run-time library package
-
-*** 3.0.0.0
-:PROPERTIES:
-:CUSTOM_ID: v3.0.0.0
-:END:
-#<<v3.0.0.0>>
-
-Released Jun 1999.
-
-+ *9.1*: Debian formally moves from the FSSTND to the FHS. This is a
- major change, and the implications of this move are probably
- not all known.
-+ *4.1*: Only 3 digits of the Standards version need be included in
- control files, though all four digits are still permitted.
-+ *12.6*: The location of the GPL has changed to
- ~/usr/share/common-licenses~. This may require changing the
- copyright files to point to the correct location of the GPL and
- other major licenses
-+ *10.2*: Packages that use libtool to create shared libraries must
- include the .la files in the -dev packages
-+ *10.8*: Use logrotate to rotate log files
-+ *11.8*: section 5.8 (now 11.8) has been rewritten (Programs for the X Window
- System)
-+ *9.6; menu-policy*: There is now an associated menu policy, in a separate document,
- that carries the full weight of Debian policy
-+ *11.3*: Programs which need to modify the files ~/var/run/utmp~,
- ~/var/log/wtmp~ and ~/var/log/lastlog~ must be installed setgid utmp
-
-
- *Please note that section numbers below this point may not be up to date*
-
-
-*** 2.5.0.0
-:PROPERTIES:
-:CUSTOM_ID: v2.5.0.0
-:END:
-#<<v2.5.0.0>>
-
-Released Oct 1998.
-
-Policy Manual:
-+ Rearranged the manual to create a new Section 4, Files
- + Section 3.3 ("Files") was moved to Section 4. The Sections
- that were Section 4 and Section 5 were moved down to become
- Section 5 and Section 6.
- + What was Section 5.5 ("Log files") is now a subsection of the
- new Section 4 ("Files"), becoming section 4.8, placed after
- "Configuration files", moving the Section 4.8 ("Permissions
- and owners") to Section 4.9. All subsections of the old
- Section 5 after 5.5 were moved down to fill in the number
- gap.
-+ Modified the section about changelog files to accommodate
- upstream changelogs which were formatted as HTML. These
- upstream changelog files should now be accessible as
- ~/usr/doc/package/changelog.html.gz~
- + Symlinks are permissible to link the real, or upstream,
- changelog name to the Debian mandated name.
-+ Clarified that HTML documentation should be present in some
- package, though not necessarily the main binary package.
-+ Corrected all references to the location of the copyright
- files. The correct location is ~/usr/doc/package/copyright~
-+ Ratified the architecture specification strings to cater to the
- HURD.
-
-*** 2.4.1.0
-:PROPERTIES:
-:CUSTOM_ID: v2.4.1.0
-:END:
-#<<v2.4.1.0>>
-
-Released Apr 1998.
-
-**** Policy Manual:
-+ Updated section 3.3.5 Symbolic links:
- + symbolic links within a toplevel directory should be relative,
- symbolic links between toplevel directories should be absolute
- (cf., Policy Weekly Issue#6, topic 2)
-
-+ Updated section 4.9 Games:
- + manpages for games should be installed in ~/usr/man/man6~
- (cf., Policy Weekly Issue#6, topic 3)
-
-**** Packaging Manual:
-+ Updated prefix of chapter 12, Shared Libraries:
- ldconfig must be called in the postinst script if the package
- installs shared libraries
- (cf., Policy Weekly Issue #6, fixes:bug#20515)
-
-*** 2.4.0.0
-:PROPERTIES:
-:CUSTOM_ID: v2.4.0.0
-:END:
-#<<v2.4.0.0>>
-
-Released Jan 1998
-
-+ Updated section 3.3.4 Scripts:
- + ~/bin/sh~ may be any POSIX compatible shell
- + scripts including bashisms have to specify ~/bin/bash~ as
- interpreter
- + scripts which create files in world-writable directories
- (e.g., in ~/tmp~) should use tempfile or mktemp for creating
- the directory
-
-+ Updated section 3.3.5 Symbolic Links:
- + symbolic links referencing compressed files must have the same
- file extension as the referenced file
-
-+ Updated section 3.3.6 Device files:
- + ~/dev/tty*~ serial devices should be used instead of ~/dev/cu*~
-
-+ Updated section 3.4.2 Writing the scripts in ~/etc/init.d~:
- + all ~/etc/init.d~ scripts have to provide the following options:
- start, stop, restart, force-reload
- + the reload option is optional and must never stop and restart
- the service
-
-+ Updated section 3.5 Cron jobs:
- + cron jobs that need to be executed more often than daily should
- be installed into ~/etc/cron.d~
-
-+ Updated section 3.7 Menus:
- + removed section about how to register HTML docs to `menu'
- (the corresponding section in 4.4, Web servers and applications,
- has been removed in policy 2.2.0.0 already, so this one was
- obsolete)
-
-+ New section 3.8 Keyboard configuration:
- + details about how the backspace and delete keys should be
- handled
-
-+ New section 3.9 Environment variables:
- + no program must depend on environment variables to get a
- reasonable default configuration
-
-+ New section 4.6 News system configuration:
- + ~/etc/news/organization~ and ~/etc/news/server~ should be supported
- by all news servers and clients
-
-+ Updated section 4.7 Programs for the X Window System:
- + programs requiring a non-free Motif library should be provided
- as foo-smotif and foo-dmotif package
- + if lesstif works reliably for such program, it should be linked
- against lesstif and not against a non-free Motif library
-
-+ Updated section 4.9 Games:
- + games for X Windows have to be installed in ~/usr/games~, just as
- non-X games
-
-*** 2.3.0.1, 2.3.0.0
-:PROPERTIES:
-:CUSTOM_ID: v2.3.0.0
-:END:
-#<<v2.3.0>>
-
-Released Sep 1997.
-
-+ new section `4.2 Daemons' including rules for
- ~/etc/services~, ~/etc/protocols~, ~/etc/rpc~, and ~/etc/inetd.conf~
-
-+ updated section about `Configuration files':
- packages may not touch other packages' configuration files
-
-+ MUAs and MTAs have to use liblockfile
-
-*** 2.2.0.0
-:PROPERTIES:
-:CUSTOM_ID: v2.2.0.0
-:END:
-#<<v2.2.0.0>>
-
-Released July 1997.
-
-+ added section 4.1 `Architecture specification strings':
- use
- <arch>-linux
- where <arch> is one of the following:
- i386, alpha, arm, m68k, powerpc, sparc.
-
-+ detailed rules for ~/usr/local~
-
-+ user ID's
-
-+ editor/pager policy
-
-+ cron jobs
-
-+ device files
-
-+ don't install shared libraries as executable
-
-+ app-defaults files may not be conffiles
-
-*** 2.1.3.2, 2.1.3.1, 2.1.3.0
-:PROPERTIES:
-:CUSTOM_ID: v2.1.3.0
-:END:
-#<<v2.1.3>>
-
-Released Mar 1997.
-
-+ two programs with different functionality must not have the
- same name
-
-+ "Webstandard 3.0"
-
-+ "Standard for Console Messages"
-
-+ Libraries should be compiled with `-D\_REENTRANT'
-
-+ Libraries should be stripped with "strip --strip-unneeded"
-
-*** 2.1.2.2, 2.1.2.1, 2.1.2.0
-:PROPERTIES:
-:CUSTOM_ID: v2.1.2
-:END:
-#<<v2.1.2>>
-
-Released Nov 1996.
-
-+ Some changes WRT shared libraries
-
-*** 2.1.1.0
-:PROPERTIES:
-:CUSTOM_ID: v2.1.1.0
-:END:
-#<<v2.1.1>>
-
-Released Sep 1996.
-
-+ No hard links in source packages
-
-+ Do not use dpkg-divert or update-alternatives without consultation
-
-+ Shared libraries must be installed stripped
-
-*** 2.1.0.0
-:PROPERTIES:
-:CUSTOM_ID: v2.1.0.0
-:END:
-#<<v2.1.0.0>>
-
-Released Aug 1996.
-
-+ Upstream changelog must be installed too
--- /dev/null
+<!doctype debiandoc system>
+
+<debiandoc>
+ <book>
+ <title> Policy checklist for upgrading your packages </title>
+ <author> Bill Allombert <email/ballombe@debian.org/ </author>
+ <author> Josip Rodin </author>
+ <author> Julian Gilbey </author>
+ <author> Russ Allbery </author>
+ <author> Manoj Srivastava <email/srivasta@debian.org/
+
+<chapt> About the checklist
+<p>
+The checklist below has been created to simplify the upgrading process
+of old packages. Note that this list is not "official"; it simply
+gives an indication of what has changed and whether you are likely to
+need to make changes to your package in light of this. If you have
+doubts about a certain topic, if you need more details, or if you
+think some other package does not comply with policy, please refer to
+the Policy Manual itself. All of the changes from version 3.0.0
+onwards indicate which section of the Policy Manual discusses the
+issue: [3.4] means section 3.4. The section numbering changed when
+the packaging manual was incorporated into policy; the section numbers
+used below refer to the current version.
+<p>
+Here is how the check list works: Check which policy version your
+package was checked against last (indicated in the "Standards-Version"
+field of the source package). Then move upwards until the top and
+check which of the items on the list might concern your package. Note
+which sections of policy discuss this, and then check out the Policy
+Manual for details. If you are upgrading from Policy version < 2.5.0,
+it may be easier to check through the whole of policy instead of
+picking your way through this list.
+
+<chapt> The checklist
+
+<sect> Version 3.8.4.0
+<p>
+
+Release Jan 2010.
+
+</p><p><taglist>
+<tag>9.1.1</tag>
+ <item> An FHS exception has been granted for multiarch libraries.
+ Permitting files to instead be installed to <file>/lib/triplet</file> and
+ <file>/usr/lib/triplet</file> directories.
+ </item>
+<tag>10.6</tag>
+ <item>Explicitly state that packages may not contain named pipes and
+ should instead create them in postinst and remove them in prerm or postrm.
+ </item>
+<tag>9.1.1</tag>
+ <item><file>/sys</file> and <file>/selinux</file> directories are explicitly
+ allowed as an exception to the FHS.
+ </item>
+</taglist></p>
+
+<sect> Version 3.8.3.0
+<p>
+Released Aug 2009.
+
+</p><p><taglist>
+<tag>4.9</tag>
+ <item>Add DEB_*_ARCH_CPU and DEB_*_ARCH_OS variables and
+ recommend them over GNU-style variables for that information.
+ </item>
+<tag>5.6.8</tag>
+ <item>Source package Architecture fields may contain <em/all/ in
+ combination with other architectures. Clarify when <em/all/ and <em/any/
+ may be used in different versions of the field.
+ </item>
+<tag>5.6.14</tag>
+ <item>The Debian archive software does not support uploading
+ to multiple distributions with one <file>*.changes</file> file.
+ </item>
+<tag>5.6.19</tag>
+ <item>The Binary field may span multiple lines.
+ </item>
+<tag>10.2</tag>
+ <item>Remove the permission for shared library packages to
+ install libraries in a non-standard location and modify <file/ld.so.conf/.
+ Packages should either be installed in a standard library directory
+ or packages using them should be built with RPATH.
+ </item>
+<tag>11.8.7</tag>
+ <item>Clarify installation directories for X programs and
+ remove the requirement to pre-depend on x11-common before installing
+ into <file>/usr/include/X11</file> and <file>/usr/lib/X11</file>.
+ </item>
+<tag>12.1</tag>
+ <item>Remove the requirement that all characters in a manual
+ page be representable in the legacy encoding for that language.
+ </item>
+<tag>12.1</tag>
+ <item>Localized man pages should either be kept up-to-date with
+ the original version or warn that they're not up-to-date, either
+ with warning text or by showing missing or changed portions in the
+ original language.
+ </item>
+<tag>12.2</tag>
+ <item>install-info is now handled via triggers so packages no
+ longer need to invoke it in maintainer scripts. Info documents
+ should now have directory sections and entries in the document.
+ Packages containing info documents should add a dependency to
+ support partial upgrades.
+ </item>
+<tag>perl</tag>
+ <item>The requirement for Perl modules to have a versioned
+ Depend and Build-Depend on <tt>perl >= 5.6.0-16</tt> has been removed.
+ </item>
+</taglist></p>
+
+<sect> Version 3.8.2.0
+<p>
+
+Released Jun 2009.
+
+</p><p><taglist>
+<tag>2.4</tag>
+ <item>The list of archive sections has been significantly expanded. See
+ <url id="http://lists.debian.org/debian-devel-announce/2009/03/msg00010.html"
+ name="this debian-devel-announce message">
+ for the list of new sections and rules for how to categorize
+ packages.
+ </item>
+<tag>3.9.1</tag>
+ <item>All packages must use debconf or equivalent for user prompting,
+ though essential packages or their dependencies may also fall
+ back on other methods.
+ </item>
+<tag>5.6.1</tag>
+ <item>The requirements for source package names are now explicitly
+ spelled out.
+ </item>
+<tag>9.1</tag>
+ <item>Legacy XFree86 servers no longer get a special exception from the
+ FHS permitting <file>/etc/X11/XF86Config-4</file>.
+ </item>
+<tag>9.1.3</tag>
+ <item>Removed obsolete dependency requirements for packages that use
+ <file>/var/mail</file>.
+ </item>
+<tag>11.8.5</tag>
+ <item>Speedo fonts are now deprecated. The X backend was disabled
+ starting in lenny.
+ </item>
+<tag>12.5</tag>
+ <item>The GNU Free Documentation License version 1.3 is included in
+ common-licenses and should be referenced from there.
+ </item>
+</taglist></p>
+
+<sect> Version 3.8.1.0
+<p>
+
+Released Mar 2009.
+
+</p><p><taglist>
+<tag>3.8</tag>
+ <item>Care should be taken when adding functionality to essential and
+ such additions create an obligation to support that functionality
+ in essential forever unless significant work is done.
+ </item>
+<tag>4.4</tag>
+ <item>Changelog files must be encoded in UTF-8.
+ </item>
+<tag>4.4</tag>
+ <item>Tighten some format requirements for changelog files from a should
+ to a must.
+ </item>
+<tag>4.4.1</tag>
+ <item>Remove alternative changelog formats. Debian only supports one
+ changelog format for the Debian Archive.
+ </item>
+<tag>4.9.1</tag>
+ <item>New nocheck option for DEB_BUILD_OPTIONS indicating any build-time
+ test suite provided by the package should not be run.
+ </item>
+<tag>5.1</tag>
+ <item>All control files must be encoded in UTF-8.
+ </item>
+<tag>5.2</tag>
+ <item>debian/control allows comment lines starting with # with no
+ preceding whitespace.
+ </item>
+<tag>9.3</tag>
+ <item>Init scripts ending in .sh are not handled specially. They are not
+ sourced and are not guaranteed to be run by <prgn>/bin/sh</prgn> regardless
+ of the #! line. This brings Policy in line with the long-standing
+ behavior of the init system in Debian.
+ </item>
+<tag>9.3.2</tag>
+ <item>The start action of an init script must exit successfully and not
+ start the daemon again if it's already running.
+ </item>
+<tag>9.3.2</tag>
+ <item><file>/var/run</file> and <file>/var/lock</file> may be mounted as
+ temporary filesystems, and init scripts must therefore create any necessary
+ subdirectories dynamically.
+ </item>
+<tag>10.4</tag>
+ <item> <file>/bin/sh</file> scripts may assume that local can take multiple
+ variable arguments and supports assignment.
+ </item>
+<tag>11.6</tag>
+ <item>User mailboxes may be mode 600 and owned by the user rather than
+ mode 660, owned by user, and group mail.
+ </item>
+</taglist></p>
+
+<sect> Version 3.8.0.0
+<p>
+
+Released Jun 2008.
+
+</p><p><taglist>
+<tag>2.4, 3.7</tag>
+<item>The base section has been removed. contrib and non-free have been
+ removed from the section list; they are only categories. The base
+ system is now defined by priority.
+<tag>4.9</tag>
+<item>If <prgn>dpkg-source -x</prgn> doesn't provide the source that will be
+ compiled, a debian/rules patch target is recommended and should do whatever
+ else is necessary.
+<tag>4.9.1, 10.1</tag>
+<item>Standardized the format of DEB_BUILD_OPTIONS. Specified permitted
+ characters for tags, required that tags be whitespace-separated,
+ allowed packages to assume non-conflicting tags, and required
+ unknown flags be ignored.
+<tag>4.9.1</tag>
+<item>Added parallel=n to the standardized DEB_BUILD_OPTIONS tags,
+ indicating that a package should be built using up to n parallel
+ processes if the package supports it
+<tag>4.13</tag>
+<item>Debian packages should not use convenience copies of code from other
+ packages unless the included package is explicitly intended to be
+ used that way.
+<tag>4.14</tag>
+<item>If dpkg-source -x doesn't produce source ready for editing and
+ building with dpkg-buildpackage, packages should include a
+ <file>debian/README.source</file> file explaining how to generate
+ the patched source, add a new modification, and remove an existing
+ modification. This file may also be used to document packaging a
+ new upstream release and any other complexity of the Debian build
+ process.
+<tag>5.6.3</tag>
+<item>The Uploaders field in debian/control may be wrapped.
+<tag>5.6.12</tag>
+<item>An empty Debian revision is equivalent to a Debian revision of 0 in
+ a version number.
+<tag>5.6.23</tag>
+<item>New Homepage field for upstream web sites.
+<tag>6.5, 6.6, 7</tag>
+<item>The Breaks field declares that this package breaks another and
+ prevents installation of the breaking package unless the package
+ named in Breaks is deconfigured first. This field should not be
+ used until the dpkg in Debian stable supports it.
+<tag>8.1, 8.2</tag>
+<item>Clarify which files should go into a shared library package, into a
+ separate package, or into the -dev package. Suggest -tools instead
+ of -runtime for runtime support programs, since that naming is more
+ common in Debian.
+<tag>9.5</tag>
+<item>Files in <file>/etc/cron.{hourly,daily,weekly,monthly}</file> must be
+ configuration files (upgraded from should). Mention the hourly
+ directory.
+<tag>11.8.6</tag>
+<item>Packages providing <file>/etc/X11/Xresources</file> files need not
+ conflict with <tt> xbase (<< 3.3.2.3a-2)</tt>, which is
+ long-obsolete.
+<tag>12.1</tag>
+<item>Manual pages in locale-specific directories should use either the
+ legacy encoding for that directory or UTF-8. Country names should
+ not be included in locale-specific manual page directories unless
+ indicating a significant difference in the language. All
+ characters in the manual page source should be representable in the
+ legacy encoding for a locale even if the man page is encoded in
+ UTF-8.
+<tag>12.5</tag>
+<item>The Apache 2.0 license is now in common-licenses and should be
+ referenced rather than quoted in <file>debian/copyright</file>.
+<tag>12.5</tag>
+<item>Packages in contrib and non-free should state in the copyright file
+ that the package is not part of Debian GNU/Linux and briefly
+ explain why.
+<tag>debconf</tag>
+<item>Underscore (_) is allowed in debconf template names.
+</taglist></p>
+
+<sect> Version 3.7.3.0
+<p>
+
+Released Dec 2007.
+
+</p><p><taglist>
+<tag>5.6.12</tag>
+<item>Package version numbers may contain tildes, which sort before
+ anything, even the end of a part.
+<tag>10.4</tag>
+<item>Scripts may assume that <file>/bin/sh</file> supports local (at a basic
+ level) and that its test builtin (if any) supports -a and -o binary
+ logical operators.
+<tag>8.5</tag>
+<item>The substitution variable ${binary:Version} should be used in place
+ of ${Source-Version} for dependencies between packages of the same
+ library.
+<tag>menu policy</tag>
+<item>Substantial reorganization and renaming of sections in the Debian
+ menu structure. Packages with menu entries should be reviewed to
+ see if the menu section has been renamed or if one of the new
+ sections would be more appropriate.
+<tag>5.6.1</tag>
+<item>The Source field in a .changes file may contain a version number
+ in parentheses.
+<tag>5.6.17</tag>
+<item>The acceptable values for the Urgency field are low, medium, high,
+ critical, or emergency.
+<tag>8.6</tag>
+<item>The shlibs file now allows an optional type field, indicating the
+ type of package for which the line is valid. The only currently
+ supported type is udeb, used with packages for the Debian
+ Installer.
+<tag>3.9.1</tag>
+<item>Packages following the Debian Configuration management
+ specification must allow for translation of their messages by using
+ a gettext-based system such as po-debconf.
+<tag>12.5</tag>
+<item>GFDL 1.2, GPL 3, and LGPL 3 are now in common-licenses and should
+ be referenced rather than quoted in debian/copyright.
+</taglist></p>
+
+<sect> Version 3.7.2.2
+<p>
+
+Released Oct 2006.
+
+</p><p><taglist>
+<tag>6.1</tag> <item>Maintainer scripts must not be world writeable (up from a
+ should to a must)</item>
+</taglist></p>
+
+<sect> Version 3.7.2.0
+<p>
+
+Released Apr 2006.
+
+</p><p><taglist>
+<tag>11.5</tag> <item>Revert the cgi-lib change. </item>
+</taglist></p>
+
+<sect> Version 3.7.1.0
+<p>
+
+Released Apr 2006.
+
+</p><p><taglist>
+<tag>10.2</tag>
+<item>It is now possible to create shared libraries without
+ relocatable code (using -fPIC) in certain exceptional cases,
+ provided some procedures are followed, and for creating static
+ libraries with relocatable code (again, using -fPIC).
+ Discussion on debian-devel@lists.debian.org, getting a rough
+ consensus, and documenting it in README.Debian constitute most
+ of the process.
+<tag>11.8.7</tag>
+<item>Packages should install any relevant files into the directories
+ <file>/usr/include/X11/</file> and <file>/usr/lib/X11/</file>, but if
+ they do so, they must pre-depend on <tt>x11-common (>= 1:7.0.0)</tt>
+</taglist></p>
+
+<sect> Version 3.7.0.0
+<p>
+
+Released Apr 2006.
+
+</p><p><taglist>
+<tag>11.5</tag>
+<item>Packages shipping web server CGI files are expected to install
+ them in <file>/usr/lib/cgi-lib/</file> directories. This location change
+ perhaps should be documented in NEWS
+<tag>11.5</tag>
+<item>Web server packages should include a standard scriptAlias of
+ cgi-lib to <file>/usr/lib/cgi-lib</file>.
+<tag>9.1.1</tag>
+<item>The version of FHS mandated by policy has been upped to
+ 2.3. There should be no changes required for most packages,
+ though new top level directories <file>/media</file>, <file>/srv</file>,
+ etc. may be of interest.
+<tag>5.1, 5.6.3</tag>
+<item>All fields, apart from the Uploaders field, in the control file
+ are supposed to be a single logical line, which may be spread
+ over multiple physical lines (newline followed by space is
+ elided). However, any parser for the control file must allow
+ the Uploaders field to be spread over multiple physical lines
+ as well, to prepare for future changes.
+<tag>10.4</tag>
+<item>When scripts are installed into a directory in the system
+ PATH, the script name should not include an extension that
+ denotes the scripting language currently used to implement it.
+
+<tag>9.3.3.2</tag>
+<item>packages that invoke initscripts now must use invoke-rc.d to do
+ so since it also pays attention to run levels and other local
+ constraints.
+<tag>11.8.5.2, 11.8.7, etc</tag>
+<item>We no longer use <file>/usr/X11R6</file>, since we have
+ migrated away to using Xorg paths. This means, for one thing, fonts
+ live in <file>/usr/share/fonts/X11/</file> now, and <file>/usr/X11R6</file>
+ is gone.
+</taglist></p>
+
+<sect> Version 3.6.2.0
+<p>
+
+Released 2005
+
+</p><p><taglist>
+<tag></tag>
+<item>Recommend. doc-base, and not menu, for registering package documentation.
+</item>
+<tag>8.1</tag>
+<item>Run time support programs should live in subdirectories of
+ <file>/usr/lib/</file> or <file>/usr/share</file>, and preferably the shared
+ lib is named the same as the package name (to avoid name collisions).
+</item>
+<tag>11.5</tag>
+<item>It is recommended that HTTP servers provide an alias /images to
+ allow packages to share image files with the web server
+</item>
+</taglist></p>
+
+<sect> Version 3.6.1.0
+<p>
+
+Released Aug 2003.
+
+</p><p><taglist>
+<tag>3.10.1</tag>
+<item>Prompting the user should be done using debconf. Non debconf
+ user prompts are now deprecated.
+</taglist></p>
+
+<sect> Version 3.6.0
+<p>
+
+Released Jul 2003.
+
+</p><p><taglist>
+<tag></tag>
+<item>Restructuring causing shifts in section numbers and bumping of
+ the minor version number:
+<tag></tag>
+<item>Many packaging manual appendices that were integrated into policy
+ sections are now empty, and replaced with links to the Policy.
+ In particular, the appendices that included the list of control
+ fields were updated (new fields like Closes, Changed-By were added)
+ and the list of fields for each of control, .changes and .dsc files
+ is now in Policy, and they're marked mandatory, recommended or
+ optional based on the current practice and the behavior of the
+ deb-building tool-chain.
+<tag></tag>
+<item>Elimination of needlessly deep section levels, primarily in the
+ chapter Debian Archive, from which two new chapters were split out,
+ Binary packages and Source packages. What remained was reordered
+ properly, that is, some sects became sects etc.
+<tag></tag>
+<item>Several sections that were redundant, crufty or simply not designed
+ with any sort of vision, were rearranged according to the formula that
+ everything should be either in the same place or properly interlinked.
+ Some things remained split up between different chapters when they
+ talked about different aspects of files: their content, their syntax,
+ and their placement in the file system. In particular, see the new
+ sections about changelog files.
+<tag>menu policy</tag>
+<item>Added Games/Simulation and Apps/Education to menu
+ sub-policy
+<tag>C.2.2</tag>
+<item>Debian changelogs should be UTF-8 encoded.
+<tag>10.2</tag>
+<item>shared libraries must be linked against all libraries that they
+ use symbols from in the same way that binaries are.
+<tag>7.6</tag>
+<item>build-depends-indep need not be satisfied during clean
+ target.
+</taglist></p>
+
+<sect> Version 3.5.10
+<p>
+
+Released May 2003.
+
+</p><p><taglist>
+<tag>11.8.3</tag>
+<item>packages providing the x-terminal-emulator virtual package
+ ought to ensure that they interpret the command line exactly
+ like xterm does.
+<tag>11.8.4</tag>
+<item>Window managers compliant with the Window Manager Specification
+ Project may add 40 points for ranking in the alternatives
+</taglist></p>
+
+<sect> Version 3.5.9.0
+<p>
+
+Released Mar 2003.
+
+</p><p><taglist>
+<tag>3.4.2</tag>
+<item>The section describing the Description: package field once again has
+ full details of the long description format.
+<tag>4.2</tag>
+<item>Clarified that if a package has non-build-essential
+ build-dependencies, it should have them listed in the Build-Depends
+ and related fields (i.e. it's not merely optional).
+<tag>9.3.2</tag>
+<item>When asked to restart a service that isn't already running,
+ the init script should start the service.
+<tag>12.6</tag>
+<item>If the purpose of a package is to provide examples, then the
+ example files can be installed into <file>/usr/share/doc/package</file>
+ (rather than <file>/usr/share/doc/package/examples</file>).
+</taglist></p>
+
+<sect> Version 3.5.8.0
+<p>
+
+Released Nov 2002.
+
+</p><p><taglist>
+<tag>12.7</tag>
+<item>It is no longer necessary to keep a log of changes to the upstream
+ sources in the copyright file. Instead, all such changes should be
+ documented in the changelog file.
+<tag>7.6</tag>
+<item><var/Build-Depends/, <var/Build-Conflicts/, <var/Build-Depends-Indep/,
+ and <var/Build-Conflicts-Indep/ must also be satisfied when the clean
+ target is called.
+<tag>menu policy</tag>
+<item>A new Apps/Science menu section is available
+<tag>debconf policy</tag>
+<item>debconf specification cleared up, various changes.
+<tag>12.1</tag>
+<item>It is no longer recommended to create symlinks from nonexistent
+ manual pages to undocumented(7). Missing manual pages for programs
+ are still a bug.
+</taglist></p>
+
+<sect> Version 3.5.7.0
+<p>
+
+Released Aug 2002.
+
+</p><p><taglist>
+<tag></tag>
+<item>Packages no longer have to ask permission to call MAKEDEV in
+ postinst, merely notifying the user ought to be enough.
+<tag>2.2.4</tag>
+<item>cryptographic software may now be included in the main
+ archive.
+<tag>3.9</tag>
+<item>task packages are no longer permitted; tasks are now created by a
+ special Tasks: field in the control file.
+<tag>11.8.4</tag>
+<item>window managers that support netwm can now add 20 points when
+ they add themselves as an alternative for
+ <file>/usr/bin/x-window-manager</file>
+<tag>10.1</tag>
+<item>The default compilation options have now changed, one should
+ provide debugging symbols in all cases, and optionally step
+ back optimization to -O0, depending on the DEB_BUILD_OPTIONS
+ environment variable.
+<tag>7.6, 4.8</tag>
+<item>Added mention of build-arch, build-indep, etc, in describing
+ the relationships with `Build-Depends', `Build-Conflicts',
+ `Build-Depends-Indep', and `Build-Conflicts-Indep'. May need to
+ review the new rules.
+<tag>8</tag>
+<item>Changed rules on how, and when, to invoke ldconfig in maintainer
+ scripts. Long rationale.
+</taglist></p>
+
+<p><em>
+Added the last note in 3.5.6 upgrading checklist item regarding build
+rules, please see below
+</em></p>
+
+<sect> Version 3.5.6.0
+<p>
+
+Released Jul 2001.
+
+</p><p><taglist>
+<tag>2.5</tag>
+<item>Emacs and TeX are no longer mandated by policy to be priority
+ standard packages
+<tag>11.5</tag>
+<item>Programs that access docs need to do so via <file>/usr/share/doc</file>,
+ and not via <file>/usr/doc/</file> as was the policy previously
+<tag>12.3</tag>
+<item>Putting documentation in <file>/usr/doc</file> versus
+ <file>/usr/share/doc</file> is now a ``serious'' policy violation.
+<tag>11.5</tag>
+<item>For web servers, one should not provide non-local access to the
+ <file>/usr/share/doc</file> hierarchy. If one can't provide access
+ controls for the http://localhost/doc/ directory, then it is preferred
+ that one ask permission to expose that information during the install.
+<tag>7</tag>
+<item>There are new rules for build-indep/build-arch targets and
+ there is a new Build-Depend-Indep semantic.
+</taglist></p>
+
+<sect> Version 3.5.5.0
+<p>
+
+Released May 2001.
+
+</p><p><taglist>
+<tag>12.1</tag>
+<item>Manpages should not rely on header information to have
+ alternative manpage names available; it should only use
+ symlinks or .so pages to do this
+</item>
+<tag></tag>
+<item><em> Clarified note in 3.5.3.0 upgrading checklist regarding
+ examples and templates: this refers only to those examples used
+ by scripts; see section 10.7.3 for the whole story</em>
+</item>
+<tag></tag>
+<item>Included a new section 10.9.1 describing the use of
+ dpkg-statoverride; this does not have the weight of policy
+</item>
+<tag></tag>
+<item>Clarify Standards-Version: you don't need to rebuild your
+ packages just to change the Standards-Version!
+</item>
+<tag>10.2</tag>
+<item>Plugins are no longer bound by all the rules of shared
+ libraries
+</item>
+<tag>X Windows related things:</tag>
+<item><taglist>
+ <tag>11.8.1</tag>
+ <item>Clarification of priority levels of X Window System related
+ packages
+ </item>
+ <tag>11.8.3</tag>
+ <item>Rules for defining x-terminal-emulator improved </item>
+ <tag>11.8.5</tag>
+ <item>X Font policy rewritten: you must read this if you provide
+ fonts for the X Window System
+ </item>
+ <tag>11.8.6</tag>
+ <item>Packages must not ship <file>/usr/X11R6/lib/X11/app-defaults/</file>
+ </item>
+ <tag>11.8.7</tag>
+ <item>X-related packages should usually use the regular FHS
+ locations; imake-using packages are exempted from this
+ </item>
+ <tag>11.8.8</tag>
+ <item>OpenMotif linked binaries have the same rules as
+ OSF/Motif-linked ones
+ </item>
+ </taglist></item>
+</taglist></p>
+
+<sect> Version 3.5.4.0
+<p> Released Apr 2001.
+
+</p><p><taglist>
+<tag>11.6</tag>
+<item>The system-wide mail directory is now /var/mail, no longer
+ /var/spool/mail. Any packages accessing the mail spool should
+ access it via /var/mail and include a suitable Depends field;
+ details in
+</item>
+<tag>11.9; perl-policy</tag>
+<item>The perl policy is now part of Debian policy
+ proper. Perl programs and modules should follow the current Perl
+ policy
+</item>
+</taglist></p>
+
+<sect> Version 3.5.3.0
+<p> Released Apr 2001
+
+</p><p><taglist>
+<tag>7.1</tag>
+<item>Build-Depends arch syntax has been changed to be less
+ ambiguous. This should not affect any current packages
+</item>
+<tag>10.7.3</tag>
+<item>Examples and templates files for use by scripts should now live
+ in <file>/usr/share/<package></file> or
+ <file>/usr/lib/<package></file>, with symbolic links from
+ <file>/usr/share/doc/<package>/examples</file> as needed
+</item>
+</taglist></p>
+
+<sect> Version 3.5.2.0
+
+<p> Released Feb 2001.
+
+</p><p><taglist>
+<tag>11.8.6</tag>
+<item>X app-defaults directory has moved from
+ <file>/usr/X11R6/lib/X11/app-defaults</file> to
+ <file>/etc/X11/app-defaults</file>
+</item>
+</taglist></p>
+
+<sect> Version 3.5.1.0
+
+<p> Released Feb 2001.
+
+</p><p><taglist>
+<tag>8.1</tag>
+<item>dpkg-shlibdeps now uses objdump, so shared libraries have to be
+ run through dpkg-shlibdeps as well as executables
+</item>
+</taglist></p>
+
+<sect> Version 3.5.0.0
+
+<p> Released Jan 2001.
+
+</p><p><taglist>
+<tag>11.8.5</tag>
+<item>Font packages for the X Window System must now declare a
+ dependency on xutils (>= 4.0.2)
+</item>
+</taglist></p>
+
+<sect> Version 3.2.1.1
+
+<p> Released Jan 2001.
+
+</p><p><taglist>
+<tag>9.3.2</tag>
+<item>Daemon startup scripts in <file>/etc/init.d/</file> should not contain
+ modifiable parameters; these should be moved to a file in
+ <file>/etc/default/</file>
+</item>
+<tag>12.3</tag>
+<item>Files in <file>/usr/share/doc</file> must not be referenced by any
+ program. If such files are needed, they must be placed in
+ <file>/usr/share/<package>/</file>, and symbolic links
+ created as required in <file>/usr/share/doc/<package>/</file>
+</item>
+<tag></tag>
+<item>Much of the packaging manual has now been imported into the
+ policy document
+</item>
+</taglist></p>
+
+<sect> Version 3.2.1.0
+
+<p> Released Aug 00.
+
+</p><p><taglist>
+<tag>11.8.1</tag>
+<item>A package of priority standard or higher may provide two
+ binaries, one compiled with support for the X Window System,
+ and the other without
+</item>
+</taglist></p>
+
+<sect> Version 3.2.0.0
+
+<p> Released Aug 00.
+
+</p><p><taglist>
+<tag>10.1</tag>
+<item>By default executables should not be built with the debugging
+ option -g. Instead, it is recommended to support building the
+ package with debugging information optionally. Details in
+</item>
+<tag>12.8</tag>
+<item>Policy for packages where the upstream uses HTML changelog
+ files has been expanded. In short, a plain text changelog file
+ should always be generated for the upstream changes
+</item>
+<tag></tag>
+<item>Please note that the new release of the X window system (3.2)
+ shall probably need sweeping changes in policy
+</item>
+<tag></tag>
+<item>Policy for packages providing the following X-based features
+ has been codified:
+ <taglist>
+ <tag>11.8.2</tag>
+ <item>X server (virtual package xserver) </item>
+ <tag>11.8.3</tag>
+ <item>X terminal emulator (virtual package x-terminal-emulator) </item>
+ <tag>11.8.4</tag>
+ <item>X window manager (virtual package x-window-manager, and
+ <file>/usr/bin/x-window-manager</file> alternative, with priority
+ calculation guidelines)
+ </item>
+ <tag>12.8.5</tag>
+ <item>X fonts (this section has been written from scratch) </item>
+ <tag>11.8.6</tag>
+ <item>X application defaults </item>
+ </taglist>
+</item>
+<tag>11.8.7</tag>
+<item>Policy for packages using the X Window System and FHS issues
+ has been clarified;
+</item>
+<tag>11.7.3</tag>
+<item>No package may contain or make hard links to conffiles </item>
+<tag>8</tag>
+<item>Noted that newer dpkg versions do not require extreme care in
+ always creating the shared lib before the symlink, so the unpack
+ order be correct
+</item>
+</taglist></p>
+
+<sect> Version 3.1.1.0
+
+<p> Released Nov 1999.
+
+</p><p><taglist>
+<tag>7.1</tag>
+<item>Correction to semantics of architecture lists in Build-Depends
+ etc. Should not affect many packages
+</item>
+</taglist></p>
+
+<sect> Version 3.1.0.0
+
+<p> Released Oct 1999.
+
+</p><p><taglist>
+<tag>defunct</tag>
+<item><file>/usr/doc/<package></file> has to be a symlink pointing to
+ <file>/usr/share/doc/<package></file>, to be maintained by postinst
+ and prerm scripts.
+</item>
+<tag>7.1, 7.6</tag>
+<item>Introduced source dependencies (Build-Depends, etc.) </item>
+<tag>9.3.4</tag>
+<item><file>/etc/rc.boot</file> has been deprecated in favour of
+ <file>/etc/rcS.d</file>. (Packages should not be touching this directory,
+ but should use update-rc.d instead)
+</item>
+<tag>9.3.3</tag>
+<item>update-rc.d is now the <em>only</em> allowable way of accessing the
+ <file>/etc/rc?.d/[SK]??*</file> links. Any scripts which manipulate them
+ directly must be changed to use update-rc.d instead. (This is
+ because the file-rc package handles this information in an
+ incompatible way.)
+</item>
+<tag>12.7</tag>
+<item>Architecture-specific examples go in
+ <file>/usr/lib/<package>/examples</file>
+ with symlinks from <file>/usr/share/doc/<package>/examples/*</file>
+ or from <file>/usr/share/doc/<package>/examples</file> itself
+</item>
+<tag>9.1.1</tag>
+<item>Updated FHS to a 2.1 draft; this reverts <file>/var/state</file> to
+ <file>/var/lib</file>
+</item>
+<tag>9.7; mime-policy</tag>
+<item>Added MIME sub-policy document </item>
+<tag>12.4</tag>
+<item>VISUAL is allowed as a (higher priority) alternative to EDITOR
+</item>
+<tag>11.6</tag>
+<item>Modified liblockfile description, which affects
+ mailbox-accessing programs. Please see the policy document for
+ details
+</item>
+<tag>12.7</tag>
+<item>If a package provides a changelog in HTML format, a text-only
+ version should also be included. (Such a version may be prepared
+ using <prgn>lynx -dump -nolist</prgn>.)
+</item>
+<tag>3.2.1</tag>
+<item>Description of how to handle version numbers based on dates
+ added
+</item>
+</taglist></p>
+
+<sect> Version 3.0.1.0
+
+<p> Released Jul 1999.
+
+</p><p><taglist>
+<tag>10.2</tag>
+<item>Added the clarification that the .la files are essential for
+ the packages using libtool's libltdl library, in which case the .la
+ files must go in the run-time library package
+</item>
+</taglist></p>
+
+<sect> Version 3.0.0.0
+
+<p> Released Jun 1999.
+
+</p><p><taglist>
+<tag>9.1</tag>
+<item>Debian formally moves from the FSSTND to the FHS. This is a
+ major change, and the implications of this move are probably
+ not all known.
+</item>
+<tag>4.1</tag>
+<item>Only 3 digits of the Standards version need be included in
+ control files, though all four digits are still permitted.
+</item>
+<tag>12.6</tag>
+<item>The location of the GPL has changed to
+ <file>/usr/share/common-licenses</file>. This may require changing the
+ copyright files to point to the correct location of the GPL and
+ other major licenses
+</item>
+<tag>10.2</tag>
+<item>Packages that use libtool to create shared libraries must
+ include the .la files in the -dev packages
+</item>
+<tag>10.8</tag>
+<item>Use logrotate to rotate log files
+</item>
+<tag>now 11.8</tag>
+<item>section 5.8 has been rewritten (Programs for the X Window
+ System)
+</item>
+<tag>9.6; menu-policy</tag>
+<item>There is now an associated menu policy, in a separate document,
+ that carries the full weight of Debian policy
+</item>
+<tag>11.3</tag>
+<item>Programs which need to modify the files <file>/var/run/utmp</file>,
+ <file>/var/log/wtmp</file> and <file>/var/log/lastlog</file> must be
+ installed setgid utmp
+</item>
+</taglist></p>
+<p><em>
+ Please note that section numbers below this point may not be up to date
+</em></p>
+
+<sect> Version 2.5.0.0
+
+<p> Released Oct 1998.
+
+Policy Manual:
+</p><p><list>
+<item>Rearranged the manual to create a new Section 4, Files
+ <list>
+ <item>Section 3.3 ("Files") was moved to Section 4. The Sections
+ that were Section 4 and Section 5 were moved down to become
+ Section 5 and Section 6.
+ </item>
+ <item>What was Section 5.5 ("Log files") is now a subsection of the
+ new Section 4 ("Files"), becoming section 4.8, placed after
+ "Configuration files", moving the Section 4.8 ("Permissions
+ and owners") to Section 4.9. All subsections of the old
+ Section 5 after 5.5 were moved down to fill in the number
+ gap.
+ </item>
+ </list></item>
+<item>Modified the section about changelog files to accommodate
+ upstream changelogs which were formatted as HTML. These
+ upstream changelog files should now be accessible as
+ <file>/usr/doc/package/changelog.html.gz</file>
+</item>
+<item>Symlinks are permissible to link the real, or upstream,
+ changelog name to the Debian mandated name.
+</item>
+<item>Clarified that HTML documentation should be present in some
+ package, though not necessarily the main binary package.
+ </item>
+<item>Corrected all references to the location of the copyright
+ files. The correct location is <file>/usr/doc/package/copyright</file>
+ </item>
+<item>Ratified the architecture specification strings to cater to the
+ HURD.
+ </item>
+</list></p>
+
+<sect> Version 2.4.1.0
+
+<p> Released Apr 1998.
+</p>
+<sect1> Policy Manual:
+<p><taglist>
+<tag>Updated section 3.3.5 Symbolic links:</tag>
+ <item>symbolic links within a toplevel directory should be relative,
+ symbolic links between toplevel directories should be absolute
+ (cf., Policy Weekly Issue#6, topic 2)
+ </item>
+
+<tag>Updated section 4.9 Games:</tag>
+ <item>manpages for games should be installed in <file>/usr/man/man6</file>
+ (cf., Policy Weekly Issue#6, topic 3)
+ </item>
+</taglist></p>
+
+<sect1> Packaging Manual:
+<p><list>
+<item>Updated prefix of chapter 12, Shared Libraries:
+ ldconfig must be called in the postinst script if the package
+ installs shared libraries
+ (cf., Policy Weekly Issue #6, fixes:bug#20515)
+</item>
+</list></p>
+
+<sect> Version 2.4.0.0
+
+<p> Released Jan 1998
+
+</p><p><taglist>
+<tag>Updated section 3.3.4 Scripts:</tag>
+ <item><list>
+ <item>/bin/sh may be any POSIX compatible shell
+ <item>scripts including bashisms have to specify <file>/bin/bash</file>
+ as interpreter
+ <item>scripts which create files in world-writable directories
+ (e.g., in <file>/tmp</file>) should use tempfile or mktemp for creating
+ the directory
+ </list></item>
+
+<tag>Updated section 3.3.5 Symbolic Links:</tag>
+ <item>symbolic links referencing compressed files must have the same
+ file extension as the referenced file
+ </item>
+
+<tag>Updated section 3.3.6 Device files:</tag>
+ <item><file>/dev/tty*</file> serial devices should be used instead of
+ <file>/dev/cu*</file>
+ </item>
+
+<tag>Updated section 3.4.2 Writing the scripts in <file>/etc/init.d</file>:
+ <item><list>
+ <item>all <file>/etc/init.d</file> scripts have to provide the following
+ options: start, stop, restart, force-reload
+ <item>the reload option is optional and must never stop and restart
+ the service
+ </list></item>
+
+<tag>Updated section 3.5 Cron jobs:
+ <item>cron jobs that need to be executed more often than daily should
+ be installed into <file>/etc/cron.d</file>
+ </item>
+
+<tag>Updated section 3.7 Menus:
+ <item>removed section about how to register HTML docs to `menu'
+ (the corresponding section in 4.4, Web servers and applications,
+ has been removed in policy 2.2.0.0 already, so this one was
+ obsolete)
+ </item>
+
+<tag>New section 3.8 Keyboard configuration:
+ <item>details about how the backspace and delete keys should be
+ handled
+ </item>
+
+<tag>New section 3.9 Environment variables:
+ <item>no program must depend on environment variables to get a
+ reasonable default configuration
+ </item>
+
+<tag>New section 4.6 News system configuration:
+ <item><file>/etc/news/organization</file> and <file>/etc/news/server</file>
+ should be supported by all news servers and clients
+ </item>
+
+<tag>Updated section 4.7 Programs for the X Window System:
+ <item><list>
+ <item>programs requiring a non-free Motif library should be provided
+ as foo-smotif and foo-dmotif package
+ </item>
+ <item>if lesstif works reliably for such program, it should be linked
+ against lesstif and not against a non-free Motif library
+ </item>
+ </list></item>
+
+<tag>Updated section 4.9 Games:
+ <item>games for X Windows have to be installed in <file>/usr/games</file>,
+ just as non-X games
+ </item>
+</taglist></p>
+
+<sect> Version 2.3.0.1, 2.3.0.0
+
+<p> Released Sep 1997.
+
+<p><list>
+<item>new section `4.2 Daemons' including rules for
+ <file>/etc/services</file>, <file>/etc/protocols</file>,
+ <file>/etc/rpc</file>, and <file>/etc/inetd.conf</file>
+</item>
+
+<item>updated section about `Configuration files':
+ packages may not touch other packages' configuration files
+</item>
+
+<item>MUAs and MTAs have to use liblockfile</item>
+</list></p>
+
+<sect> Version 2.2.0.0
+
+<p> Released July 1997.
+
+<p><list>
+<item>added section 4.1 `Architecture specification strings':
+ use
+ <arch>-linux
+ where <arch> is one of the following:
+ i386, alpha, arm, m68k, powerpc, sparc.
+</item>
+
+<item>detailed rules for <file>/usr/local</file></item>
+
+<item>user ID's</item>
+
+<item>editor/pager policy</item>
+
+<item>cron jobs</item>
+
+<item>device files</item>
+
+<item>don't install shared libraries as executable</item>
+
+<item>app-defaults files may not be conffiles</item>
+</list></p>
+
+<sect> Version 2.1.3.2, 2.1.3.1, 2.1.3.0
+
+<p> Released Mar 1997.
+
+<p><list>
+<item>two programs with different functionality must not have the
+ same name </item>
+
+<item>"Webstandard 3.0"</item>
+
+<item>"Standard for Console Messages"</item>
+
+<item>Libraries should be compiled with `-D_REENTRANT'</item>
+
+<item>Libraries should be stripped with <prgn>strip --strip-unneeded</prgn>
+</item>
+</list></p>
+
+<sect> Version 2.1.2.2, 2.1.2.1, 2.1.2.0
+
+<p> Released Nov 1996.
+
+<p><list>
+<item>Some changes WRT shared libraries
+</list></p>
+
+<sect> Version 2.1.1.0
+
+<p> Released Sep 1996.
+
+<p><list>
+<item>No hard links in source packages</item>
+
+<item>Do not use <prgn>dpkg-divert</prgn> or <prgn>update-alternatives</prgn>
+without consultation </item>
+
+<item>Shared libraries must be installed stripped </item>
+</list></p>
+
+<sect> Version 2.1.0.0
+
+<p> Released Aug 1996.
+
+<p><list>
+ <item>Upstream changelog must be installed too </item>
+</list></p>
+</book>
+</debiandoc>
+++ /dev/null
- Policy checklist for upgrading your packages
- ============================================
-
-Author: Bill Allombert, Josip Rodin, Julian Gilbey, Russ Allbery, and Manoj Srivastava <srivasta@debian.org>
-Date: 2010-01-26 13:43:11 CET
-
-
-About the checklist
-====================
-
-The checklist below has been created to simplify the upgrading process
-of old packages. Note that this list is not "official"; it simply
-gives an indication of what has changed and whether you are likely to
-need to make changes to your package in light of this. If you have
-doubts about a certain topic, if you need more details, or if you
-think some other package does not comply with policy, please refer to
-the Policy Manual itself. All of the changes from version 3.0.0
-onwards indicate which section of the Policy Manual discusses the
-issue: [3.4] means section 3.4. The section numbering changed when
-the packaging manual was incorporated into policy; the section numbers
-used below refer to the current version.
-
-Here is how the check list works: Check which policy version your
-package was checked against last (indicated in the "Standards-Version"
-field of the source package). Then move upwards until the top and
-check which of the items on the list might concern your package. Note
-which sections of policy discuss this, and then check out the Policy
-Manual for details. If you are upgrading from Policy version < 2.5.0,
-it may be easier to check through the whole of policy instead of
-picking your way through this list.
-
-The checklist
-==============
-
-3.8.4.0
---------
-
-Released Jan 2010.
-
-+ *9.1.1* : An FHS exception has been granted for multiarch libraries.
- Permitting files to instead be installed to `/lib/triplet' and
- `/usr/lib/triplet' directories.
-+ *10.6* : Explicitly state that packages may not contain named pipes and
- should instead create them in postinst and remove them in prerm or postrm.
-+ *9.1.1* : `/sys' and `/selinux' directories are explicitly allowed as an
- exception to the FHS.
-
-3.8.3.0
---------
-
-Released Aug 2009.
-
-+ *4.9* : Add DEB\_*\_ARCH\_CPU and DEB\_*\_ARCH\_OS variables and
- recommend them over GNU-style variables for that information.
-+ *5.6.8*: Source package Architecture fields may contain /all/ in
- combination with other architectures. Clarify when /all/ and /any/
- may be used in different versions of the field.
-+ *5.6.14* : The Debian archive software does not support uploading
- to multiple distributions with one `*.changes' file.
-+ *5.6.19* : The Binary field may span multiple lines.
-+ *10.2* : Remove the permission for shared library packages to
- install libraries in a non-standard location and modify ld.so.conf.
- Packages should either be installed in a standard library directory
- or packages using them should be built with RPATH.
-+ *11.8.7* : Clarify installation directories for X programs and
- remove the requirement to pre-depend on x11-common before installing
- into `/usr/include/X11' and `/usr/lib/X11'.
-+ *12.1* : Remove the requirement that all characters in a manual
- page be representable in the legacy encoding for that language.
-+ *12.1* : Localized man pages should either be kept up-to-date with
- the original version or warn that they're not up-to-date, either
- with warning text or by showing missing or changed portions in the
- original language.
-+ *12.2* : install-info is now handled via triggers so packages no
- longer need to invoke it in maintainer scripts. Info documents
- should now have directory sections and entries in the document.
- Packages containing info documents should add a dependency to
- support partial upgrades.
-+ *perl* : The requirement for Perl modules to have a versioned
- Depend and Build-Depend on perl >= 5.6.0-16 has been removed.
-
-3.8.2.0
---------
-
-Released Jun 2009.
-
-+ *2.4*: The list of archive sections has been significantly expanded. See
- [http://lists.debian.org/debian-devel-announce/2009/03/msg00010.html]
- for the list of new sections and rules for how to categorize
- packages.
-+ *3.9.1*: All packages must use debconf or equivalent for user prompting,
- though essential packages or their dependencies may also fall
- back on other methods.
-+ *5.6.1*: The requirements for source package names are now explicitly
- spelled out.
-+ *9.1*: Legacy XFree86 servers no longer get a special exception from the
- FHS permitting `/etc/X11/XF86Config-4'.
-+ *9.1.3*: Removed obsolete dependency requirements for packages that use
- `/var/mail'.
-+ *11.8.5*: Speedo fonts are now deprecated. The X backend was disabled
- starting in lenny.
-+ *12.5*: The GNU Free Documentation License version 1.3 is included in
- common-licenses and should be referenced from there.
-
-3.8.1.0
---------
-
-Released Mar 2009.
-
-+ *3.8*: Care should be taken when adding functionality to essential and
- such additions create an obligation to support that functionality
- in essential forever unless significant work is done.
-+ *4.4*: Changelog files must be encoded in UTF-8.
-+ *4.4*: Tighten some format requirements for changelog files from a should
- to a must.
-+ *4.4.1*: Remove alternative changelog formats. Debian only supports one
- changelog format for the Debian Archive.
-+ *4.9.1*: New nocheck option for DEB\_BUILD\_OPTIONS indicating any build-time
- test suite provided by the package should not be run.
-+ *5.1*: All control files must be encoded in UTF-8.
-+ *5.2*: `debian/control' allows comment lines starting with # with no
- preceding whitespace.
-+ *9.3*: Init scripts ending in .sh are not handled specially. They are not
- sourced and are not guaranteed to be run by `/bin/sh' regardless of
- the #! line. This brings Policy in line with the long-standing
- behavior of the init system in Debian.
-+ *9.3.2*: The start action of an init script must exit successfully and not
- start the daemon again if it's already running.
-+ *9.3.2*: `/var/run' and `/var/lock' may be mounted as temporary filesystems,
- and init scripts must therefore create any necessary subdirectories
- dynamically.
-+ *10.4*: `/bin/sh' scripts may assume that local can take multiple variable
- arguments and supports assignment.
-+ *11.6*: User mailboxes may be mode 600 and owned by the user rather than
- mode 660, owned by user, and group mail.
-
-3.8.0.0
---------
-
-Released Jun 2008.
-
-+ *2.4, 3.7*: The base section has been removed. contrib and non-free have been
- removed from the section list; they are only categories. The base
- system is now defined by priority.
-+ *4.9*: If dpkg-source -x doesn't provide the source that will be compiled,
- a debian/rules patch target is recommended and should do whatever
- else is necessary.
-+ *4.9.1, 10.1*: Standardized the format of DEB\_BUILD\_OPTIONS. Specified permitted
- characters for tags, required that tags be whitespace-separated,
- allowed packages to assume non-conflicting tags, and required
- unknown flags be ignored.
-+ *4.9.1*: Added parallel=n to the standardized DEB\_BUILD\_OPTIONS tags,
- indicating that a package should be built using up to n parallel
- processes if the package supports it
-+ *4.13*: Debian packages should not use convenience copies of code from other
- packages unless the included package is explicitly intended to be
- used that way.
-+ *4.14*: If dpkg-source -x doesn't produce source ready for editing and
- building with dpkg-buildpackage, packages should include a
- `debian/README.source' file explaining how to generate the patched
- source, add a new modification, and remove an existing
- modification. This file may also be used to document packaging a
- new upstream release and any other complexity of the Debian build
- process.
-+ *5.6.3*: The Uploaders field in `debian/control' may be wrapped.
-+ *5.6.12*: An empty Debian revision is equivalent to a Debian revision of 0 in
- a version number.
-+ *5.6.23*: New Homepage field for upstream web sites.
-+ *6.5, 6.6, 7*: The Breaks field declares that this package breaks another and
- prevents installation of the breaking package unless the package
- named in Breaks is deconfigured first. This field should not be
- used until the dpkg in Debian stable supports it.
-+ *8.1, 8.2*: Clarify which files should go into a shared library package, into a
- separate package, or into the -dev package. Suggest -tools instead
- of -runtime for runtime support programs, since that naming is more
- common in Debian.
-+ *9.5*: Files in `/etc/cron.{hourly,daily,weekly,monthly}' must be
- configuration files (upgraded from should). Mention the hourly
- directory.
-+ *11.8.6*: Packages providing `/etc/X11/Xresources' files need not conflict
- with xbase (<< 3.3.2.3a-2), which is long-obsolete.
-+ *12.1*: Manual pages in locale-specific directories should use either the
- legacy encoding for that directory or UTF-8. Country names should
- not be included in locale-specific manual page directories unless
- indicating a significant difference in the language. All
- characters in the manual page source should be representable in the
- legacy encoding for a locale even if the man page is encoded in
- UTF-8.
-+ *12.5*: The Apache 2.0 license is now in common-licenses and should be
- referenced rather than quoted in `debian/copyright'.
-+ *12.5*: Packages in contrib and non-free should state in the copyright file
- that the package is not part of Debian GNU/Linux and briefly
- explain why.
-+ *debconf*: Underscore (_) is allowed in debconf template names.
-
-3.7.3.0
---------
-
-Released Dec 2007.
-
-+ *5.6.12*: Package version numbers may contain tildes, which sort before
- anything, even the end of a part.
-+ *10.4*: Scripts may assume that `/bin/sh' supports local (at a basic level)
- and that its test builtin (if any) supports -a and -o binary
- logical operators.
-+ *8.5*: The substitution variable ${binary:Version} should be used in place
- of ${Source-Version} for dependencies between packages of the same
- library.
-+ *menu policy*: Substantial reorganization and renaming of sections in the Debian
- menu structure. Packages with menu entries should be reviewed to
- see if the menu section has been renamed or if one of the new
- sections would be more appropriate.
-+ *5.6.1*: The Source field in a .changes file may contain a version number
- in parentheses.
-+ *5.6.17*: The acceptable values for the Urgency field are low, medium, high,
- critical, or emergency.
-+ *8.6*: The shlibs file now allows an optional type field, indicating the
- type of package for which the line is valid. The only currently
- supported type is udeb, used with packages for the Debian
- Installer.
-+ *3.9.1*: Packages following the Debian Configuration management
- specification must allow for translation of their messages by using
- a gettext-based system such as po-debconf.
-+ *12.5*: GFDL 1.2, GPL 3, and LGPL 3 are now in common-licenses and should
- be referenced rather than quoted in `debian/copyright'.
-
-3.7.2.2
---------
-
-Released Oct 2006.
-
-+ *6.1*: Maintainer scripts must not be world writeable (up from a
- should to a must)
-
-3.7.2.0
---------
-
-Released Apr 2006.
-
-+ *11.5*: Revert the cgi-lib change.
-
-3.7.1.0
---------
-
-Released Apr 2006.
-
-+ *10.2*: It is now possible to create shared libraries without
- relocatable code (using -fPIC) in certain exceptional cases,
- provided some procedures are followed, and for creating static
- libraries with relocatable code (again, using -fPIC).
- Discussion on debian-devel@lists.debian.org, getting a rough
- consensus, and documenting it in README.Debian constitute most
- of the process.
-+ *11.8.7*: Packages should install any relevant files into the directories
- `/usr/include/X11/' and `/usr/lib/X11/', but if they do so, they
- must pre-depend on x11-common (>= 1:7.0.0)
-
-3.7.0.0
---------
-
-Released Apr 2006.
-
-+ *11.5*: Packages shipping web server CGI files are expected to install
- them in `/usr/lib/cgi-lib/' directories. This location change
- perhaps should be documented in NEWS
-+ *11.5*: Web server packages should include a standard scriptAlias of
- cgi-lib to `/usr/lib/cgi-lib'.
-+ *9.1.1*: The version of FHS mandated by policy has been upped to
- 2.3. There should be no changes required for most packages,
- though new top level directories `/media', `/srv', etc may be of
- interest.
-+ *5.1, 5.6.3*: All fields, apart from the Uploaders field, in the control file
- are supposed to be a single logical line, which may be spread
- over multiple physical lines (newline followed by space is
- elided). However, any parser for the control file must allow
- the Uploaders field to be spread over multiple physical lines
- as well, to prepare for future changes.
-+ *10.4*: When scripts are installed into a directory in the system
- PATH, the script name should not include an extension that
- denotes the scripting language currently used to implement it.
-
-+ *9.3.3.2*: packages that invoke initscripts now must use invoke-rc.d to do
- so since it also pays attention to run levels and other local
- constraints.
-+ *11.8.5.2, 11.8.7, etc*: We no longer use `/usr/X11R6', since we have
- migrated away to using Xorg paths. This means, for one thing, fonts
- live in `/usr/share/fonts/X11/' now, and `/usr/X11R6' is gone.
-
-
-3.6.2.0
---------
-
-Released 2005
-
-+ Recommend. doc-base, and not menu, for registering package documentation.
-+ *8.1*: Run time support programs should live in subdirectories of
- `/usr/lib/' or `/usr/share', and preferably the shared lib is named
- the same as the package name (to avoid name collisions).
-+ *11.5*: It is recommended that HTTP servers provide an alias `/images' to
- allow packages to share image files with the web server
-
-3.6.1.0
---------
-
-Released Aug 2003.
-
-+ *3.10.1*: Prompting the user should be done using debconf. Non debconf
- user prompts are now deprecated.
-
-3.6.0
-------
-
-Released Jul 2003.
-
-+ Restructuring causing shifts in section numbers and bumping of
- the minor version number:
-+ Many packaging manual appendices that were integrated into policy
- sections are now empty, and replaced with links to the Policy.
- In particular, the appendices that included the list of control
- fields were updated (new fields like Closes, Changed-By were added)
- and the list of fields for each of control, .changes and .dsc files
- is now in Policy, and they're marked mandatory, recommended or
- optional based on the current practice and the behavior of the
- deb-building tool-chain.
-+ Elimination of needlessly deep section levels, primarily in the
- chapter Debian Archive, from which two new chapters were split out,
- Binary packages and Source packages. What remained was reordered
- properly, that is, some sect1s became sects etc.
-+ Several sections that were redundant, crufty or simply not designed
- with any sort of vision, were rearranged according to the formula that
- everything should be either in the same place or properly interlinked.
- Some things remained split up between different chapters when they
- talked about different aspects of files: their content, their syntax,
- and their placement in the file system. In particular, see the new
- sections about changelog files.
-+ *menu policy*: Added Games/Simulation and Apps/Education to menu
- sub-policy
-+ *C.2.2*: Debian changelogs should be UTF-8 encoded.
-+ *10.2*: shared libraries must be linked against all libraries that they
- use symbols from in the same way that binaries are.
-+ *7.6*: build-depends-indep need not be satisfied during clean
- target.
-
-3.5.10
--------
-
-Released May 2003.
-
-+ *11.8.3*: packages providing the x-terminal-emulator virtual package
- ought to ensure that they interpret the command line exactly
- like xterm does.
-+ *11.8.4*: Window managers compliant with the Window Manager Specification
- Project may add 40 points for ranking in the alternatives
-
-3.5.9.0
---------
-
-Released Mar 2003.
-
-+ *3.4.2*: The section describing the Description: package field once again has
- full details of the long description format.
-+ *4.2*: Clarified that if a package has non-build-essential
- build-dependencies, it should have them listed in the Build-Depends
- and related fields (i.e. it's not merely optional).
-+ *9.3.2*: When asked to restart a service that isn't already running,
- the init script should start the service.
-+ *12.6*: If the purpose of a package is to provide examples, then the
- example files can be installed into `/usr/share/doc/package' (rather
- than `/usr/share/doc/package/examples').
-
-3.5.8.0
---------
-
-Released Nov 2002.
-
-+ *12.7*: It is no longer necessary to keep a log of changes to the upstream
- sources in the copyright file. Instead, all such changes should be
- documented in the changelog file.
-+ *7.6*: `Build-Depends', `Build-Conflicts', `Build-Depends-Indep',
- and `Build-Conflicts-Indep' must also be satisfied when the clean
- target is called.
-+ *menu policy*: A new Apps/Science menu section is available
-+ *debconf policy*: debconf specification cleared up, various changes.
-+ *12.1*: It is no longer recommended to create symlinks from nonexistent
- manual pages to undocumented(7). Missing manual pages for programs
- are still a bug.
-
-3.5.7.0
---------
-
-Released Aug 2002.
-
-+ Packages no longer have to ask permission to call MAKEDEV in
- postinst, merely notifying the user ought to be enough.
-+ *2.2.4*: cryptographic software may now be included in the main
- archive.
-+ *3.9*: task packages are no longer permitted; tasks are now created by a
- special Tasks: field in the control file.
-+ *11.8.4*: window managers that support netwm can now add 20 points when
- they add themselves as an alternative for
- `/usr/bin/x-window-manager'
-+ *10.1*: The default compilation options have now changed, one should
- provide debugging symbols in all cases, and optionally step
- back optimization to -O0, depending on the DEB\_BUILD\_OPTIONS
- environment variable.
-+ *7.6, 4.8*: Added mention of build-arch, build-indep, etc, in describing
- the relationships with `Build-Depends', `Build-Conflicts',
- `Build-Depends-Indep', and `Build-Conflicts-Indep'. May need to
- review the new rules.
-+ *8*: Changed rules on how, and when, to invoke ldconfig in maintainer
- scripts. Long rationale.
-
- *Added the last note in 3.5.6 upgrading checklist item regarding build rules, please see below*
-
-3.5.6.0
---------
-
-Released Jul 2001.
-
-+ *2.5*: Emacs and TeX are no longer mandated by policy to be priority
- standard packages
-+ *11.5*: Programs that access docs need to do so via `/usr/share/doc', and
- not via `/usr/doc/' as was the policy previously
-+ *12.3*: Putting documentation in `/usr/doc' versus `/usr/share/doc' is now
- a ``serious'' policy violation.
-+ *11.5*: For web servers, one should not provide non-local access to the
- `/usr/share/doc' hierarchy. If one can't provide access controls for
- the [http://localhost/doc/] directory, then it is preferred that one
- ask permission to expose that information during the install.
-+ *7*: There are new rules for build-indep/build-arch targets and
- there is a new Build-Depend-Indep semantic.
-
-3.5.5.0
---------
-
-Released May 2001.
-
-+ *12.1*: Manpages should not rely on header information to have
- alternative manpage names available; it should only use
- symlinks or .so pages to do this
-+ *Clarified note in 3.5.3.0 upgrading checklist regarding
- examples and templates: this refers only to those examples used
- by scripts; see section 10.7.3 for the whole story*
-+ Included a new section 10.9.1 describing the use of
- dpkg-statoverride; this does not have the weight of policy
-+ Clarify Standards-Version: you don't need to rebuild your
- packages just to change the Standards-Version!
-+ *10.2*: Plugins are no longer bound by all the rules of shared
- libraries
-+ X Windows related things:
- * *11.8.1*: Clarification of priority levels of X Window System related
- packages
- * *11.8.3*: Rules for defining x-terminal-emulator improved
- * *11.8.5*: X Font policy rewritten: you must read this if you provide
- fonts for the X Window System
- * *11.8.6*: Packages must not ship `/usr/X11R6/lib/X11/app-defaults/'
- * *11.8.7*: X-related packages should usually use the regular FHS
- locations; imake-using packages are exempted from this
- * *11.8.8*: OpenMotif linked binaries have the same rules as
- OSF/Motif-linked ones
-
-3.5.4.0
---------
-
-Released Apr 2001.
-
-+ *11.6*: The system-wide mail directory is now `/var/mail', no longer
- `/var/spool/mail'. Any packages accessing the mail spool should
- access it via `/var/mail' and include a suitable Depends field;
- details in
-+ *11.9; perl-policy*: The perl policy is now part of Debian policy
- proper. Perl programs and modules should follow the current Perl
- policy
-
-
-3.5.3.0
---------
-
- Apr 2001
-
-+ *7.1*: Build-Depends arch syntax has been changed to be less
- ambiguous. This should not affect any current packages
-+ *10.7.3*: Examples and templates files for use by scripts should now live
- in `/usr/share/<package>' or `/usr/lib/<package>', with
- symbolic links from `/usr/share/doc/<package>/examples' as
- needed
-
-3.5.2.0
---------
-
-Released Feb 2001.
-
-+ *11.8.6*: X app-defaults directory has moved from
- `/usr/X11R6/lib/X11/app-defaults' to `/etc/X11/app-defaults'
-
-3.5.1.0
---------
-
-Released Feb 2001.
-
-+ *8.1*: dpkg-shlibdeps now uses objdump, so shared libraries have to be
- run through dpkg-shlibdeps as well as executables
-
-3.5.0.0
---------
-
-Released Jan 2001.
-
-+ *11.8.5*: Font packages for the X Window System must now declare a
- dependency on xutils (>= 4.0.2)
-
-3.2.1.1
---------
-
-Released Jan 2001.
-
-+ *9.3.2*: Daemon startup scripts in `/etc/init.d/' should not contain
- modifiable parameters; these should be moved to a file in
- `/etc/default/'
-+ *12.3*: Files in `/usr/share/doc' must not be referenced by any
- program. If such files are needed, they must be placed in
- `/usr/share/<package>/', and symbolic links created as required
- in `/usr/share/doc/<package>/'
-+ Much of the packaging manual has now been imported into the
- policy document
-
-3.2.1.0
---------
-
-Released Aug 00.
-
-+ *11.8.1*: A package of priority standard or higher may provide two
- binaries, one compiled with support for the X Window System,
- and the other without
-
-3.2.0.0
---------
-
-Released Aug 00.
-
-+ *10.1*: By default executables should not be built with the debugging
- option -g. Instead, it is recommended to support building the
- package with debugging information optionally. Details in
-+ *12.8*: Policy for packages where the upstream uses HTML changelog
- files has been expanded. In short, a plain text changelog file
- should always be generated for the upstream changes
-+ Please note that the new release of the X window system (3.2)
- shall probably need sweeping changes in policy
-+ Policy for packages providing the following X-based features
- has been codified:
- - *11.8.2*: X server (virtual package xserver)
- - *11.8.3*: X terminal emulator (virtual package x-terminal-emulator)
- - *11.8.4*: X window manager (virtual package x-window-manager, and
- `/usr/bin/x-window-manager' alternative, with priority
- calculation guidelines)
- - *12.8.5*: X fonts (this section has been written from scratch)
- - *11.8.6*: X application defaults
-+ *11.8.7*: Policy for packages using the X Window System and FHS issues
- has been clarified
-+ *11.7.3*: No package may contain or make hard links to conffiles
-+ *8*: Noted that newer dpkg versions do not require extreme care in
- always creating the shared lib before the symlink, so the unpack
- order be correct
-
-3.1.1.0
---------
-
-Released Nov 1999.
-
-+ *7.1*: Correction to semantics of architecture lists in Build-Depends
- etc. Should not affect many packages
-
-3.1.0.0
---------
-
-Released Oct 1999.
-
-+ `/usr/doc/<package>' has to be a symlink pointing to
- `/usr/share/doc/<package>', to be maintained by postinst
- and prerm scripts. Details are in *defunct*
-+ *7.1, 7.6*: Introduced source dependencies (Build-Depends, etc.)
-+ *9.3.4*: `/etc/rc.boot' has been deprecated in favour of `/etc/rcS.d'.
- (Packages should not be touching this directory, but should use
- update-rc.d instead)
-+ *9.3.3*: update-rc.d is now the *only* allowable way of accessing the
- `/etc/rc?.d/[SK]??*' links. Any scripts which manipulate them
- directly must be changed to use update-rc.d instead. (This is
- because the file-rc package handles this information in an
- incompatible way.)
-+ *12.7*: Architecture-specific examples go in `/usr/lib/<package>/examples'
- with symlinks from `/usr/share/doc/<package>/examples/*' or from
- `/usr/share/doc/<package>/examples' itself
-+ *9.1.1*: Updated FHS to a 2.1 draft; this reverts `/var/state' to
- `/var/lib'
-+ *9.7; mime-policy*: Added MIME sub-policy document
-+ *12.4*: VISUAL is allowed as a (higher priority) alternative to EDITOR
-+ *11.6*: Modified liblockfile description, which affects
- mailbox-accessing programs. Please see the policy document for
- details
-+ *12.7*: If a package provides a changelog in HTML format, a text-only
- version should also be included. (Such a version may be prepared
- using lynx -dump -nolist.)
-+ *3.2.1*: Description of how to handle version numbers based on dates
- added
-
-3.0.1.0
---------
-
-Released Jul 1999.
-
-+ *10.2*: Added the clarification that the .la files are essential for
- the packages using libtool's libltdl library, in which case the .la
- files must go in the run-time library package
-
-3.0.0.0
---------
-
-Released Jun 1999.
-
-+ *9.1*: Debian formally moves from the FSSTND to the FHS. This is a
- major change, and the implications of this move are probably
- not all known.
-+ *4.1*: Only 3 digits of the Standards version need be included in
- control files, though all four digits are still permitted.
-+ *12.6*: The location of the GPL has changed to
- `/usr/share/common-licenses'. This may require changing the
- copyright files to point to the correct location of the GPL and
- other major licenses
-+ *10.2*: Packages that use libtool to create shared libraries must
- include the .la files in the -dev packages
-+ *10.8*: Use logrotate to rotate log files
-+ *11.8*: section 5.8 (now 11.8) has been rewritten (Programs for the X Window
- System)
-+ *9.6; menu-policy*: There is now an associated menu policy, in a separate document,
- that carries the full weight of Debian policy
-+ *11.3*: Programs which need to modify the files `/var/run/utmp',
- `/var/log/wtmp' and `/var/log/lastlog' must be installed setgid utmp
-
-
- *Please note that section numbers below this point may not be up to date*
-
-
-2.5.0.0
---------
-
-Released Oct 1998.
-
-Policy Manual:
-+ Rearranged the manual to create a new Section 4, Files
- + Section 3.3 ("Files") was moved to Section 4. The Sections
- that were Section 4 and Section 5 were moved down to become
- Section 5 and Section 6.
- + What was Section 5.5 ("Log files") is now a subsection of the
- new Section 4 ("Files"), becoming section 4.8, placed after
- "Configuration files", moving the Section 4.8 ("Permissions
- and owners") to Section 4.9. All subsections of the old
- Section 5 after 5.5 were moved down to fill in the number
- gap.
-+ Modified the section about changelog files to accommodate
- upstream changelogs which were formatted as HTML. These
- upstream changelog files should now be accessible as
- `/usr/doc/package/changelog.html.gz'
- + Symlinks are permissible to link the real, or upstream,
- changelog name to the Debian mandated name.
-+ Clarified that HTML documentation should be present in some
- package, though not necessarily the main binary package.
-+ Corrected all references to the location of the copyright
- files. The correct location is `/usr/doc/package/copyright'
-+ Ratified the architecture specification strings to cater to the
- HURD.
-
-2.4.1.0
---------
-
-Released Apr 1998.
-
-* Policy Manual:
- + Updated section 3.3.5 Symbolic links:
- + symbolic links within a toplevel directory should be relative,
- symbolic links between toplevel directories should be absolute
- (cf., Policy Weekly Issue#6, topic 2)
-
- + Updated section 4.9 Games:
- + manpages for games should be installed in `/usr/man/man6'
- (cf., Policy Weekly Issue#6, topic 3)
-
-* Packaging Manual:
- + Updated prefix of chapter 12, Shared Libraries:
- ldconfig must be called in the postinst script if the package
- installs shared libraries
- (cf., Policy Weekly Issue #6, fixes:bug#20515)
-
-
-2.4.0.0
---------
-
-Released Jan 1998
-
-+ Updated section 3.3.4 Scripts:
- + `/bin/sh' may be any POSIX compatible shell
- + scripts including bashisms have to specify `/bin/bash' as
- interpreter
- + scripts which create files in world-writable directories
- (e.g., in `/tmp') should use tempfile or mktemp for creating
- the directory
-
-+ Updated section 3.3.5 Symbolic Links:
- + symbolic links referencing compressed files must have the same
- file extension as the referenced file
-
-+ Updated section 3.3.6 Device files:
- + `/dev/tty*' serial devices should be used instead of `/dev/cu*'
-
-+ Updated section 3.4.2 Writing the scripts in `/etc/init.d':
- + all `/etc/init.d' scripts have to provide the following options:
- start, stop, restart, force-reload
- + the reload option is optional and must never stop and restart
- the service
-
-+ Updated section 3.5 Cron jobs:
- + cron jobs that need to be executed more often than daily should
- be installed into `/etc/cron.d'
-
-+ Updated section 3.7 Menus:
- + removed section about how to register HTML docs to `menu'
- (the corresponding section in 4.4, Web servers and applications,
- has been removed in policy 2.2.0.0 already, so this one was
- obsolete)
-
-+ New section 3.8 Keyboard configuration:
- + details about how the backspace and delete keys should be
- handled
-
-+ New section 3.9 Environment variables:
- + no program must depend on environment variables to get a
- reasonable default configuration
-
-+ New section 4.6 News system configuration:
- + `/etc/news/organization' and `/etc/news/server' should be supported
- by all news servers and clients
-
-+ Updated section 4.7 Programs for the X Window System:
- + programs requiring a non-free Motif library should be provided
- as foo-smotif and foo-dmotif package
- + if lesstif works reliably for such program, it should be linked
- against lesstif and not against a non-free Motif library
-
-+ Updated section 4.9 Games:
- + games for X Windows have to be installed in `/usr/games', just as
- non-X games
-
-2.3.0.1, 2.3.0.0
------------------
-
-Released Sep 1997.
-
-+ new section `4.2 Daemons' including rules for
- `/etc/services', `/etc/protocols', `/etc/rpc', and `/etc/inetd.conf'
-
-+ updated section about `Configuration files':
- packages may not touch other packages' configuration files
-
-+ MUAs and MTAs have to use liblockfile
-
-2.2.0.0
---------
-
-Released July 1997.
-
-+ added section 4.1 `Architecture specification strings':
- use
- <arch>-linux
- where <arch> is one of the following:
- i386, alpha, arm, m68k, powerpc, sparc.
-
-+ detailed rules for `/usr/local'
-
-+ user ID's
-
-+ editor/pager policy
-
-+ cron jobs
-
-+ device files
-
-+ don't install shared libraries as executable
-
-+ app-defaults files may not be conffiles
-
-2.1.3.2, 2.1.3.1, 2.1.3.0
---------------------------
-
-Released Mar 1997.
-
-+ two programs with different functionality must not have the
- same name
-
-+ "Webstandard 3.0"
-
-+ "Standard for Console Messages"
-
-+ Libraries should be compiled with `-D\_REENTRANT'
-
-+ Libraries should be stripped with "strip --strip-unneeded"
-
-2.1.2.2, 2.1.2.1, 2.1.2.0
---------------------------
-
-Released Nov 1996.
-
-+ Some changes WRT shared libraries
-
-2.1.1.0
---------
-
-Released Sep 1996.
-
-+ No hard links in source packages
-
-+ Do not use dpkg-divert or update-alternatives without consultation
-
-+ Shared libraries must be installed stripped
-
-2.1.0.0
---------
-
-Released Aug 1996.
-
-+ Upstream changelog must be installed too
projects / debian / debian-policy.git / commitdiff