CINXE.COM
Debian Policy Manual — Debian Policy Manual v4.7.0.1
<!DOCTYPE html> <html class="writer-html5" lang="en" data-content_root="./"> <head> <meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Debian Policy Manual — Debian Policy Manual v4.7.0.1</title> <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" /> <link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=86f27845" /> <link rel="stylesheet" type="text/css" href="_static/debian.css?v=bf0c9607" /> <script src="_static/jquery.js?v=8dae8fb0"></script> <script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script> <script src="_static/documentation_options.js?v=4052547e"></script> <script src="_static/doctools.js?v=9a2dae69"></script> <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <script src="_static/js/theme.js"></script> <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> <link rel="next" title="1. About this manual" href="ch-scope.html" /> </head> <body class="wy-body-for-nav"> <div class="wy-grid-for-nav"> <nav data-toggle="wy-nav-shift" class="wy-nav-side"> <div class="wy-side-scroll"> <div class="wy-side-nav-search" > <a href="#" class="icon icon-home"> Debian Policy Manual </a> <div class="version"> 4.7.0.1 </div> <div role="search"> <form id="rtd-search-form" class="wy-form" action="search.html" method="get"> <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" /> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> </div> </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu"> <ul> <li class="toctree-l1"><a class="reference internal" href="ch-scope.html">1. About this manual</a></li> <li class="toctree-l1"><a class="reference internal" href="ch-archive.html">2. The Debian Archive</a></li> <li class="toctree-l1"><a class="reference internal" href="ch-binary.html">3. Binary packages</a></li> <li class="toctree-l1"><a class="reference internal" href="ch-source.html">4. Source packages</a></li> <li class="toctree-l1"><a class="reference internal" href="ch-controlfields.html">5. Control files and their fields</a></li> <li class="toctree-l1"><a class="reference internal" href="ch-maintainerscripts.html">6. Package maintainer scripts and installation procedure</a></li> <li class="toctree-l1"><a class="reference internal" href="ch-relationships.html">7. Declaring relationships between packages</a></li> <li class="toctree-l1"><a class="reference internal" href="ch-sharedlibs.html">8. Shared libraries</a></li> <li class="toctree-l1"><a class="reference internal" href="ch-opersys.html">9. The Operating System</a></li> <li class="toctree-l1"><a class="reference internal" href="ch-files.html">10. Files</a></li> <li class="toctree-l1"><a class="reference internal" href="ch-customized-programs.html">11. Customized programs</a></li> <li class="toctree-l1"><a class="reference internal" href="ch-docs.html">12. Documentation</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Appendices</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-scope.html">1. Introduction and scope of these appendices</a></li> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-binarypkg.html">2. Binary packages (from old Packaging Manual)</a></li> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-sourcepkg.html">3. Source packages (from old Packaging Manual)</a></li> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-controlfields.html">4. Control files and their fields (from old Packaging Manual)</a></li> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-conffiles.html">5. Configuration file handling (from old Packaging Manual)</a></li> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-alternatives.html">6. Alternative versions of an interface - <code class="docutils literal notranslate"><span class="pre">update-alternatives</span></code> (from old Packaging Manual)</a></li> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-diversions.html">7. Diversions - overriding a package’s version of a file (from old Packaging Manual)</a></li> <li class="toctree-l1"><a class="reference internal" href="ap-process.html">8. Debian Policy changes process</a></li> <li class="toctree-l1"><a class="reference internal" href="ap-flowcharts.html">9. Maintainer script flowcharts</a></li> <li class="toctree-l1"><a class="reference internal" href="upgrading-checklist.html">10. Upgrading checklist</a></li> <li class="toctree-l1"><a class="reference internal" href="ap-license.html">11. License</a></li> </ul> </div> </div> </nav> <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" > <i data-toggle="wy-nav-top" class="fa fa-bars"></i> <a href="#">Debian Policy Manual</a> </nav> <div class="wy-nav-content"> <div class="rst-content"> <div role="navigation" aria-label="Page navigation"> <ul class="wy-breadcrumbs"> <li><a href="#" class="icon icon-home" aria-label="Home"></a></li> <li class="breadcrumb-item active">Debian Policy Manual</li> <li class="wy-breadcrumbs-aside"> <a href="_sources/index.rst.txt" rel="nofollow"> View page source</a> </li> </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation"> <a href="ch-scope.html" class="btn btn-neutral float-right" title="1. About this manual" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a> </div> <hr/> </div> <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article"> <div itemprop="articleBody"> <section id="debian-policy-manual"> <h1>Debian Policy Manual<a class="headerlink" href="#debian-policy-manual" title="Link to this heading"></a></h1> <p>This manual describes the policy requirements for the Debian distribution. This includes the structure and contents of the Debian archive and several design issues of the operating system, as well as technical requirements that each package must satisfy to be included in the distribution.</p> <p>This is Debian Policy version 4.7.0.1, released on 2024-08-25.</p> <div class="toctree-wrapper compound"> <ul> <li class="toctree-l1"><a class="reference internal" href="ch-scope.html">1. About this manual</a><ul> <li class="toctree-l2"><a class="reference internal" href="ch-scope.html#scope">1.1. Scope</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-scope.html#new-versions-of-this-document">1.2. New versions of this document</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-scope.html#authors-and-maintainers">1.3. Authors and Maintainers</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-scope.html#early-history">1.3.1. Early history</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-scope.html#current-process">1.3.2. Current process</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-scope.html#improvements">1.3.3. Improvements</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-scope.html#related-documents">1.4. Related documents</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-scope.html#definitions">1.5. Definitions</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-scope.html#translations">1.6. Translations</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ch-archive.html">2. The Debian Archive</a><ul> <li class="toctree-l2"><a class="reference internal" href="ch-archive.html#the-debian-free-software-guidelines">2.1. The Debian Free Software Guidelines</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-archive.html#archive-areas">2.2. Archive areas</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-archive.html#the-main-archive-area">2.2.1. The main archive area</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-archive.html#the-non-free-firmware-archive-area">2.2.2. The non-free-firmware archive area</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-archive.html#the-contrib-archive-area">2.2.3. The contrib archive area</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-archive.html#the-non-free-archive-area">2.2.4. The non-free archive area</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-archive.html#copyright-considerations">2.3. Copyright considerations</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-archive.html#sections">2.4. Sections</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-archive.html#priorities">2.5. Priorities</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ch-binary.html">3. Binary packages</a><ul> <li class="toctree-l2"><a class="reference internal" href="ch-binary.html#the-package-name">3.1. The package name</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-binary.html#packages-with-potentially-offensive-content">3.1.1. Packages with potentially offensive content</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-binary.html#the-version-of-a-package">3.2. The version of a package</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-binary.html#version-numbers-based-on-dates">3.2.1. Version numbers based on dates</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-binary.html#uniqueness-of-version-numbers">3.2.2. Uniqueness of version numbers</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-binary.html#the-maintainer-of-a-package">3.3. The maintainer of a package</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-binary.html#the-description-of-a-package">3.4. The description of a package</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-binary.html#the-single-line-synopsis">3.4.1. The single line synopsis</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-binary.html#the-extended-description">3.4.2. The extended description</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-binary.html#dependencies">3.5. Dependencies</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-binary.html#virtual-packages">3.6. Virtual packages</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-binary.html#base-system">3.7. Base system</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-binary.html#essential-packages">3.8. Essential packages</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-binary.html#maintainer-scripts">3.9. Maintainer Scripts</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-binary.html#prompting-in-maintainer-scripts">3.9.1. Prompting in maintainer scripts</a></li> </ul> </li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ch-source.html">4. Source packages</a><ul> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#standards-conformance">4.1. Standards conformance</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#package-relationships">4.2. Package relationships</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#changes-to-the-upstream-sources">4.3. Changes to the upstream sources</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#debian-changelog-debian-changelog">4.4. Debian changelog: <code class="docutils literal notranslate"><span class="pre">debian/changelog</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#copyright-debian-copyright">4.5. Copyright: <code class="docutils literal notranslate"><span class="pre">debian/copyright</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#error-trapping-in-makefiles">4.6. Error trapping in makefiles</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#time-stamps">4.7. Time Stamps</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#restrictions-on-objects-in-source-packages">4.8. Restrictions on objects in source packages</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#main-building-script-debian-rules">4.9. Main building script: <code class="docutils literal notranslate"><span class="pre">debian/rules</span></code></a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-source.html#debian-rules-and-deb-build-options">4.9.1. <code class="docutils literal notranslate"><span class="pre">debian/rules</span></code> and <code class="docutils literal notranslate"><span class="pre">DEB_BUILD_OPTIONS</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-source.html#debian-rules-and-rules-requires-root">4.9.2. <code class="docutils literal notranslate"><span class="pre">debian/rules</span></code> and <code class="docutils literal notranslate"><span class="pre">Rules-Requires-Root</span></code></a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#variable-substitutions-debian-substvars">4.10. Variable substitutions: <code class="docutils literal notranslate"><span class="pre">debian/substvars</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#upstream-source-location-debian-watch">4.11. Upstream source location: <code class="docutils literal notranslate"><span class="pre">debian/watch</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#generated-files-list-debian-files">4.12. Generated files list: <code class="docutils literal notranslate"><span class="pre">debian/files</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#embedded-code-copies">4.13. Embedded code copies</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#source-package-handling-debian-readme-source">4.14. Source package handling: <code class="docutils literal notranslate"><span class="pre">debian/README.source</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#reproducibility">4.15. Reproducibility</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#missing-sources-debian-missing-sources">4.16. Missing sources: <code class="docutils literal notranslate"><span class="pre">debian/missing-sources</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-source.html#vendor-specific-patch-series">4.17. Vendor-specific patch series</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ch-controlfields.html">5. Control files and their fields</a><ul> <li class="toctree-l2"><a class="reference internal" href="ch-controlfields.html#syntax-of-control-files">5.1. Syntax of control files</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-controlfields.html#debian-source-package-template-control-files-debian-control">5.2. Debian source package template control files – <code class="docutils literal notranslate"><span class="pre">debian/control</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-controlfields.html#debian-binary-package-control-files-debian-control">5.3. Debian binary package control files – <code class="docutils literal notranslate"><span class="pre">DEBIAN/control</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-controlfields.html#debian-source-package-control-files-dsc">5.4. Debian source package control files – <code class="docutils literal notranslate"><span class="pre">.dsc</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-controlfields.html#debian-upload-changes-control-files-changes">5.5. Debian upload changes control files – <code class="docutils literal notranslate"><span class="pre">.changes</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-controlfields.html#list-of-fields">5.6. List of fields</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#source">5.6.1. <code class="docutils literal notranslate"><span class="pre">Source</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#maintainer">5.6.2. <code class="docutils literal notranslate"><span class="pre">Maintainer</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#uploaders">5.6.3. <code class="docutils literal notranslate"><span class="pre">Uploaders</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#changed-by">5.6.4. <code class="docutils literal notranslate"><span class="pre">Changed-By</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#section">5.6.5. <code class="docutils literal notranslate"><span class="pre">Section</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#priority">5.6.6. <code class="docutils literal notranslate"><span class="pre">Priority</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#package">5.6.7. <code class="docutils literal notranslate"><span class="pre">Package</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#architecture">5.6.8. <code class="docutils literal notranslate"><span class="pre">Architecture</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#essential">5.6.9. <code class="docutils literal notranslate"><span class="pre">Essential</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#package-interrelationship-fields-depends-pre-depends-recommends-suggests-breaks-conflicts-provides-replaces-enhances">5.6.10. Package interrelationship fields: <code class="docutils literal notranslate"><span class="pre">Depends</span></code>, <code class="docutils literal notranslate"><span class="pre">Pre-Depends</span></code>, <code class="docutils literal notranslate"><span class="pre">Recommends</span></code>, <code class="docutils literal notranslate"><span class="pre">Suggests</span></code>, <code class="docutils literal notranslate"><span class="pre">Breaks</span></code>, <code class="docutils literal notranslate"><span class="pre">Conflicts</span></code>, <code class="docutils literal notranslate"><span class="pre">Provides</span></code>, <code class="docutils literal notranslate"><span class="pre">Replaces</span></code>, <code class="docutils literal notranslate"><span class="pre">Enhances</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#standards-version">5.6.11. <code class="docutils literal notranslate"><span class="pre">Standards-Version</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#version">5.6.12. <code class="docutils literal notranslate"><span class="pre">Version</span></code></a><ul> <li class="toctree-l4"><a class="reference internal" href="ch-controlfields.html#epochs-should-be-used-sparingly">5.6.12.1. Epochs should be used sparingly</a></li> <li class="toctree-l4"><a class="reference internal" href="ch-controlfields.html#special-version-conventions">5.6.12.2. Special version conventions</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#description">5.6.13. <code class="docutils literal notranslate"><span class="pre">Description</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#distribution">5.6.14. <code class="docutils literal notranslate"><span class="pre">Distribution</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#date">5.6.15. <code class="docutils literal notranslate"><span class="pre">Date</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#format">5.6.16. <code class="docutils literal notranslate"><span class="pre">Format</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#urgency">5.6.17. <code class="docutils literal notranslate"><span class="pre">Urgency</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#changes">5.6.18. <code class="docutils literal notranslate"><span class="pre">Changes</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#binary">5.6.19. <code class="docutils literal notranslate"><span class="pre">Binary</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#installed-size">5.6.20. <code class="docutils literal notranslate"><span class="pre">Installed-Size</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#files">5.6.21. <code class="docutils literal notranslate"><span class="pre">Files</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#closes">5.6.22. <code class="docutils literal notranslate"><span class="pre">Closes</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#homepage">5.6.23. <code class="docutils literal notranslate"><span class="pre">Homepage</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#checksums-sha1-and-checksums-sha256">5.6.24. <code class="docutils literal notranslate"><span class="pre">Checksums-Sha1</span></code> and <code class="docutils literal notranslate"><span class="pre">Checksums-Sha256</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#dm-upload-allowed">5.6.25. <code class="docutils literal notranslate"><span class="pre">DM-Upload-Allowed</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#version-control-system-vcs-fields">5.6.26. Version Control System (VCS) fields</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#package-list">5.6.27. <code class="docutils literal notranslate"><span class="pre">Package-List</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#package-type">5.6.28. <code class="docutils literal notranslate"><span class="pre">Package-Type</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#dgit">5.6.29. <code class="docutils literal notranslate"><span class="pre">Dgit</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#testsuite">5.6.30. <code class="docutils literal notranslate"><span class="pre">Testsuite</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#rules-requires-root">5.6.31. <code class="docutils literal notranslate"><span class="pre">Rules-Requires-Root</span></code></a><ul> <li class="toctree-l4"><a class="reference internal" href="ch-controlfields.html#remarks">5.6.31.1. Remarks</a></li> <li class="toctree-l4"><a class="reference internal" href="ch-controlfields.html#definition-of-the-keywords">5.6.31.2. Definition of the keywords</a></li> <li class="toctree-l4"><a class="reference internal" href="ch-controlfields.html#provided-keywords">5.6.31.3. Provided keywords</a></li> </ul> </li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-controlfields.html#user-defined-fields">5.7. User-defined fields</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-controlfields.html#obsolete-fields">5.8. Obsolete fields</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-controlfields.html#s-f-dm-upload-allowed">5.8.1. <code class="docutils literal notranslate"><span class="pre">DM-Upload-Allowed</span></code></a></li> </ul> </li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ch-maintainerscripts.html">6. Package maintainer scripts and installation procedure</a><ul> <li class="toctree-l2"><a class="reference internal" href="ch-maintainerscripts.html#introduction-to-package-maintainer-scripts">6.1. Introduction to package maintainer scripts</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-maintainerscripts.html#maintainer-scripts-idempotency">6.2. Maintainer scripts idempotency</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-maintainerscripts.html#controlling-terminal-for-maintainer-scripts">6.3. Controlling terminal for maintainer scripts</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-maintainerscripts.html#exit-status">6.4. Exit status</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-maintainerscripts.html#summary-of-ways-maintainer-scripts-are-called">6.5. Summary of ways maintainer scripts are called</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-maintainerscripts.html#details-of-unpack-phase-of-installation-or-upgrade">6.6. Details of unpack phase of installation or upgrade</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-maintainerscripts.html#details-of-configuration">6.7. Details of configuration</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-maintainerscripts.html#details-of-removal-and-or-configuration-purging">6.8. Details of removal and/or configuration purging</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ch-relationships.html">7. Declaring relationships between packages</a><ul> <li class="toctree-l2"><a class="reference internal" href="ch-relationships.html#syntax-of-relationship-fields">7.1. Syntax of relationship fields</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-relationships.html#binary-dependencies-depends-recommends-suggests-enhances-pre-depends">7.2. Binary Dependencies - <code class="docutils literal notranslate"><span class="pre">Depends</span></code>, <code class="docutils literal notranslate"><span class="pre">Recommends</span></code>, <code class="docutils literal notranslate"><span class="pre">Suggests</span></code>, <code class="docutils literal notranslate"><span class="pre">Enhances</span></code>, <code class="docutils literal notranslate"><span class="pre">Pre-Depends</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-relationships.html#packages-which-break-other-packages-breaks">7.3. Packages which break other packages - <code class="docutils literal notranslate"><span class="pre">Breaks</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-relationships.html#conflicting-binary-packages-conflicts">7.4. Conflicting binary packages - <code class="docutils literal notranslate"><span class="pre">Conflicts</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-relationships.html#virtual-packages-provides">7.5. Virtual packages - <code class="docutils literal notranslate"><span class="pre">Provides</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-relationships.html#overwriting-files-and-replacing-packages-replaces">7.6. Overwriting files and replacing packages - <code class="docutils literal notranslate"><span class="pre">Replaces</span></code></a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-relationships.html#overwriting-files-in-other-packages">7.6.1. Overwriting files in other packages</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-relationships.html#replacing-whole-packages-forcing-their-removal">7.6.2. Replacing whole packages, forcing their removal</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-relationships.html#relationships-between-source-and-binary-packages-build-depends-build-depends-indep-build-depends-arch-build-conflicts-build-conflicts-indep-build-conflicts-arch">7.7. Relationships between source and binary packages - <code class="docutils literal notranslate"><span class="pre">Build-Depends</span></code>, <code class="docutils literal notranslate"><span class="pre">Build-Depends-Indep</span></code>, <code class="docutils literal notranslate"><span class="pre">Build-Depends-Arch</span></code>, <code class="docutils literal notranslate"><span class="pre">Build-Conflicts</span></code>, <code class="docutils literal notranslate"><span class="pre">Build-Conflicts-Indep</span></code>, <code class="docutils literal notranslate"><span class="pre">Build-Conflicts-Arch</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ch-relationships.html#additional-source-packages-used-to-build-the-binary-built-using">7.8. Additional source packages used to build the binary - <code class="docutils literal notranslate"><span class="pre">Built-Using</span></code></a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ch-sharedlibs.html">8. Shared libraries</a><ul> <li class="toctree-l2"><a class="reference internal" href="ch-sharedlibs.html#run-time-shared-libraries">8.1. Run-time shared libraries</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-sharedlibs.html#ldconfig">8.1.1. <code class="docutils literal notranslate"><span class="pre">ldconfig</span></code></a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-sharedlibs.html#shared-library-support-files">8.2. Shared library support files</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-sharedlibs.html#static-libraries">8.3. Static libraries</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-sharedlibs.html#development-files">8.4. Development files</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-sharedlibs.html#dependencies-between-the-packages-of-the-same-library">8.5. Dependencies between the packages of the same library</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-sharedlibs.html#dependencies-between-the-library-and-other-packages">8.6. Dependencies between the library and other packages</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-sharedlibs.html#generating-dependencies-on-shared-libraries">8.6.1. Generating dependencies on shared libraries</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-sharedlibs.html#shared-library-abi-changes">8.6.2. Shared library ABI changes</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-sharedlibs.html#the-symbols-system">8.6.3. The <code class="docutils literal notranslate"><span class="pre">symbols</span></code> system</a><ul> <li class="toctree-l4"><a class="reference internal" href="ch-sharedlibs.html#the-symbols-files-present-on-the-system">8.6.3.1. The <code class="docutils literal notranslate"><span class="pre">symbols</span></code> files present on the system</a></li> <li class="toctree-l4"><a class="reference internal" href="ch-sharedlibs.html#the-symbols-file-format">8.6.3.2. The <code class="docutils literal notranslate"><span class="pre">symbols</span></code> File Format</a></li> <li class="toctree-l4"><a class="reference internal" href="ch-sharedlibs.html#providing-a-symbols-file">8.6.3.3. Providing a <code class="docutils literal notranslate"><span class="pre">symbols</span></code> file</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="ch-sharedlibs.html#the-shlibs-system">8.6.4. The <code class="docutils literal notranslate"><span class="pre">shlibs</span></code> system</a><ul> <li class="toctree-l4"><a class="reference internal" href="ch-sharedlibs.html#the-shlibs-files-present-on-the-system">8.6.4.1. The <code class="docutils literal notranslate"><span class="pre">shlibs</span></code> files present on the system</a></li> <li class="toctree-l4"><a class="reference internal" href="ch-sharedlibs.html#the-shlibs-file-format">8.6.4.2. The <code class="docutils literal notranslate"><span class="pre">shlibs</span></code> File Format</a></li> <li class="toctree-l4"><a class="reference internal" href="ch-sharedlibs.html#providing-a-shlibs-file">8.6.4.3. Providing a <code class="docutils literal notranslate"><span class="pre">shlibs</span></code> file</a></li> </ul> </li> </ul> </li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ch-opersys.html">9. The Operating System</a><ul> <li class="toctree-l2"><a class="reference internal" href="ch-opersys.html#file-system-hierarchy">9.1. File system hierarchy</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#file-system-structure">9.1.1. File System Structure</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#site-specific-programs">9.1.2. Site-specific programs</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#the-system-wide-mail-directory">9.1.3. The system-wide mail directory</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#run-and-run-lock">9.1.4. <code class="docutils literal notranslate"><span class="pre">/run</span></code> and <code class="docutils literal notranslate"><span class="pre">/run/lock</span></code></a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-opersys.html#users-and-groups">9.2. Users and groups</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#introduction">9.2.1. Introduction</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#uid-and-gid-classes">9.2.2. UID and GID classes</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#non-existent-home-directories">9.2.3. Non-existent home directories</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-opersys.html#starting-system-services">9.3. Starting system services</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#s-services-intro">9.3.1. Introduction</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#writing-the-scripts">9.3.2. Writing the scripts</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#interfacing-with-init-systems">9.3.3. Interfacing with init systems</a><ul> <li class="toctree-l4"><a class="reference internal" href="ch-opersys.html#managing-the-links">9.3.3.1. Managing the links</a></li> <li class="toctree-l4"><a class="reference internal" href="ch-opersys.html#running-init-scripts">9.3.3.2. Running init scripts</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#boot-time-initialization">9.3.4. Boot-time initialization</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#example">9.3.5. Example</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-opersys.html#console-messages-from-init-d-scripts">9.4. Console messages from <code class="docutils literal notranslate"><span class="pre">init.d</span></code> scripts</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-opersys.html#cron-jobs">9.5. Cron jobs</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#cron-job-file-names">9.5.1. Cron job file names</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-opersys.html#menus">9.6. Menus</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-opersys.html#multimedia-handlers">9.7. Multimedia handlers</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#registration-of-media-type-handlers-with-desktop-entries">9.7.1. Registration of media type handlers with desktop entries</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#registration-of-media-type-handlers-with-mailcap-entries">9.7.2. Registration of media type handlers with mailcap entries</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#providing-media-types-to-files">9.7.3. Providing media types to files</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-opersys.html#keyboard-configuration">9.8. Keyboard configuration</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-opersys.html#environment-variables">9.9. Environment variables</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-opersys.html#registering-documents-using-doc-base">9.10. Registering Documents using doc-base</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-opersys.html#alternate-init-systems">9.11. Alternate init systems</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-opersys.html#event-based-boot-with-upstart">9.11.1. Event-based boot with upstart</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-opersys.html#signaling-that-a-reboot-is-required">9.12. Signaling that a reboot is required</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ch-files.html">10. Files</a><ul> <li class="toctree-l2"><a class="reference internal" href="ch-files.html#binaries">10.1. Binaries</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-files.html#libraries">10.2. Libraries</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-files.html#shared-libraries">10.3. Shared libraries</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-files.html#scripts">10.4. Scripts</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-files.html#symbolic-links">10.5. Symbolic links</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-files.html#device-files">10.6. Device files</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-files.html#configuration-files">10.7. Configuration files</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-files.html#definitions">10.7.1. Definitions</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-files.html#location">10.7.2. Location</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-files.html#behavior">10.7.3. Behavior</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-files.html#sharing-configuration-files">10.7.4. Sharing configuration files</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-files.html#user-configuration-files-dotfiles">10.7.5. User configuration files (“dotfiles”)</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-files.html#log-files">10.8. Log files</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-files.html#permissions-and-owners">10.9. Permissions and owners</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-files.html#the-use-of-dpkg-statoverride">10.9.1. The use of <code class="docutils literal notranslate"><span class="pre">dpkg-statoverride</span></code></a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-files.html#file-names">10.10. File names</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ch-customized-programs.html">11. Customized programs</a><ul> <li class="toctree-l2"><a class="reference internal" href="ch-customized-programs.html#architecture-specification-strings">11.1. Architecture specification strings</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-customized-programs.html#architecture-wildcards">11.1.1. Architecture wildcards</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-customized-programs.html#daemons">11.2. Daemons</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-customized-programs.html#using-pseudo-ttys-and-modifying-wtmp-utmp-and-lastlog">11.3. Using pseudo-ttys and modifying wtmp, utmp and lastlog</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-customized-programs.html#editors-and-pagers">11.4. Editors and pagers</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-customized-programs.html#web-servers-and-applications">11.5. Web servers and applications</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-customized-programs.html#mail-transport-delivery-and-user-agents">11.6. Mail transport, delivery and user agents</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-customized-programs.html#news-system-configuration">11.7. News system configuration</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-customized-programs.html#programs-for-the-x-window-system">11.8. Programs for the X Window System</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-customized-programs.html#providing-x-support-and-package-priorities">11.8.1. Providing X support and package priorities</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-customized-programs.html#packages-providing-an-x-server">11.8.2. Packages providing an X server</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-customized-programs.html#packages-providing-a-terminal-emulator">11.8.3. Packages providing a terminal emulator</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-customized-programs.html#packages-providing-a-window-manager">11.8.4. Packages providing a window manager</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-customized-programs.html#packages-providing-fonts">11.8.5. Packages providing fonts</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-customized-programs.html#application-defaults-files">11.8.6. Application defaults files</a></li> <li class="toctree-l3"><a class="reference internal" href="ch-customized-programs.html#installation-directory-issues">11.8.7. Installation directory issues</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-customized-programs.html#perl-programs-and-modules">11.9. Perl programs and modules</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-customized-programs.html#emacs-lisp-programs">11.10. Emacs lisp programs</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-customized-programs.html#games">11.11. Games</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ch-docs.html">12. Documentation</a><ul> <li class="toctree-l2"><a class="reference internal" href="ch-docs.html#manual-pages">12.1. Manual pages</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-docs.html#info-documents">12.2. Info documents</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-docs.html#additional-documentation">12.3. Additional documentation</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-docs.html#preferred-documentation-formats">12.4. Preferred documentation formats</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-docs.html#copyright-information">12.5. Copyright information</a><ul> <li class="toctree-l3"><a class="reference internal" href="ch-docs.html#machine-readable-copyright-information">12.5.1. Machine-readable copyright information</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ch-docs.html#examples">12.6. Examples</a></li> <li class="toctree-l2"><a class="reference internal" href="ch-docs.html#changelog-files-and-release-notes">12.7. Changelog files and release notes</a></li> </ul> </li> </ul> </div> <div class="toctree-wrapper compound" id="appendix"> <p class="caption" role="heading"><span class="caption-text">Appendices</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-scope.html">1. Introduction and scope of these appendices</a></li> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-binarypkg.html">2. Binary packages (from old Packaging Manual)</a><ul> <li class="toctree-l2"><a class="reference internal" href="ap-pkg-binarypkg.html#creating-package-files-dpkg-deb">2.1. Creating package files - <code class="docutils literal notranslate"><span class="pre">dpkg-deb</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ap-pkg-binarypkg.html#binary-package-metadata-files">2.2. Binary package metadata files</a></li> <li class="toctree-l2"><a class="reference internal" href="ap-pkg-binarypkg.html#the-binary-package-control-file-control">2.3. The binary package control file: <code class="docutils literal notranslate"><span class="pre">control</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ap-pkg-binarypkg.html#time-stamps">2.4. Time Stamps</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-sourcepkg.html">3. Source packages (from old Packaging Manual)</a><ul> <li class="toctree-l2"><a class="reference internal" href="ap-pkg-sourcepkg.html#tools-for-processing-source-packages">3.1. Tools for processing source packages</a><ul> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#dpkg-source-packs-and-unpacks-debian-source-packages">3.1.1. <code class="docutils literal notranslate"><span class="pre">dpkg-source</span></code> - packs and unpacks Debian source packages</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#dpkg-buildpackage-overall-package-building-control-script">3.1.2. <code class="docutils literal notranslate"><span class="pre">dpkg-buildpackage</span></code> - overall package-building control script</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#dpkg-gencontrol-generates-binary-package-control-files">3.1.3. <code class="docutils literal notranslate"><span class="pre">dpkg-gencontrol</span></code> - generates binary package control files</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#dpkg-shlibdeps-calculates-shared-library-dependencies">3.1.4. <code class="docutils literal notranslate"><span class="pre">dpkg-shlibdeps</span></code> - calculates shared library dependencies</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#dpkg-distaddfile-adds-a-file-to-debian-files">3.1.5. <code class="docutils literal notranslate"><span class="pre">dpkg-distaddfile</span></code> - adds a file to <code class="docutils literal notranslate"><span class="pre">debian/files</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#dpkg-genchanges-generates-a-changes-upload-control-file">3.1.6. <code class="docutils literal notranslate"><span class="pre">dpkg-genchanges</span></code> - generates a <code class="docutils literal notranslate"><span class="pre">.changes</span></code> upload control file</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#dpkg-parsechangelog-produces-parsed-representation-of-a-changelog">3.1.7. <code class="docutils literal notranslate"><span class="pre">dpkg-parsechangelog</span></code> - produces parsed representation of a changelog</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#dpkg-architecture-information-about-the-build-and-host-system">3.1.8. <code class="docutils literal notranslate"><span class="pre">dpkg-architecture</span></code> - information about the build and host system</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ap-pkg-sourcepkg.html#the-debian-package-source-tree">3.2. The Debian package source tree</a><ul> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#debian-rules-the-main-building-script">3.2.1. <code class="docutils literal notranslate"><span class="pre">debian/rules</span></code> - the main building script</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#debian-substvars-and-variable-substitutions">3.2.2. <code class="docutils literal notranslate"><span class="pre">debian/substvars</span></code> and variable substitutions</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#debian-files">3.2.3. <code class="docutils literal notranslate"><span class="pre">debian/files</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#debian-tmp">3.2.4. <code class="docutils literal notranslate"><span class="pre">debian/tmp</span></code></a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ap-pkg-sourcepkg.html#source-packages-as-archives">3.3. Source packages as archives</a></li> <li class="toctree-l2"><a class="reference internal" href="ap-pkg-sourcepkg.html#unpacking-a-debian-source-package-without-dpkg-source">3.4. Unpacking a Debian source package without <code class="docutils literal notranslate"><span class="pre">dpkg-source</span></code></a><ul> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-sourcepkg.html#restrictions-on-objects-in-source-packages">3.4.1. Restrictions on objects in source packages</a></li> </ul> </li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-controlfields.html">4. Control files and their fields (from old Packaging Manual)</a><ul> <li class="toctree-l2"><a class="reference internal" href="ap-pkg-controlfields.html#syntax-of-control-files">4.1. Syntax of control files</a></li> <li class="toctree-l2"><a class="reference internal" href="ap-pkg-controlfields.html#list-of-fields">4.2. List of fields</a><ul> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-controlfields.html#filename-and-msdos-filename">4.2.1. <code class="docutils literal notranslate"><span class="pre">Filename</span></code> and <code class="docutils literal notranslate"><span class="pre">MSDOS-Filename</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-controlfields.html#size-and-md5sum">4.2.2. <code class="docutils literal notranslate"><span class="pre">Size</span></code> and <code class="docutils literal notranslate"><span class="pre">MD5sum</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-controlfields.html#status">4.2.3. <code class="docutils literal notranslate"><span class="pre">Status</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-controlfields.html#config-version">4.2.4. <code class="docutils literal notranslate"><span class="pre">Config-Version</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-controlfields.html#conffiles">4.2.5. <code class="docutils literal notranslate"><span class="pre">Conffiles</span></code></a></li> <li class="toctree-l3"><a class="reference internal" href="ap-pkg-controlfields.html#obsolete-fields">4.2.6. Obsolete fields</a></li> </ul> </li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-conffiles.html">5. Configuration file handling (from old Packaging Manual)</a><ul> <li class="toctree-l2"><a class="reference internal" href="ap-pkg-conffiles.html#automatic-handling-of-configuration-files-by-dpkg">5.1. Automatic handling of configuration files by <code class="docutils literal notranslate"><span class="pre">dpkg</span></code></a></li> <li class="toctree-l2"><a class="reference internal" href="ap-pkg-conffiles.html#fully-featured-maintainer-script-configuration-handling">5.2. Fully-featured maintainer script configuration handling</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-alternatives.html">6. Alternative versions of an interface - <code class="docutils literal notranslate"><span class="pre">update-alternatives</span></code> (from old Packaging Manual)</a></li> <li class="toctree-l1"><a class="reference internal" href="ap-pkg-diversions.html">7. Diversions - overriding a package’s version of a file (from old Packaging Manual)</a></li> <li class="toctree-l1"><a class="reference internal" href="ap-process.html">8. Debian Policy changes process</a><ul> <li class="toctree-l2"><a class="reference internal" href="ap-process.html#introduction">8.1. Introduction</a></li> <li class="toctree-l2"><a class="reference internal" href="ap-process.html#change-goals">8.2. Change Goals</a></li> <li class="toctree-l2"><a class="reference internal" href="ap-process.html#current-process">8.3. Current Process</a><ul> <li class="toctree-l3"><a class="reference internal" href="ap-process.html#state-a-more-information-required">8.3.1. State A: More information required</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-process.html#state-b-discussion">8.3.2. State B: Discussion</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-process.html#state-c-proposal">8.3.3. State C: Proposal</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-process.html#state-d-wording-proposed">8.3.4. State D: Wording proposed</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-process.html#state-e-seconded">8.3.5. State E: Seconded</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-process.html#state-f-accepted">8.3.6. State F: Accepted</a></li> <li class="toctree-l3"><a class="reference internal" href="ap-process.html#state-g-reject">8.3.7. State G: Reject</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="ap-process.html#other-tags">8.4. Other Tags</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ap-flowcharts.html">9. Maintainer script flowcharts</a></li> <li class="toctree-l1"><a class="reference internal" href="upgrading-checklist.html">10. Upgrading checklist</a><ul> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#about-the-checklist">10.1. About the checklist</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-7-0">10.2. Version 4.7.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-6-2">10.3. Version 4.6.2</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-6-1">10.4. Version 4.6.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-6-0">10.5. Version 4.6.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-5-1">10.6. Version 4.5.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-5-0">10.7. Version 4.5.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-4-1">10.8. Version 4.4.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-4-0">10.9. Version 4.4.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-3-0">10.10. Version 4.3.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-2-1">10.11. Version 4.2.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-2-0">10.12. Version 4.2.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-1-5">10.13. Version 4.1.5</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-1-4">10.14. Version 4.1.4</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-1-3">10.15. Version 4.1.3</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-1-2">10.16. Version 4.1.2</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-1-1">10.17. Version 4.1.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-1-0">10.18. Version 4.1.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-0-1">10.19. Version 4.0.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-4-0-0">10.20. Version 4.0.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-9-8">10.21. Version 3.9.8</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-9-7">10.22. Version 3.9.7</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-9-6">10.23. Version 3.9.6</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-9-5">10.24. Version 3.9.5</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-9-4">10.25. Version 3.9.4</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-9-3">10.26. Version 3.9.3</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-9-2">10.27. Version 3.9.2</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-9-1">10.28. Version 3.9.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-9-0">10.29. Version 3.9.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-8-4">10.30. Version 3.8.4</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-8-3">10.31. Version 3.8.3</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-8-2">10.32. Version 3.8.2</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-8-1">10.33. Version 3.8.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-8-0">10.34. Version 3.8.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-7-3">10.35. Version 3.7.3</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-7-2-2">10.36. Version 3.7.2.2</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-7-2">10.37. Version 3.7.2</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-7-1">10.38. Version 3.7.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-7-0">10.39. Version 3.7.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-6-2">10.40. Version 3.6.2</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-6-1">10.41. Version 3.6.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-6-0">10.42. Version 3.6.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-5-10">10.43. Version 3.5.10</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-5-9">10.44. Version 3.5.9</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-5-8">10.45. Version 3.5.8</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-5-7">10.46. Version 3.5.7</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-5-6">10.47. Version 3.5.6</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-5-5">10.48. Version 3.5.5</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-5-4">10.49. Version 3.5.4</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-5-3">10.50. Version 3.5.3</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-5-2">10.51. Version 3.5.2</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-5-1">10.52. Version 3.5.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-5-0">10.53. Version 3.5.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-2-1-1">10.54. Version 3.2.1.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-2-1">10.55. Version 3.2.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-2-0">10.56. Version 3.2.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-1-1">10.57. Version 3.1.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-1-0">10.58. Version 3.1.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-0-1">10.59. Version 3.0.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-3-0-0">10.60. Version 3.0.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-2-5-0">10.61. Version 2.5.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-2-4-1">10.62. Version 2.4.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-2-4-0">10.63. Version 2.4.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-2-3-0">10.64. Version 2.3.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-2-2-0">10.65. Version 2.2.0</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-2-1-3">10.66. Version 2.1.3</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-2-1-2">10.67. Version 2.1.2</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-2-1-1">10.68. Version 2.1.1</a></li> <li class="toctree-l2"><a class="reference internal" href="upgrading-checklist.html#version-2-1-0">10.69. Version 2.1.0</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="ap-license.html">11. License</a></li> </ul> </div> </section> </div> </div> <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer"> <a href="ch-scope.html" class="btn btn-neutral float-right" title="1. About this manual" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a> </div> <hr/> <div role="contentinfo"> <p></p> </div> </footer> </div> </div> </section> </div> <script> jQuery(function () { SphinxRtdTheme.Navigation.enable(true); }); </script> </body> </html>