| Offset 1, 4 lines modified | Offset 1, 4 lines modified | ||
| 1 | ·ea7a18143a3c440fa0a278138c639006·443944·doc·optional·debian-policy-ja_4.7.2.0_all.deb | 1 | ·ea7a18143a3c440fa0a278138c639006·443944·doc·optional·debian-policy-ja_4.7.2.0_all.deb |
| 2 | ·5f0c601b9f68c959558a9f1b6ec12dc6·437016·doc·optional·debian-policy-zh-cn_4.7.2.0_all.deb | 2 | ·5f0c601b9f68c959558a9f1b6ec12dc6·437016·doc·optional·debian-policy-zh-cn_4.7.2.0_all.deb |
| 3 | · | 3 | ·070c911d80db3c0592770733c99789c4·2426024·doc·optional·debian-policy_4.7.2.0_all.deb |
| Offset 1, 3 lines modified | Offset 1, 3 lines modified | ||
| 1 | -rw-r--r--···0········0········0········4·2025-02-27·06:35:02.000000·debian-binary | 1 | -rw-r--r--···0········0········0········4·2025-02-27·06:35:02.000000·debian-binary |
| 2 | -rw-r--r--···0········0········0·····363 | 2 | -rw-r--r--···0········0········0·····3632·2025-02-27·06:35:02.000000·control.tar.xz |
| 3 | -rw-r--r--···0········0········0··24 | 3 | -rw-r--r--···0········0········0··2422200·2025-02-27·06:35:02.000000·data.tar.xz |
| Offset 1, 12 lines modified | Offset 1, 12 lines modified | ||
| 1 | Package:·debian-policy | 1 | Package:·debian-policy |
| 2 | Version:·4.7.2.0 | 2 | Version:·4.7.2.0 |
| 3 | Architecture:·all | 3 | Architecture:·all |
| 4 | Maintainer:·Debian·Policy·Editors·<debian-policy@lists.debian.org> | 4 | Maintainer:·Debian·Policy·Editors·<debian-policy@lists.debian.org> |
| 5 | Installed-Size:·4 | 5 | Installed-Size:·4693 |
| 6 | Recommends:·libjs-jquery·(>=·3.6.0),·libjs-sphinxdoc·(>=·8.1),·sphinx-rtd-theme-common·(>=·3.0.2+dfsg) | 6 | Recommends:·libjs-jquery·(>=·3.6.0),·libjs-sphinxdoc·(>=·8.1),·sphinx-rtd-theme-common·(>=·3.0.2+dfsg) |
| 7 | Suggests:·doc-base | 7 | Suggests:·doc-base |
| 8 | Built-Using:·sphinx·(=·8.1.3-5) | 8 | Built-Using:·sphinx·(=·8.1.3-5) |
| 9 | Section:·doc | 9 | Section:·doc |
| 10 | Priority:·optional | 10 | Priority:·optional |
| 11 | Multi-Arch:·foreign | 11 | Multi-Arch:·foreign |
| 12 | Homepage:·https://www.debian.org/doc/devel-manuals#policy | 12 | Homepage:·https://www.debian.org/doc/devel-manuals#policy |
| Offset 83, 40 lines modified | Offset 83, 40 lines modified | ||
| 83 | -rw-r--r--···0·root·········(0)·root·········(0)·····6978·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/js/versions.js | 83 | -rw-r--r--···0·root·········(0)·root·········(0)·····6978·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/js/versions.js |
| 84 | -rw-r--r--···0·root·········(0)·root·········(0)·······90·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/minus.png | 84 | -rw-r--r--···0·root·········(0)·root·········(0)·······90·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/minus.png |
| 85 | -rw-r--r--···0·root·········(0)·root·········(0)·······90·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/plus.png | 85 | -rw-r--r--···0·root·········(0)·root·········(0)·······90·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/plus.png |
| 86 | -rw-r--r--···0·root·········(0)·root·········(0)·····4929·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/pygments.css | 86 | -rw-r--r--···0·root·········(0)·root·········(0)·····4929·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/pygments.css |
| 87 | -rw-r--r--···0·root·········(0)·root·········(0)····10549·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-flowcharts.html | 87 | -rw-r--r--···0·root·········(0)·root·········(0)····10549·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-flowcharts.html |
| 88 | -rw-r--r--···0·root·········(0)·root·········(0)·····8192·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-license.html | 88 | -rw-r--r--···0·root·········(0)·root·········(0)·····8192·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-license.html |
| 89 | -rw-r--r--···0·root·········(0)·root·········(0)····10176·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-pkg-alternatives.html | 89 | -rw-r--r--···0·root·········(0)·root·········(0)····10176·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-pkg-alternatives.html |
| 90 | -rw-r--r--···0·root·········(0)·root·········(0)····208 | 90 | -rw-r--r--···0·root·········(0)·root·········(0)····20869·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-pkg-binarypkg.html |
| 91 | -rw-r--r--···0·root·········(0)·root·········(0)····152 | 91 | -rw-r--r--···0·root·········(0)·root·········(0)····15269·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-pkg-conffiles.html |
| 92 | -rw-r--r--···0·root·········(0)·root·········(0)····157 | 92 | -rw-r--r--···0·root·········(0)·root·········(0)····15730·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-pkg-controlfields.html |
| 93 | -rw-r--r--···0·root·········(0)·root·········(0)····17 | 93 | -rw-r--r--···0·root·········(0)·root·········(0)····17211·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-pkg-diversions.html |
| 94 | -rw-r--r--···0·root·········(0)·root·········(0)····113 | 94 | -rw-r--r--···0·root·········(0)·root·········(0)····11366·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-pkg-scope.html |
| 95 | -rw-r--r--···0·root·········(0)·root·········(0)····382 | 95 | -rw-r--r--···0·root·········(0)·root·········(0)····38225·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-pkg-sourcepkg.html |
| 96 | -rw-r--r--···0·root·········(0)·root·········(0)····222 | 96 | -rw-r--r--···0·root·········(0)·root·········(0)····22257·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ap-process.html |
| 97 | -rw-r--r--···0·root·········(0)·root·········(0)····37 | 97 | -rw-r--r--···0·root·········(0)·root·········(0)····37165·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-archive.html |
| 98 | -rw-r--r--···0·root·········(0)·root·········(0)····4575 | 98 | -rw-r--r--···0·root·········(0)·root·········(0)····45752·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-binary.html |
| 99 | -rw-r--r--···0·root·········(0)·root·········(0)···1261 | 99 | -rw-r--r--···0·root·········(0)·root·········(0)···126117·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-controlfields.html |
| 100 | -rw-r--r--···0·root·········(0)·root·········(0)····5902 | 100 | -rw-r--r--···0·root·········(0)·root·········(0)····59023·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-customized-programs.html |
| 101 | -rw-r--r--···0·root·········(0)·root·········(0)····403 | 101 | -rw-r--r--···0·root·········(0)·root·········(0)····40320·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-docs.html |
| 102 | -rw-r--r--···0·root·········(0)·root·········(0)····79768·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-files.html | 102 | -rw-r--r--···0·root·········(0)·root·········(0)····79768·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-files.html |
| 103 | -rw-r--r--···0·root·········(0)·root·········(0)····45912·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-maintainerscripts.html | 103 | -rw-r--r--···0·root·········(0)·root·········(0)····45912·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-maintainerscripts.html |
| 104 | -rw-r--r--···0·root·········(0)·root·········(0)····90780·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-opersys.html | 104 | -rw-r--r--···0·root·········(0)·root·········(0)····90780·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-opersys.html |
| 105 | -rw-r--r--···0·root·········(0)·root·········(0)····75943·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-relationships.html | 105 | -rw-r--r--···0·root·········(0)·root·········(0)····75943·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-relationships.html |
| 106 | -rw-r--r--···0·root·········(0)·root·········(0)····23695·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-scope.html | 106 | -rw-r--r--···0·root·········(0)·root·········(0)····23695·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-scope.html |
| 107 | -rw-r--r--···0·root·········(0)·root·········(0)····97480·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-sharedlibs.html | 107 | -rw-r--r--···0·root·········(0)·root·········(0)····97480·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-sharedlibs.html |
| 108 | -rw-r--r--···0·root·········(0)·root·········(0)····93609·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-source.html | 108 | -rw-r--r--···0·root·········(0)·root·········(0)····93609·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/ch-source.html |
| 109 | -rw-r--r--···0·root·········(0)·root·········(0)·····6934·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/genindex.html | 109 | -rw-r--r--···0·root·········(0)·root·········(0)·····6934·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/genindex.html |
| 110 | -rw-r--r--···0·root·········(0)·root·········(0)····65409·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/index.html | 110 | -rw-r--r--···0·root·········(0)·root·········(0)····65409·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/index.html |
| 111 | -rw-r--r--···0·root·········(0)·root·········(0)·····4932·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/objects.inv | 111 | -rw-r--r--···0·root·········(0)·root·········(0)·····4932·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/objects.inv |
| 112 | -rw-r--r--···0·root·········(0)·root·········(0)·····6487·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/search.html | 112 | -rw-r--r--···0·root·········(0)·root·········(0)·····6487·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/search.html |
| 113 | -rw-r--r--···0·root·········(0)·root·········(0)···1029 | 113 | -rw-r--r--···0·root·········(0)·root·········(0)···102968·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/searchindex.js |
| 114 | -rw-r--r--···0·root·········(0)·root·········(0)···135207·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/upgrading-checklist.html | 114 | -rw-r--r--···0·root·········(0)·root·········(0)···135207·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/upgrading-checklist.html |
| 115 | -rw-r--r--···0·root·········(0)·root·········(0)···926 | 115 | -rw-r--r--···0·root·········(0)·root·········(0)···926622·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.pdf.gz |
| 116 | -rw-r--r--···0·root·········(0)·root·········(0)···150850·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.txt.gz | 116 | -rw-r--r--···0·root·········(0)·root·········(0)···150850·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.txt.gz |
| 117 | -rw-r--r--···0·root·········(0)·root·········(0)····23779·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/upgrading-checklist.txt.gz | 117 | -rw-r--r--···0·root·········(0)·root·········(0)····23779·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/upgrading-checklist.txt.gz |
| 118 | -rw-r--r--···0·root·········(0)·root·········(0)·····4713·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/virtual-package-names-list.yaml.gz | 118 | -rw-r--r--···0·root·········(0)·root·········(0)·····4713·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/virtual-package-names-list.yaml.gz |
| 119 | drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc-base/ | 119 | drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc-base/ |
| 120 | -rw-r--r--···0·root·········(0)·root·········(0)······419·2025-02-27·06:35:02.000000·./usr/share/doc-base/debian-policy.autopkgtest | 120 | -rw-r--r--···0·root·········(0)·root·········(0)······419·2025-02-27·06:35:02.000000·./usr/share/doc-base/debian-policy.autopkgtest |
| 121 | -rw-r--r--···0·root·········(0)·root·········(0)······520·2025-02-27·06:35:02.000000·./usr/share/doc-base/debian-policy.copyright-format-1.0 | 121 | -rw-r--r--···0·root·········(0)·root·········(0)······520·2025-02-27·06:35:02.000000·./usr/share/doc-base/debian-policy.copyright-format-1.0 |
| 122 | -rw-r--r--···0·root·········(0)·root·········(0)······517·2025-02-27·06:35:02.000000·./usr/share/doc-base/debian-policy.debconf-spec | 122 | -rw-r--r--···0·root·········(0)·root·········(0)······517·2025-02-27·06:35:02.000000·./usr/share/doc-base/debian-policy.debconf-spec |
| Offset 127, 15 lines modified | Offset 127, 15 lines modified | ||
| 127 | drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/info/ | 127 | drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/info/ |
| 128 | -rw-r--r--···0·root·········(0)·root·········(0)····27052·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy-install-conffiles.png | 128 | -rw-r--r--···0·root·········(0)·root·········(0)····27052·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy-install-conffiles.png |
| 129 | -rw-r--r--···0·root·········(0)·root·········(0)····23405·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy-install.png | 129 | -rw-r--r--···0·root·········(0)·root·········(0)····23405·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy-install.png |
| 130 | -rw-r--r--···0·root·········(0)·root·········(0)····16992·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy-purge.png | 130 | -rw-r--r--···0·root·········(0)·root·········(0)····16992·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy-purge.png |
| 131 | -rw-r--r--···0·root·········(0)·root·········(0)····32427·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy-remove-purge.png | 131 | -rw-r--r--···0·root·········(0)·root·········(0)····32427·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy-remove-purge.png |
| 132 | -rw-r--r--···0·root·········(0)·root·········(0)····23345·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy-remove.png | 132 | -rw-r--r--···0·root·········(0)·root·········(0)····23345·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy-remove.png |
| 133 | -rw-r--r--···0·root·········(0)·root·········(0)····88057·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy-upgrade.png | 133 | -rw-r--r--···0·root·········(0)·root·········(0)····88057·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy-upgrade.png |
| 134 | -rw-r--r--···0·root·········(0)·root·········(0)···1 | 134 | -rw-r--r--···0·root·········(0)·root·········(0)···160525·2025-02-27·06:35:02.000000·./usr/share/info/debian-policy.info.gz |
| 135 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/css/badge_only.css·->·../../../../../sphinx_rtd_theme/static/css/badge_only.css | 135 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/css/badge_only.css·->·../../../../../sphinx_rtd_theme/static/css/badge_only.css |
| 136 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/css/theme.css·->·../../../../../sphinx_rtd_theme/static/css/theme.css | 136 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/css/theme.css·->·../../../../../sphinx_rtd_theme/static/css/theme.css |
| 137 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/doctools.js·->·../../../../javascript/sphinxdoc/1.0/doctools.js | 137 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/doctools.js·->·../../../../javascript/sphinxdoc/1.0/doctools.js |
| 138 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/fonts/Lato-Bold.ttf·->·../../../../../sphinx_rtd_theme/static/fonts/Lato-Bold.ttf | 138 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/fonts/Lato-Bold.ttf·->·../../../../../sphinx_rtd_theme/static/fonts/Lato-Bold.ttf |
| 139 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/fonts/Lato-Bold.woff2·->·../../../../../sphinx_rtd_theme/static/fonts/Lato-Bold.woff2 | 139 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/fonts/Lato-Bold.woff2·->·../../../../../sphinx_rtd_theme/static/fonts/Lato-Bold.woff2 |
| 140 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/fonts/Lato-BoldItalic.ttf·->·../../../../../sphinx_rtd_theme/static/fonts/Lato-BoldItalic.ttf | 140 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/fonts/Lato-BoldItalic.ttf·->·../../../../../sphinx_rtd_theme/static/fonts/Lato-BoldItalic.ttf |
| 141 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/fonts/Lato-BoldItalic.woff2·->·../../../../../sphinx_rtd_theme/static/fonts/Lato-BoldItalic.woff2 | 141 | lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-02-27·06:35:02.000000·./usr/share/doc/debian-policy/policy.html/_static/fonts/Lato-BoldItalic.woff2·->·../../../../../sphinx_rtd_theme/static/fonts/Lato-BoldItalic.woff2 |
| Offset 106, 38 lines modified | Offset 106, 38 lines modified | ||
| 106 | ···········<div·itemprop="articleBody"> | 106 | ···········<div·itemprop="articleBody"> |
| 107 | ············· | 107 | ············· |
| 108 | ··<section·id="binary-packages-from-old-packaging-manual"> | 108 | ··<section·id="binary-packages-from-old-packaging-manual"> |
| 109 | <h1><span·class="section-number">2.·</span>Binary·packages·(from·old·Packaging·Manual)<a·class="headerlink"·href="#binary-packages-from-old-packaging-manual"·title="Link·to·this·heading"></a></h1> | 109 | <h1><span·class="section-number">2.·</span>Binary·packages·(from·old·Packaging·Manual)<a·class="headerlink"·href="#binary-packages-from-old-packaging-manual"·title="Link·to·this·heading"></a></h1> |
| 110 | <p>See·<em·class="manpage">deb(5)</em>·and·<a·class="reference·internal"·href="#s-pkg-controlarea"><span·class="std·std-ref">Binary·package·metadata·files</span></a>.</p> | 110 | <p>See·<em·class="manpage">deb(5)</em>·and·<a·class="reference·internal"·href="#s-pkg-controlarea"><span·class="std·std-ref">Binary·package·metadata·files</span></a>.</p> |
| 111 | <section·id="creating-package-files-dpkg-deb"> | 111 | <section·id="creating-package-files-dpkg-deb"> |
| 112 | <span·id="s-pkg-bincreating"></span><h2><span·class="section-number">2.1.·</span>Creating·package·files·-·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-deb</span></code><a·class="headerlink"·href="#creating-package-files-dpkg-deb"·title="Link·to·this·heading"></a></h2> | 112 | <span·id="s-pkg-bincreating"></span><h2><span·class="section-number">2.1.·</span>Creating·package·files·-·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-deb</span></code><a·class="headerlink"·href="#creating-package-files-dpkg-deb"·title="Link·to·this·heading"></a></h2> |
| 113 | <p>All·manipulation·of·binary·package·files·is·done·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-deb</span></code>;·it | 113 | <p>All·manipulation·of·binary·package·files·is·done·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-deb</span></code>;·it’s |
| 114 | the·only·program·that·has·knowledge·of·the·format.·(<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-deb</span></code>·may·be | 114 | the·only·program·that·has·knowledge·of·the·format.·(<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-deb</span></code>·may·be |
| 115 | invoked·by·calling·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>,·as·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·will·spot·that·the·options | 115 | invoked·by·calling·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>,·as·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·will·spot·that·the·options |
| 116 | requested·are·appropriate·to·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-deb</span></code>·and·invoke·that·instead·with | 116 | requested·are·appropriate·to·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-deb</span></code>·and·invoke·that·instead·with |
| 117 | the·same·arguments.)</p> | 117 | the·same·arguments.)</p> |
| 118 | <p>In·order·to·create·a·binary·package,·you·must·make·a·directory·tree | 118 | <p>In·order·to·create·a·binary·package,·you·must·make·a·directory·tree |
| 119 | which·contains·all·the·files·and·directories·you·want·to·have·in·the | 119 | which·contains·all·the·files·and·directories·you·want·to·have·in·the |
| 120 | file·system·data·part·of·the·package.·In·Debian-format·source·packages, | 120 | file·system·data·part·of·the·package.·In·Debian-format·source·packages, |
| 121 | this·directory·is·usually·either·<code·class="docutils·literal·notranslate"><span·class="pre">debian/tmp</span></code>·or·<code·class="docutils·literal·notranslate"><span·class="pre">debian/pkg</span></code>, | 121 | this·directory·is·usually·either·<code·class="docutils·literal·notranslate"><span·class="pre">debian/tmp</span></code>·or·<code·class="docutils·literal·notranslate"><span·class="pre">debian/pkg</span></code>, |
| 122 | relative·to·the·top·of·the·package | 122 | relative·to·the·top·of·the·package’s·source·tree.</p> |
| 123 | <p>They·should·have·the·locations·(relative·to·the·root·of·the·directory | 123 | <p>They·should·have·the·locations·(relative·to·the·root·of·the·directory |
| 124 | tree·you | 124 | tree·you’re·constructing)·ownerships·and·permissions·which·you·want·them |
| 125 | to·have·on·the·system·when·they·are·installed.</p> | 125 | to·have·on·the·system·when·they·are·installed.</p> |
| 126 | <p>With·current·versions·of·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·the·uid/username·and·gid/groupname | 126 | <p>With·current·versions·of·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·the·uid/username·and·gid/groupname |
| 127 | mappings·for·the·users·and·groups·being·used·should·be·the·same·on·the | 127 | mappings·for·the·users·and·groups·being·used·should·be·the·same·on·the |
| 128 | system·where·the·package·is·built·and·the·one·where·it·is·installed.</p> | 128 | system·where·the·package·is·built·and·the·one·where·it·is·installed.</p> |
| 129 | <p>You·need·to·add·one·special·directory·to·the·root·of·the·miniature·file | 129 | <p>You·need·to·add·one·special·directory·to·the·root·of·the·miniature·file |
| 130 | system·tree·you | 130 | system·tree·you’re·creating:·<code·class="docutils·literal·notranslate"><span·class="pre">DEBIAN</span></code>.·It·should·contain·the·control |
| 131 | information·files,·notably·the·binary·package·control·file·(see | 131 | information·files,·notably·the·binary·package·control·file·(see |
| 132 | <a·class="reference·internal"·href="#s-pkg-controlfile"><span·class="std·std-ref">The·binary·package·control·file:·control</span></a>).</p> | 132 | <a·class="reference·internal"·href="#s-pkg-controlfile"><span·class="std·std-ref">The·binary·package·control·file:·control</span></a>).</p> |
| 133 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">DEBIAN</span></code>·directory·will·not·appear·in·the·file·system·archive·of | 133 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">DEBIAN</span></code>·directory·will·not·appear·in·the·file·system·archive·of |
| 134 | the·package,·and·so·won | 134 | the·package,·and·so·won’t·be·installed·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·when·the·package·is |
| 135 | unpacked.</p> | 135 | unpacked.</p> |
| 136 | <p>When·you | 136 | <p>When·you’ve·prepared·the·package,·you·should·invoke:</p> |
| 137 | <div·class="highlight-default·notranslate"><div·class="highlight"><pre><span></span><span·class="n">dpkg</span>·<span·class="o">--</span><span·class="n">build</span>·<span·class="n">directory</span> | 137 | <div·class="highlight-default·notranslate"><div·class="highlight"><pre><span></span><span·class="n">dpkg</span>·<span·class="o">--</span><span·class="n">build</span>·<span·class="n">directory</span> |
| 138 | </pre></div> | 138 | </pre></div> |
| 139 | </div> | 139 | </div> |
| 140 | <p>This·will·build·the·package·in·<code·class="docutils·literal·notranslate"><span·class="pre">directory.deb</span></code>.·(<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·knows·that | 140 | <p>This·will·build·the·package·in·<code·class="docutils·literal·notranslate"><span·class="pre">directory.deb</span></code>.·(<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·knows·that |
| 141 | <code·class="docutils·literal·notranslate"><span·class="pre">--build</span></code>·is·a·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-deb</span></code>·option,·so·it·invokes·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-deb</span></code>·with | 141 | <code·class="docutils·literal·notranslate"><span·class="pre">--build</span></code>·is·a·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-deb</span></code>·option,·so·it·invokes·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-deb</span></code>·with |
| 142 | the·same·arguments·to·build·the·package.)</p> | 142 | the·same·arguments·to·build·the·package.)</p> |
| 143 | <p>See·the·<em·class="manpage">dpkg-deb(8)</em>·man·page·for·details·of·how·to·examine·the | 143 | <p>See·the·<em·class="manpage">dpkg-deb(8)</em>·man·page·for·details·of·how·to·examine·the |
| Offset 159, 18 lines modified | Offset 159, 18 lines modified | ||
| 159 | files·with·names·known·to·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>.·It·will·treat·the·contents·of·these | 159 | files·with·names·known·to·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>.·It·will·treat·the·contents·of·these |
| 160 | files·specially·-·some·of·them·contain·information·used·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·when | 160 | files·specially·-·some·of·them·contain·information·used·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·when |
| 161 | installing·or·removing·the·package;·others·are·scripts·which·the·package | 161 | installing·or·removing·the·package;·others·are·scripts·which·the·package |
| 162 | maintainer·wants·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·to·run.</p> | 162 | maintainer·wants·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·to·run.</p> |
| 163 | <p>It·is·possible·to·put·other·files·in·the·package·metadata·archive·member, | 163 | <p>It·is·possible·to·put·other·files·in·the·package·metadata·archive·member, |
| 164 | but·this·is·not·generally·a·good·idea·(though·they·will·largely·be·ignored).</p> | 164 | but·this·is·not·generally·a·good·idea·(though·they·will·largely·be·ignored).</p> |
| 165 | <p>Here·is·a·brief·list·of·the·package·metadata·files·supported·by | 165 | <p>Here·is·a·brief·list·of·the·package·metadata·files·supported·by |
| 166 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·and·a·summary·of·what·they | 166 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·and·a·summary·of·what·they’re·used·for.</p> |
| 167 | <dl> | 167 | <dl> |
| 168 | <dt><code·class="docutils·literal·notranslate"><span·class="pre">control</span></code></dt><dd><p>This·is·the·key·description·file·used·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>.·It·specifies·the | 168 | <dt><code·class="docutils·literal·notranslate"><span·class="pre">control</span></code></dt><dd><p>This·is·the·key·description·file·used·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>.·It·specifies·the |
| 169 | package | 169 | package’s·name·and·version,·gives·its·description·for·the·user, |
| 170 | states·its·relationships·with·other·packages,·and·so·forth.·See | 170 | states·its·relationships·with·other·packages,·and·so·forth.·See |
| 171 | <a·class="reference·internal"·href="ch-controlfields.html#s-sourcecontrolfiles"><span·class="std·std-ref">Debian·source·package·template·control·files·–·debian/control</span></a>·and | 171 | <a·class="reference·internal"·href="ch-controlfields.html#s-sourcecontrolfiles"><span·class="std·std-ref">Debian·source·package·template·control·files·–·debian/control</span></a>·and |
| 172 | <a·class="reference·internal"·href="ch-controlfields.html#s-binarycontrolfiles"><span·class="std·std-ref">Debian·binary·package·control·files·–·DEBIAN/control</span></a>.</p> | 172 | <a·class="reference·internal"·href="ch-controlfields.html#s-binarycontrolfiles"><span·class="std·std-ref">Debian·binary·package·control·files·–·DEBIAN/control</span></a>.</p> |
| 173 | <p>It·is·usually·generated·automatically·from·information·in·the | 173 | <p>It·is·usually·generated·automatically·from·information·in·the |
| 174 | source·package·by·the·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-gencontrol</span></code>·program,·and·with | 174 | source·package·by·the·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-gencontrol</span></code>·program,·and·with |
| 175 | assistance·from·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-shlibdeps</span></code>.·See·<a·class="reference·internal"·href="ap-pkg-sourcepkg.html"><span·class="doc">Source·packages·(from·old·Packaging·Manual)</span></a>.</p> | 175 | assistance·from·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-shlibdeps</span></code>.·See·<a·class="reference·internal"·href="ap-pkg-sourcepkg.html"><span·class="doc">Source·packages·(from·old·Packaging·Manual)</span></a>.</p> |
| 176 | </dd> | 176 | </dd> |
| Offset 197, 16 lines modified | Offset 197, 16 lines modified | ||
| 197 | on·<a·class="reference·internal"·href="ch-sharedlibs.html#s-shlibs"><span·class="std·std-ref">The·shlibs·File·Format</span></a>.</p> | 197 | on·<a·class="reference·internal"·href="ch-sharedlibs.html#s-shlibs"><span·class="std·std-ref">The·shlibs·File·Format</span></a>.</p> |
| 198 | </dd> | 198 | </dd> |
| 199 | </dl> | 199 | </dl> |
| 200 | </section> | 200 | </section> |
| 201 | <section·id="the-binary-package-control-file-control"> | 201 | <section·id="the-binary-package-control-file-control"> |
| 202 | <span·id="s-pkg-controlfile"></span><h2><span·class="section-number">2.3.·</span>The·binary·package·control·file:·<code·class="docutils·literal·notranslate"><span·class="pre">control</span></code><a·class="headerlink"·href="#the-binary-package-control-file-control"·title="Link·to·this·heading"></a></h2> | 202 | <span·id="s-pkg-controlfile"></span><h2><span·class="section-number">2.3.·</span>The·binary·package·control·file:·<code·class="docutils·literal·notranslate"><span·class="pre">control</span></code><a·class="headerlink"·href="#the-binary-package-control-file-control"·title="Link·to·this·heading"></a></h2> |
| 203 | <p>The·most·important·package·metadata·file·used·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·when·it | 203 | <p>The·most·important·package·metadata·file·used·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·when·it |
| 204 | installs·a·package·is·<code·class="docutils·literal·notranslate"><span·class="pre">control</span></code>.·It·contains·all·the·package | 204 | installs·a·package·is·<code·class="docutils·literal·notranslate"><span·class="pre">control</span></code>.·It·contains·all·the·package’s·“vital |
| 205 | statistics | 205 | statistics”.</p> |
| 206 | <p>The·binary·package·control·files·of·packages·built·from·Debian·sources | 206 | <p>The·binary·package·control·files·of·packages·built·from·Debian·sources |
| 207 | are·made·by·a·special·tool,·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-gencontrol</span></code>,·which·reads | 207 | are·made·by·a·special·tool,·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-gencontrol</span></code>,·which·reads |
| 208 | <code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code>·and·<code·class="docutils·literal·notranslate"><span·class="pre">debian/changelog</span></code>·to·find·the·information·it | 208 | <code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code>·and·<code·class="docutils·literal·notranslate"><span·class="pre">debian/changelog</span></code>·to·find·the·information·it |
| 209 | needs.·See·<a·class="reference·internal"·href="ap-pkg-sourcepkg.html"><span·class="doc">Source·packages·(from·old·Packaging·Manual)</span></a>·for·more·details.</p> | 209 | needs.·See·<a·class="reference·internal"·href="ap-pkg-sourcepkg.html"><span·class="doc">Source·packages·(from·old·Packaging·Manual)</span></a>·for·more·details.</p> |
| 210 | <p>The·fields·in·binary·package·control·files·are·listed·in | 210 | <p>The·fields·in·binary·package·control·files·are·listed·in |
| 211 | <a·class="reference·internal"·href="ch-controlfields.html#s-binarycontrolfiles"><span·class="std·std-ref">Debian·binary·package·control·files·–·DEBIAN/control</span></a>.</p> | 211 | <a·class="reference·internal"·href="ch-controlfields.html#s-binarycontrolfiles"><span·class="std·std-ref">Debian·binary·package·control·files·–·DEBIAN/control</span></a>.</p> |
| 212 | <p>A·description·of·the·syntax·of·control·files·and·the·purpose·of·the | 212 | <p>A·description·of·the·syntax·of·control·files·and·the·purpose·of·the |
| Offset 34, 36 lines modified | Offset 34, 36 lines modified | ||
| 34 | ····*·2.·Binary·packages·(from·old·Packaging·Manual) | 34 | ····*·2.·Binary·packages·(from·old·Packaging·Manual) |
| 35 | ····*·_\x8V_\x8i_\x8e_\x8w_\x8·_\x8p_\x8a_\x8g_\x8e_\x8·_\x8s_\x8o_\x8u_\x8r_\x8c_\x8e | 35 | ····*·_\x8V_\x8i_\x8e_\x8w_\x8·_\x8p_\x8a_\x8g_\x8e_\x8·_\x8s_\x8o_\x8u_\x8r_\x8c_\x8e |
| 36 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t | 36 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t |
| 37 | =============================================================================== | 37 | =============================================================================== |
| 38 | *\x8**\x8**\x8**\x8**\x8**\x8*·2\x82.\x8.·B\x8Bi\x8in\x8na\x8ar\x8ry\x8y·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s·(\x8(f\x8fr\x8ro\x8om\x8m·o\x8ol\x8ld\x8d·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8gi\x8in\x8ng\x8g·M\x8Ma\x8an\x8nu\x8ua\x8al\x8l)\x8)_\x8?\x8·*\x8**\x8**\x8**\x8**\x8**\x8* | 38 | *\x8**\x8**\x8**\x8**\x8**\x8*·2\x82.\x8.·B\x8Bi\x8in\x8na\x8ar\x8ry\x8y·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s·(\x8(f\x8fr\x8ro\x8om\x8m·o\x8ol\x8ld\x8d·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8gi\x8in\x8ng\x8g·M\x8Ma\x8an\x8nu\x8ua\x8al\x8l)\x8)_\x8?\x8·*\x8**\x8**\x8**\x8**\x8**\x8* |
| 39 | See·d\x8de\x8eb\x8b(\x8(5\x85)\x8)·and·_\x8B_\x8i_\x8n_\x8a_\x8r_\x8y_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8·_\x8m_\x8e_\x8t_\x8a_\x8d_\x8a_\x8t_\x8a_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s. | 39 | See·d\x8de\x8eb\x8b(\x8(5\x85)\x8)·and·_\x8B_\x8i_\x8n_\x8a_\x8r_\x8y_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8·_\x8m_\x8e_\x8t_\x8a_\x8d_\x8a_\x8t_\x8a_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s. |
| 40 | *\x8**\x8**\x8**\x8**\x8*·2\x82.\x8.1\x81.\x8.·C\x8Cr\x8re\x8ea\x8at\x8ti\x8in\x8ng\x8g·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·f\x8fi\x8il\x8le\x8es\x8s·-\x8-·d\x8dp\x8pk\x8kg\x8g-\x8-d\x8de\x8eb\x8b_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 40 | *\x8**\x8**\x8**\x8**\x8*·2\x82.\x8.1\x81.\x8.·C\x8Cr\x8re\x8ea\x8at\x8ti\x8in\x8ng\x8g·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·f\x8fi\x8il\x8le\x8es\x8s·-\x8-·d\x8dp\x8pk\x8kg\x8g-\x8-d\x8de\x8eb\x8b_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 41 | All·manipulation·of·binary·package·files·is·done·by·dpkg-deb;·it | 41 | All·manipulation·of·binary·package·files·is·done·by·dpkg-deb;·it’s·the·only |
| 42 | program·that·has·knowledge·of·the·format.·(dpkg-deb·may·be·invoked·by·calling | 42 | program·that·has·knowledge·of·the·format.·(dpkg-deb·may·be·invoked·by·calling |
| 43 | dpkg,·as·dpkg·will·spot·that·the·options·requested·are·appropriate·to·dpkg-deb | 43 | dpkg,·as·dpkg·will·spot·that·the·options·requested·are·appropriate·to·dpkg-deb |
| 44 | and·invoke·that·instead·with·the·same·arguments.) | 44 | and·invoke·that·instead·with·the·same·arguments.) |
| 45 | In·order·to·create·a·binary·package,·you·must·make·a·directory·tree·which | 45 | In·order·to·create·a·binary·package,·you·must·make·a·directory·tree·which |
| 46 | contains·all·the·files·and·directories·you·want·to·have·in·the·file·system·data | 46 | contains·all·the·files·and·directories·you·want·to·have·in·the·file·system·data |
| 47 | part·of·the·package.·In·Debian-format·source·packages,·this·directory·is | 47 | part·of·the·package.·In·Debian-format·source·packages,·this·directory·is |
| 48 | usually·either·debian/tmp·or·debian/pkg,·relative·to·the·top·of·the·package | 48 | usually·either·debian/tmp·or·debian/pkg,·relative·to·the·top·of·the·package’s |
| 49 | source·tree. | 49 | source·tree. |
| 50 | They·should·have·the·locations·(relative·to·the·root·of·the·directory·tree | 50 | They·should·have·the·locations·(relative·to·the·root·of·the·directory·tree |
| 51 | you | 51 | you’re·constructing)·ownerships·and·permissions·which·you·want·them·to·have·on |
| 52 | the·system·when·they·are·installed. | 52 | the·system·when·they·are·installed. |
| 53 | With·current·versions·of·dpkg·the·uid/username·and·gid/groupname·mappings·for | 53 | With·current·versions·of·dpkg·the·uid/username·and·gid/groupname·mappings·for |
| 54 | the·users·and·groups·being·used·should·be·the·same·on·the·system·where·the | 54 | the·users·and·groups·being·used·should·be·the·same·on·the·system·where·the |
| 55 | package·is·built·and·the·one·where·it·is·installed. | 55 | package·is·built·and·the·one·where·it·is·installed. |
| 56 | You·need·to·add·one·special·directory·to·the·root·of·the·miniature·file·system | 56 | You·need·to·add·one·special·directory·to·the·root·of·the·miniature·file·system |
| 57 | tree·you | 57 | tree·you’re·creating:·DEBIAN.·It·should·contain·the·control·information·files, |
| 58 | notably·the·binary·package·control·file·(see·_\x8T_\x8h_\x8e_\x8·_\x8b_\x8i_\x8n_\x8a_\x8r_\x8y_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8·_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8: | 58 | notably·the·binary·package·control·file·(see·_\x8T_\x8h_\x8e_\x8·_\x8b_\x8i_\x8n_\x8a_\x8r_\x8y_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8·_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8: |
| 59 | _\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l). | 59 | _\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l). |
| 60 | The·DEBIAN·directory·will·not·appear·in·the·file·system·archive·of·the·package, | 60 | The·DEBIAN·directory·will·not·appear·in·the·file·system·archive·of·the·package, |
| 61 | and·so·won | 61 | and·so·won’t·be·installed·by·dpkg·when·the·package·is·unpacked. |
| 62 | When·you | 62 | When·you’ve·prepared·the·package,·you·should·invoke: |
| 63 | dpkg·--build·directory | 63 | dpkg·--build·directory |
| 64 | This·will·build·the·package·in·directory.deb.·(dpkg·knows·that·--build·is·a | 64 | This·will·build·the·package·in·directory.deb.·(dpkg·knows·that·--build·is·a |
| 65 | dpkg-deb·option,·so·it·invokes·dpkg-deb·with·the·same·arguments·to·build·the | 65 | dpkg-deb·option,·so·it·invokes·dpkg-deb·with·the·same·arguments·to·build·the |
| 66 | package.) | 66 | package.) |
| 67 | See·the·d\x8dp\x8pk\x8kg\x8g-\x8-d\x8de\x8eb\x8b(\x8(8\x88)\x8)·man·page·for·details·of·how·to·examine·the·contents·of·this | 67 | See·the·d\x8dp\x8pk\x8kg\x8g-\x8-d\x8de\x8eb\x8b(\x8(8\x88)\x8)·man·page·for·details·of·how·to·examine·the·contents·of·this |
| 68 | newly-created·file.·You·may·find·the·output·of·following·commands·enlightening: | 68 | newly-created·file.·You·may·find·the·output·of·following·commands·enlightening: |
| 69 | dpkg-deb·--info·filename.deb | 69 | dpkg-deb·--info·filename.deb |
| Offset 75, 17 lines modified | Offset 75, 17 lines modified | ||
| 75 | The·package·metadata·portion·of·a·binary·package·is·a·collection·of·files·with | 75 | The·package·metadata·portion·of·a·binary·package·is·a·collection·of·files·with |
| 76 | names·known·to·dpkg.·It·will·treat·the·contents·of·these·files·specially·-·some | 76 | names·known·to·dpkg.·It·will·treat·the·contents·of·these·files·specially·-·some |
| 77 | of·them·contain·information·used·by·dpkg·when·installing·or·removing·the | 77 | of·them·contain·information·used·by·dpkg·when·installing·or·removing·the |
| 78 | package;·others·are·scripts·which·the·package·maintainer·wants·dpkg·to·run. | 78 | package;·others·are·scripts·which·the·package·maintainer·wants·dpkg·to·run. |
| 79 | It·is·possible·to·put·other·files·in·the·package·metadata·archive·member,·but | 79 | It·is·possible·to·put·other·files·in·the·package·metadata·archive·member,·but |
| 80 | this·is·not·generally·a·good·idea·(though·they·will·largely·be·ignored). | 80 | this·is·not·generally·a·good·idea·(though·they·will·largely·be·ignored). |
| 81 | Here·is·a·brief·list·of·the·package·metadata·files·supported·by·dpkg·and·a | 81 | Here·is·a·brief·list·of·the·package·metadata·files·supported·by·dpkg·and·a |
| 82 | summary·of·what·they | 82 | summary·of·what·they’re·used·for. |
| 83 | ··control | 83 | ··control |
| 84 | ······This·is·the·key·description·file·used·by·dpkg.·It·specifies·the·package | 84 | ······This·is·the·key·description·file·used·by·dpkg.·It·specifies·the·package’s |
| 85 | ······name·and·version,·gives·its·description·for·the·user,·states·its | 85 | ······name·and·version,·gives·its·description·for·the·user,·states·its |
| 86 | ······relationships·with·other·packages,·and·so·forth.·See·_\x8D_\x8e_\x8b_\x8i_\x8a_\x8n_\x8·_\x8s_\x8o_\x8u_\x8r_\x8c_\x8e | 86 | ······relationships·with·other·packages,·and·so·forth.·See·_\x8D_\x8e_\x8b_\x8i_\x8a_\x8n_\x8·_\x8s_\x8o_\x8u_\x8r_\x8c_\x8e |
| 87 | ······_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8·_\x8t_\x8e_\x8m_\x8p_\x8l_\x8a_\x8t_\x8e_\x8·_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s_\x8·_\x8–_\x8·_\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8/_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l·and·_\x8D_\x8e_\x8b_\x8i_\x8a_\x8n_\x8·_\x8b_\x8i_\x8n_\x8a_\x8r_\x8y_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e | 87 | ······_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8·_\x8t_\x8e_\x8m_\x8p_\x8l_\x8a_\x8t_\x8e_\x8·_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s_\x8·_\x8–_\x8·_\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8/_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l·and·_\x8D_\x8e_\x8b_\x8i_\x8a_\x8n_\x8·_\x8b_\x8i_\x8n_\x8a_\x8r_\x8y_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e |
| 88 | ······_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s_\x8·_\x8–_\x8·_\x8D_\x8E_\x8B_\x8I_\x8A_\x8N_\x8/_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l. | 88 | ······_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s_\x8·_\x8–_\x8·_\x8D_\x8E_\x8B_\x8I_\x8A_\x8N_\x8/_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l. |
| 89 | ······It·is·usually·generated·automatically·from·information·in·the·source | 89 | ······It·is·usually·generated·automatically·from·information·in·the·source |
| 90 | ······package·by·the·dpkg-gencontrol·program,·and·with·assistance·from·dpkg- | 90 | ······package·by·the·dpkg-gencontrol·program,·and·with·assistance·from·dpkg- |
| 91 | ······shlibdeps.·See·_\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8s_\x8·_\x8(_\x8f_\x8r_\x8o_\x8m_\x8·_\x8o_\x8l_\x8d_\x8·_\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8i_\x8n_\x8g_\x8·_\x8M_\x8a_\x8n_\x8u_\x8a_\x8l_\x8). | 91 | ······shlibdeps.·See·_\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8s_\x8·_\x8(_\x8f_\x8r_\x8o_\x8m_\x8·_\x8o_\x8l_\x8d_\x8·_\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8i_\x8n_\x8g_\x8·_\x8M_\x8a_\x8n_\x8u_\x8a_\x8l_\x8). |
| Offset 108, 15 lines modified | Offset 108, 15 lines modified | ||
| 108 | ··shlibs | 108 | ··shlibs |
| 109 | ······This·file·contains·a·list·of·the·shared·libraries·supplied·by·the | 109 | ······This·file·contains·a·list·of·the·shared·libraries·supplied·by·the |
| 110 | ······package,·with·dependency·details·for·each.·This·is·used·by·dpkg-shlibdeps | 110 | ······package,·with·dependency·details·for·each.·This·is·used·by·dpkg-shlibdeps |
| 111 | ······when·it·determines·what·dependencies·are·required·in·a·package·control | 111 | ······when·it·determines·what·dependencies·are·required·in·a·package·control |
| 112 | ······file.·The·shlibs·file·format·is·described·on·_\x8T_\x8h_\x8e_\x8·_\x8s_\x8h_\x8l_\x8i_\x8b_\x8s_\x8·_\x8F_\x8i_\x8l_\x8e_\x8·_\x8F_\x8o_\x8r_\x8m_\x8a_\x8t. | 112 | ······file.·The·shlibs·file·format·is·described·on·_\x8T_\x8h_\x8e_\x8·_\x8s_\x8h_\x8l_\x8i_\x8b_\x8s_\x8·_\x8F_\x8i_\x8l_\x8e_\x8·_\x8F_\x8o_\x8r_\x8m_\x8a_\x8t. |
| 113 | *\x8**\x8**\x8**\x8**\x8*·2\x82.\x8.3\x83.\x8.·T\x8Th\x8he\x8e·b\x8bi\x8in\x8na\x8ar\x8ry\x8y·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8e:\x8:·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 113 | *\x8**\x8**\x8**\x8**\x8*·2\x82.\x8.3\x83.\x8.·T\x8Th\x8he\x8e·b\x8bi\x8in\x8na\x8ar\x8ry\x8y·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8e:\x8:·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 114 | The·most·important·package·metadata·file·used·by·dpkg·when·it·installs·a | 114 | The·most·important·package·metadata·file·used·by·dpkg·when·it·installs·a |
| 115 | package·is·control.·It·contains·all·the·package | 115 | package·is·control.·It·contains·all·the·package’s·“vital·statistics”. |
| 116 | The·binary·package·control·files·of·packages·built·from·Debian·sources·are·made | 116 | The·binary·package·control·files·of·packages·built·from·Debian·sources·are·made |
| 117 | by·a·special·tool,·dpkg-gencontrol,·which·reads·debian/control·and·debian/ | 117 | by·a·special·tool,·dpkg-gencontrol,·which·reads·debian/control·and·debian/ |
| 118 | changelog·to·find·the·information·it·needs.·See·_\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8s_\x8·_\x8(_\x8f_\x8r_\x8o_\x8m_\x8·_\x8o_\x8l_\x8d | 118 | changelog·to·find·the·information·it·needs.·See·_\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8s_\x8·_\x8(_\x8f_\x8r_\x8o_\x8m_\x8·_\x8o_\x8l_\x8d |
| 119 | _\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8i_\x8n_\x8g_\x8·_\x8M_\x8a_\x8n_\x8u_\x8a_\x8l_\x8)·for·more·details. | 119 | _\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8i_\x8n_\x8g_\x8·_\x8M_\x8a_\x8n_\x8u_\x8a_\x8l_\x8)·for·more·details. |
| 120 | The·fields·in·binary·package·control·files·are·listed·in·_\x8D_\x8e_\x8b_\x8i_\x8a_\x8n_\x8·_\x8b_\x8i_\x8n_\x8a_\x8r_\x8y_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e | 120 | The·fields·in·binary·package·control·files·are·listed·in·_\x8D_\x8e_\x8b_\x8i_\x8a_\x8n_\x8·_\x8b_\x8i_\x8n_\x8a_\x8r_\x8y_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e |
| 121 | _\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s_\x8·_\x8–_\x8·_\x8D_\x8E_\x8B_\x8I_\x8A_\x8N_\x8/_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l. | 121 | _\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s_\x8·_\x8–_\x8·_\x8D_\x8E_\x8B_\x8I_\x8A_\x8N_\x8/_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l. |
| 122 | A·description·of·the·syntax·of·control·files·and·the·purpose·of·the·fields·is | 122 | A·description·of·the·syntax·of·control·files·and·the·purpose·of·the·fields·is |
| Offset 107, 15 lines modified | Offset 107, 15 lines modified | ||
| 107 | <h1><span·class="section-number">5.·</span>Configuration·file·handling·(from·old·Packaging·Manual)<a·class="headerlink"·href="#configuration-file-handling-from-old-packaging-manual"·title="Link·to·this·heading"></a></h1> | 107 | <h1><span·class="section-number">5.·</span>Configuration·file·handling·(from·old·Packaging·Manual)<a·class="headerlink"·href="#configuration-file-handling-from-old-packaging-manual"·title="Link·to·this·heading"></a></h1> |
| 108 | <p><code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·can·do·a·certain·amount·of·automatic·handling·of·package | 108 | <p><code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·can·do·a·certain·amount·of·automatic·handling·of·package |
| 109 | configuration·files.</p> | 109 | configuration·files.</p> |
| 110 | <p>Whether·this·mechanism·is·appropriate·depends·on·a·number·of·factors, | 110 | <p>Whether·this·mechanism·is·appropriate·depends·on·a·number·of·factors, |
| 111 | but·basically·there·are·two·approaches·to·any·particular·configuration | 111 | but·basically·there·are·two·approaches·to·any·particular·configuration |
| 112 | file.</p> | 112 | file.</p> |
| 113 | <p>The·easy·method·is·to·ship·a·best-effort·configuration·in·the·package, | 113 | <p>The·easy·method·is·to·ship·a·best-effort·configuration·in·the·package, |
| 114 | and·use·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code> | 114 | and·use·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>’s·conffile·mechanism·to·handle·updates.·If·the·user·is |
| 115 | unlikely·to·want·to·edit·the·file,·but·you·need·them·to·be·able·to | 115 | unlikely·to·want·to·edit·the·file,·but·you·need·them·to·be·able·to |
| 116 | without·losing·their·changes,·and·a·new·package·with·a·changed·version | 116 | without·losing·their·changes,·and·a·new·package·with·a·changed·version |
| 117 | of·the·file·is·only·released·infrequently,·this·is·a·good·approach.</p> | 117 | of·the·file·is·only·released·infrequently,·this·is·a·good·approach.</p> |
| 118 | <p>The·hard·method·is·to·build·the·configuration·file·from·scratch·in·the | 118 | <p>The·hard·method·is·to·build·the·configuration·file·from·scratch·in·the |
| 119 | <code·class="docutils·literal·notranslate"><span·class="pre">postinst</span></code>·script,·and·to·take·the·responsibility·for·fixing·any | 119 | <code·class="docutils·literal·notranslate"><span·class="pre">postinst</span></code>·script,·and·to·take·the·responsibility·for·fixing·any |
| 120 | mistakes·made·in·earlier·versions·of·the·package·automatically.·This | 120 | mistakes·made·in·earlier·versions·of·the·package·automatically.·This |
| 121 | will·be·appropriate·if·the·file·is·likely·to·need·to·be·different·on | 121 | will·be·appropriate·if·the·file·is·likely·to·need·to·be·different·on |
| Offset 124, 27 lines modified | Offset 124, 27 lines modified | ||
| 124 | <span·id="s-se-1"></span><h2><span·class="section-number">5.1.·</span>Automatic·handling·of·configuration·files·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code><a·class="headerlink"·href="#automatic-handling-of-configuration-files-by-dpkg"·title="Link·to·this·heading"></a></h2> | 124 | <span·id="s-se-1"></span><h2><span·class="section-number">5.1.·</span>Automatic·handling·of·configuration·files·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code><a·class="headerlink"·href="#automatic-handling-of-configuration-files-by-dpkg"·title="Link·to·this·heading"></a></h2> |
| 125 | <p>A·binary·package·may·contain·a·package·metadata·file·called·<code·class="docutils·literal·notranslate"><span·class="pre">conffiles</span></code>. | 125 | <p>A·binary·package·may·contain·a·package·metadata·file·called·<code·class="docutils·literal·notranslate"><span·class="pre">conffiles</span></code>. |
| 126 | This·file·should·be·a·list·of·filenames·of·configuration·files·needing | 126 | This·file·should·be·a·list·of·filenames·of·configuration·files·needing |
| 127 | automatic·handling,·separated·by·newlines.·The·filenames·should·be | 127 | automatic·handling,·separated·by·newlines.·The·filenames·should·be |
| 128 | absolute·pathnames,·and·the·files·referred·to·should·actually·exist·in | 128 | absolute·pathnames,·and·the·files·referred·to·should·actually·exist·in |
| 129 | the·package.</p> | 129 | the·package.</p> |
| 130 | <p>When·a·package·is·upgraded·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·will·process·the·configuration·files | 130 | <p>When·a·package·is·upgraded·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·will·process·the·configuration·files |
| 131 | during·the·configuration·stage,·shortly·before·it·runs·the·package | 131 | during·the·configuration·stage,·shortly·before·it·runs·the·package’s |
| 132 | <code·class="docutils·literal·notranslate"><span·class="pre">postinst</span></code>·script,</p> | 132 | <code·class="docutils·literal·notranslate"><span·class="pre">postinst</span></code>·script,</p> |
| 133 | <p>For·each·file·it·checks·to·see·whether·the·version·of·the·file·included | 133 | <p>For·each·file·it·checks·to·see·whether·the·version·of·the·file·included |
| 134 | in·the·package·is·the·same·as·the·one·that·was·included·in·the·last | 134 | in·the·package·is·the·same·as·the·one·that·was·included·in·the·last |
| 135 | version·of·the·package·(the·one·that·is·being·upgraded·from);·it·also | 135 | version·of·the·package·(the·one·that·is·being·upgraded·from);·it·also |
| 136 | compares·the·version·currently·installed·on·the·system·with·the·one | 136 | compares·the·version·currently·installed·on·the·system·with·the·one |
| 137 | shipped·with·the·last·version.</p> | 137 | shipped·with·the·last·version.</p> |
| 138 | <p>If·neither·the·user·nor·the·package·maintainer·has·changed·the·file,·it | 138 | <p>If·neither·the·user·nor·the·package·maintainer·has·changed·the·file,·it |
| 139 | is·left·alone.·If·one·or·the·other·has·changed·their·version,·then·the | 139 | is·left·alone.·If·one·or·the·other·has·changed·their·version,·then·the |
| 140 | changed·version·is·preferred·-·i.e.,·if·the·user·edits·their·file,·but | 140 | changed·version·is·preferred·-·i.e.,·if·the·user·edits·their·file,·but |
| 141 | the·package·maintainer·doesn | 141 | the·package·maintainer·doesn’t·ship·a·different·version,·the·user’s |
| 142 | changes·will·stay,·silently,·but·if·the·maintainer·ships·a·new·version | 142 | changes·will·stay,·silently,·but·if·the·maintainer·ships·a·new·version |
| 143 | and·the·user·hasn | 143 | and·the·user·hasn’t·edited·it·the·new·version·will·be·installed·(with·an |
| 144 | informative·message).·If·both·have·changed·their·version·the·user·is | 144 | informative·message).·If·both·have·changed·their·version·the·user·is |
| 145 | prompted·about·the·problem·and·must·resolve·the·differences·themselves.</p> | 145 | prompted·about·the·problem·and·must·resolve·the·differences·themselves.</p> |
| 146 | <p>The·comparisons·are·done·by·calculating·the·MD5·message·digests·of·the | 146 | <p>The·comparisons·are·done·by·calculating·the·MD5·message·digests·of·the |
| 147 | files,·and·storing·the·MD5·of·the·file·as·it·was·included·in·the·most | 147 | files,·and·storing·the·MD5·of·the·file·as·it·was·included·in·the·most |
| 148 | recent·version·of·the·package.</p> | 148 | recent·version·of·the·package.</p> |
| 149 | <p>When·a·package·is·installed·for·the·first·time·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·will·install·the | 149 | <p>When·a·package·is·installed·for·the·first·time·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·will·install·the |
| 150 | file·that·comes·with·it,·unless·that·would·mean·overwriting·a·file | 150 | file·that·comes·with·it,·unless·that·would·mean·overwriting·a·file |
| Offset 159, 30 lines modified | Offset 159, 30 lines modified | ||
| 159 | confusing·and·possibly·dangerous·options·for·conffile·update·when·the | 159 | confusing·and·possibly·dangerous·options·for·conffile·update·when·the |
| 160 | package·is·upgraded.</p> | 160 | package·is·upgraded.</p> |
| 161 | </section> | 161 | </section> |
| 162 | <section·id="fully-featured-maintainer-script-configuration-handling"> | 162 | <section·id="fully-featured-maintainer-script-configuration-handling"> |
| 163 | <span·id="s-se-2"></span><h2><span·class="section-number">5.2.·</span>Fully-featured·maintainer·script·configuration·handling<a·class="headerlink"·href="#fully-featured-maintainer-script-configuration-handling"·title="Link·to·this·heading"></a></h2> | 163 | <span·id="s-se-2"></span><h2><span·class="section-number">5.2.·</span>Fully-featured·maintainer·script·configuration·handling<a·class="headerlink"·href="#fully-featured-maintainer-script-configuration-handling"·title="Link·to·this·heading"></a></h2> |
| 164 | <p>For·files·which·contain·site-specific·information·such·as·the·hostname | 164 | <p>For·files·which·contain·site-specific·information·such·as·the·hostname |
| 165 | and·networking·details·and·so·forth,·it·is·better·to·create·the·file·in | 165 | and·networking·details·and·so·forth,·it·is·better·to·create·the·file·in |
| 166 | the·package | 166 | the·package’s·<code·class="docutils·literal·notranslate"><span·class="pre">postinst</span></code>·script.</p> |
| 167 | <p>This·will·typically·involve·examining·the·state·of·the·rest·of·the | 167 | <p>This·will·typically·involve·examining·the·state·of·the·rest·of·the |
| 168 | system·to·determine·values·and·other·information,·and·may·involve | 168 | system·to·determine·values·and·other·information,·and·may·involve |
| 169 | prompting·the·user·for·some·information·which·can | 169 | prompting·the·user·for·some·information·which·can’t·be·obtained·some |
| 170 | other·way.</p> | 170 | other·way.</p> |
| 171 | <p>When·using·this·method·there·are·a·couple·of·important·issues·which | 171 | <p>When·using·this·method·there·are·a·couple·of·important·issues·which |
| 172 | should·be·considered:</p> | 172 | should·be·considered:</p> |
| 173 | <p>If·you·discover·a·bug·in·the·program·which·generates·the·configuration | 173 | <p>If·you·discover·a·bug·in·the·program·which·generates·the·configuration |
| 174 | file,·or·if·the·format·of·the·file·changes·from·one·version·to·the·next, | 174 | file,·or·if·the·format·of·the·file·changes·from·one·version·to·the·next, |
| 175 | you·will·have·to·arrange·for·the·postinst·script·to·do·something | 175 | you·will·have·to·arrange·for·the·postinst·script·to·do·something |
| 176 | sensible·-·usually·this·will·mean·editing·the·installed·configuration | 176 | sensible·-·usually·this·will·mean·editing·the·installed·configuration |
| 177 | file·to·remove·the·problem·or·change·the·syntax.·You·will·have·to·do | 177 | file·to·remove·the·problem·or·change·the·syntax.·You·will·have·to·do |
| 178 | this·very·carefully,·since·the·user·may·have·changed·the·file,·perhaps | 178 | this·very·carefully,·since·the·user·may·have·changed·the·file,·perhaps |
| 179 | to·fix·the·very·problem·that·your·script·is·trying·to·deal·with·-·you | 179 | to·fix·the·very·problem·that·your·script·is·trying·to·deal·with·-·you |
| 180 | will·have·to·detect·these·situations·and·deal·with·them·correctly.</p> | 180 | will·have·to·detect·these·situations·and·deal·with·them·correctly.</p> |
| 181 | <p>If·you·do·go·down·this·route·it | 181 | <p>If·you·do·go·down·this·route·it’s·probably·a·good·idea·to·make·the |
| 182 | program·that·generates·the·configuration·file(s)·a·separate·program·in | 182 | program·that·generates·the·configuration·file(s)·a·separate·program·in |
| 183 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/sbin</span></code>,·by·convention·called·<code·class="docutils·literal·notranslate"><span·class="pre">packageconfig</span></code>·and·then·run·that | 183 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/sbin</span></code>,·by·convention·called·<code·class="docutils·literal·notranslate"><span·class="pre">packageconfig</span></code>·and·then·run·that |
| 184 | if·appropriate·from·the·post-installation·script.·The·<code·class="docutils·literal·notranslate"><span·class="pre">packageconfig</span></code> | 184 | if·appropriate·from·the·post-installation·script.·The·<code·class="docutils·literal·notranslate"><span·class="pre">packageconfig</span></code> |
| 185 | program·should·not·unquestioningly·overwrite·an·existing·configuration·- | 185 | program·should·not·unquestioningly·overwrite·an·existing·configuration·- |
| 186 | if·its·mode·of·operation·is·geared·towards·setting·up·a·package·for·the | 186 | if·its·mode·of·operation·is·geared·towards·setting·up·a·package·for·the |
| 187 | first·time·(rather·than·any·arbitrary·reconfiguration·later)·you·should | 187 | first·time·(rather·than·any·arbitrary·reconfiguration·later)·you·should |
| 188 | have·it·check·whether·the·configuration·already·exists,·and·require·a | 188 | have·it·check·whether·the·configuration·already·exists,·and·require·a |
| Offset 35, 38 lines modified | Offset 35, 38 lines modified | ||
| 35 | =============================================================================== | 35 | =============================================================================== |
| 36 | *\x8**\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.·C\x8Co\x8on\x8nf\x8fi\x8ig\x8gu\x8ur\x8ra\x8at\x8ti\x8io\x8on\x8n·f\x8fi\x8il\x8le\x8e·h\x8ha\x8an\x8nd\x8dl\x8li\x8in\x8ng\x8g·(\x8(f\x8fr\x8ro\x8om\x8m·o\x8ol\x8ld\x8d·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8gi\x8in\x8ng\x8g·M\x8Ma\x8an\x8nu\x8ua\x8al\x8l)\x8)_\x8?\x8·*\x8**\x8**\x8**\x8**\x8**\x8* | 36 | *\x8**\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.·C\x8Co\x8on\x8nf\x8fi\x8ig\x8gu\x8ur\x8ra\x8at\x8ti\x8io\x8on\x8n·f\x8fi\x8il\x8le\x8e·h\x8ha\x8an\x8nd\x8dl\x8li\x8in\x8ng\x8g·(\x8(f\x8fr\x8ro\x8om\x8m·o\x8ol\x8ld\x8d·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8gi\x8in\x8ng\x8g·M\x8Ma\x8an\x8nu\x8ua\x8al\x8l)\x8)_\x8?\x8·*\x8**\x8**\x8**\x8**\x8**\x8* |
| 37 | dpkg·can·do·a·certain·amount·of·automatic·handling·of·package·configuration | 37 | dpkg·can·do·a·certain·amount·of·automatic·handling·of·package·configuration |
| 38 | files. | 38 | files. |
| 39 | Whether·this·mechanism·is·appropriate·depends·on·a·number·of·factors,·but | 39 | Whether·this·mechanism·is·appropriate·depends·on·a·number·of·factors,·but |
| 40 | basically·there·are·two·approaches·to·any·particular·configuration·file. | 40 | basically·there·are·two·approaches·to·any·particular·configuration·file. |
| 41 | The·easy·method·is·to·ship·a·best-effort·configuration·in·the·package,·and·use | 41 | The·easy·method·is·to·ship·a·best-effort·configuration·in·the·package,·and·use |
| 42 | dpkg | 42 | dpkg’s·conffile·mechanism·to·handle·updates.·If·the·user·is·unlikely·to·want·to |
| 43 | edit·the·file,·but·you·need·them·to·be·able·to·without·losing·their·changes, | 43 | edit·the·file,·but·you·need·them·to·be·able·to·without·losing·their·changes, |
| 44 | and·a·new·package·with·a·changed·version·of·the·file·is·only·released | 44 | and·a·new·package·with·a·changed·version·of·the·file·is·only·released |
| 45 | infrequently,·this·is·a·good·approach. | 45 | infrequently,·this·is·a·good·approach. |
| 46 | The·hard·method·is·to·build·the·configuration·file·from·scratch·in·the·postinst | 46 | The·hard·method·is·to·build·the·configuration·file·from·scratch·in·the·postinst |
| 47 | script,·and·to·take·the·responsibility·for·fixing·any·mistakes·made·in·earlier | 47 | script,·and·to·take·the·responsibility·for·fixing·any·mistakes·made·in·earlier |
| 48 | versions·of·the·package·automatically.·This·will·be·appropriate·if·the·file·is | 48 | versions·of·the·package·automatically.·This·will·be·appropriate·if·the·file·is |
| 49 | likely·to·need·to·be·different·on·each·system. | 49 | likely·to·need·to·be·different·on·each·system. |
| 50 | *\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.1\x81.\x8.·A\x8Au\x8ut\x8to\x8om\x8ma\x8at\x8ti\x8ic\x8c·h\x8ha\x8an\x8nd\x8dl\x8li\x8in\x8ng\x8g·o\x8of\x8f·c\x8co\x8on\x8nf\x8fi\x8ig\x8gu\x8ur\x8ra\x8at\x8ti\x8io\x8on\x8n·f\x8fi\x8il\x8le\x8es\x8s·b\x8by\x8y·d\x8dp\x8pk\x8kg\x8g_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 50 | *\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.1\x81.\x8.·A\x8Au\x8ut\x8to\x8om\x8ma\x8at\x8ti\x8ic\x8c·h\x8ha\x8an\x8nd\x8dl\x8li\x8in\x8ng\x8g·o\x8of\x8f·c\x8co\x8on\x8nf\x8fi\x8ig\x8gu\x8ur\x8ra\x8at\x8ti\x8io\x8on\x8n·f\x8fi\x8il\x8le\x8es\x8s·b\x8by\x8y·d\x8dp\x8pk\x8kg\x8g_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 51 | A·binary·package·may·contain·a·package·metadata·file·called·conffiles.·This | 51 | A·binary·package·may·contain·a·package·metadata·file·called·conffiles.·This |
| 52 | file·should·be·a·list·of·filenames·of·configuration·files·needing·automatic | 52 | file·should·be·a·list·of·filenames·of·configuration·files·needing·automatic |
| 53 | handling,·separated·by·newlines.·The·filenames·should·be·absolute·pathnames, | 53 | handling,·separated·by·newlines.·The·filenames·should·be·absolute·pathnames, |
| 54 | and·the·files·referred·to·should·actually·exist·in·the·package. | 54 | and·the·files·referred·to·should·actually·exist·in·the·package. |
| 55 | When·a·package·is·upgraded·dpkg·will·process·the·configuration·files·during·the | 55 | When·a·package·is·upgraded·dpkg·will·process·the·configuration·files·during·the |
| 56 | configuration·stage,·shortly·before·it·runs·the·package | 56 | configuration·stage,·shortly·before·it·runs·the·package’s·postinst·script, |
| 57 | For·each·file·it·checks·to·see·whether·the·version·of·the·file·included·in·the | 57 | For·each·file·it·checks·to·see·whether·the·version·of·the·file·included·in·the |
| 58 | package·is·the·same·as·the·one·that·was·included·in·the·last·version·of·the | 58 | package·is·the·same·as·the·one·that·was·included·in·the·last·version·of·the |
| 59 | package·(the·one·that·is·being·upgraded·from);·it·also·compares·the·version | 59 | package·(the·one·that·is·being·upgraded·from);·it·also·compares·the·version |
| 60 | currently·installed·on·the·system·with·the·one·shipped·with·the·last·version. | 60 | currently·installed·on·the·system·with·the·one·shipped·with·the·last·version. |
| 61 | If·neither·the·user·nor·the·package·maintainer·has·changed·the·file,·it·is·left | 61 | If·neither·the·user·nor·the·package·maintainer·has·changed·the·file,·it·is·left |
| 62 | alone.·If·one·or·the·other·has·changed·their·version,·then·the·changed·version | 62 | alone.·If·one·or·the·other·has·changed·their·version,·then·the·changed·version |
| 63 | is·preferred·-·i.e.,·if·the·user·edits·their·file,·but·the·package·maintainer | 63 | is·preferred·-·i.e.,·if·the·user·edits·their·file,·but·the·package·maintainer |
| 64 | doesn | 64 | doesn’t·ship·a·different·version,·the·user’s·changes·will·stay,·silently,·but |
| 65 | if·the·maintainer·ships·a·new·version·and·the·user·hasn | 65 | if·the·maintainer·ships·a·new·version·and·the·user·hasn’t·edited·it·the·new |
| 66 | version·will·be·installed·(with·an·informative·message).·If·both·have·changed | 66 | version·will·be·installed·(with·an·informative·message).·If·both·have·changed |
| 67 | their·version·the·user·is·prompted·about·the·problem·and·must·resolve·the | 67 | their·version·the·user·is·prompted·about·the·problem·and·must·resolve·the |
| 68 | differences·themselves. | 68 | differences·themselves. |
| 69 | The·comparisons·are·done·by·calculating·the·MD5·message·digests·of·the·files, | 69 | The·comparisons·are·done·by·calculating·the·MD5·message·digests·of·the·files, |
| 70 | and·storing·the·MD5·of·the·file·as·it·was·included·in·the·most·recent·version | 70 | and·storing·the·MD5·of·the·file·as·it·was·included·in·the·most·recent·version |
| 71 | of·the·package. | 71 | of·the·package. |
| 72 | When·a·package·is·installed·for·the·first·time·dpkg·will·install·the·file·that | 72 | When·a·package·is·installed·for·the·first·time·dpkg·will·install·the·file·that |
| Offset 78, 29 lines modified | Offset 78, 29 lines modified | ||
| 78 | missing·file·needs·to·be·kept·that·way·if·the·user·did·it. | 78 | missing·file·needs·to·be·kept·that·way·if·the·user·did·it. |
| 79 | Note·that·a·package·should·n\x8no\x8ot\x8t·modify·a·dpkg-handled·conffile·in·its·maintainer | 79 | Note·that·a·package·should·n\x8no\x8ot\x8t·modify·a·dpkg-handled·conffile·in·its·maintainer |
| 80 | scripts.·Doing·this·will·lead·to·dpkg·giving·the·user·confusing·and·possibly | 80 | scripts.·Doing·this·will·lead·to·dpkg·giving·the·user·confusing·and·possibly |
| 81 | dangerous·options·for·conffile·update·when·the·package·is·upgraded. | 81 | dangerous·options·for·conffile·update·when·the·package·is·upgraded. |
| 82 | *\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.2\x82.\x8.·F\x8Fu\x8ul\x8ll\x8ly\x8y-\x8-f\x8fe\x8ea\x8at\x8tu\x8ur\x8re\x8ed\x8d·m\x8ma\x8ai\x8in\x8nt\x8ta\x8ai\x8in\x8ne\x8er\x8r·s\x8sc\x8cr\x8ri\x8ip\x8pt\x8t·c\x8co\x8on\x8nf\x8fi\x8ig\x8gu\x8ur\x8ra\x8at\x8ti\x8io\x8on\x8n·h\x8ha\x8an\x8nd\x8dl\x8li\x8in\x8ng\x8g_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 82 | *\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.2\x82.\x8.·F\x8Fu\x8ul\x8ll\x8ly\x8y-\x8-f\x8fe\x8ea\x8at\x8tu\x8ur\x8re\x8ed\x8d·m\x8ma\x8ai\x8in\x8nt\x8ta\x8ai\x8in\x8ne\x8er\x8r·s\x8sc\x8cr\x8ri\x8ip\x8pt\x8t·c\x8co\x8on\x8nf\x8fi\x8ig\x8gu\x8ur\x8ra\x8at\x8ti\x8io\x8on\x8n·h\x8ha\x8an\x8nd\x8dl\x8li\x8in\x8ng\x8g_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 83 | For·files·which·contain·site-specific·information·such·as·the·hostname·and | 83 | For·files·which·contain·site-specific·information·such·as·the·hostname·and |
| 84 | networking·details·and·so·forth,·it·is·better·to·create·the·file·in·the | 84 | networking·details·and·so·forth,·it·is·better·to·create·the·file·in·the |
| 85 | package | 85 | package’s·postinst·script. |
| 86 | This·will·typically·involve·examining·the·state·of·the·rest·of·the·system·to | 86 | This·will·typically·involve·examining·the·state·of·the·rest·of·the·system·to |
| 87 | determine·values·and·other·information,·and·may·involve·prompting·the·user·for | 87 | determine·values·and·other·information,·and·may·involve·prompting·the·user·for |
| 88 | some·information·which·can | 88 | some·information·which·can’t·be·obtained·some·other·way. |
| 89 | When·using·this·method·there·are·a·couple·of·important·issues·which·should·be | 89 | When·using·this·method·there·are·a·couple·of·important·issues·which·should·be |
| 90 | considered: | 90 | considered: |
| 91 | If·you·discover·a·bug·in·the·program·which·generates·the·configuration·file,·or | 91 | If·you·discover·a·bug·in·the·program·which·generates·the·configuration·file,·or |
| 92 | if·the·format·of·the·file·changes·from·one·version·to·the·next,·you·will·have | 92 | if·the·format·of·the·file·changes·from·one·version·to·the·next,·you·will·have |
| 93 | to·arrange·for·the·postinst·script·to·do·something·sensible·-·usually·this·will | 93 | to·arrange·for·the·postinst·script·to·do·something·sensible·-·usually·this·will |
| 94 | mean·editing·the·installed·configuration·file·to·remove·the·problem·or·change | 94 | mean·editing·the·installed·configuration·file·to·remove·the·problem·or·change |
| 95 | the·syntax.·You·will·have·to·do·this·very·carefully,·since·the·user·may·have | 95 | the·syntax.·You·will·have·to·do·this·very·carefully,·since·the·user·may·have |
| 96 | changed·the·file,·perhaps·to·fix·the·very·problem·that·your·script·is·trying·to | 96 | changed·the·file,·perhaps·to·fix·the·very·problem·that·your·script·is·trying·to |
| 97 | deal·with·-·you·will·have·to·detect·these·situations·and·deal·with·them | 97 | deal·with·-·you·will·have·to·detect·these·situations·and·deal·with·them |
| 98 | correctly. | 98 | correctly. |
| 99 | If·you·do·go·down·this·route·it | 99 | If·you·do·go·down·this·route·it’s·probably·a·good·idea·to·make·the·program·that |
| 100 | generates·the·configuration·file(s)·a·separate·program·in·/usr/sbin,·by | 100 | generates·the·configuration·file(s)·a·separate·program·in·/usr/sbin,·by |
| 101 | convention·called·packageconfig·and·then·run·that·if·appropriate·from·the·post- | 101 | convention·called·packageconfig·and·then·run·that·if·appropriate·from·the·post- |
| 102 | installation·script.·The·packageconfig·program·should·not·unquestioningly | 102 | installation·script.·The·packageconfig·program·should·not·unquestioningly |
| 103 | overwrite·an·existing·configuration·-·if·its·mode·of·operation·is·geared | 103 | overwrite·an·existing·configuration·-·if·its·mode·of·operation·is·geared |
| 104 | towards·setting·up·a·package·for·the·first·time·(rather·than·any·arbitrary | 104 | towards·setting·up·a·package·for·the·first·time·(rather·than·any·arbitrary |
| 105 | reconfiguration·later)·you·should·have·it·check·whether·the·configuration | 105 | reconfiguration·later)·you·should·have·it·check·whether·the·configuration |
| 106 | already·exists,·and·require·a·--force·flag·to·overwrite·it. | 106 | already·exists,·and·require·a·--force·flag·to·overwrite·it. |
| Offset 112, 27 lines modified | Offset 112, 27 lines modified | ||
| 112 | ···········<div·itemprop="articleBody"> | 112 | ···········<div·itemprop="articleBody"> |
| 113 | ············· | 113 | ············· |
| 114 | ··<section·id="control-files-and-their-fields-from-old-packaging-manual"> | 114 | ··<section·id="control-files-and-their-fields-from-old-packaging-manual"> |
| 115 | <h1><span·class="section-number">4.·</span>Control·files·and·their·fields·(from·old·Packaging·Manual)<a·class="headerlink"·href="#control-files-and-their-fields-from-old-packaging-manual"·title="Link·to·this·heading"></a></h1> | 115 | <h1><span·class="section-number">4.·</span>Control·files·and·their·fields·(from·old·Packaging·Manual)<a·class="headerlink"·href="#control-files-and-their-fields-from-old-packaging-manual"·title="Link·to·this·heading"></a></h1> |
| 116 | <p>Many·of·the·tools·in·the·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·suite·manipulate·data·in·a·common | 116 | <p>Many·of·the·tools·in·the·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·suite·manipulate·data·in·a·common |
| 117 | format,·known·as·control·files.·Binary·and·source·packages·have·control | 117 | format,·known·as·control·files.·Binary·and·source·packages·have·control |
| 118 | data·as·do·the·<code·class="docutils·literal·notranslate"><span·class="pre">.changes</span></code>·files·which·control·the·installation·of | 118 | data·as·do·the·<code·class="docutils·literal·notranslate"><span·class="pre">.changes</span></code>·files·which·control·the·installation·of |
| 119 | uploaded·files,·and·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code> | 119 | uploaded·files,·and·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>’s·internal·databases·are·in·a·similar |
| 120 | format.</p> | 120 | format.</p> |
| 121 | <section·id="syntax-of-control-files"> | 121 | <section·id="syntax-of-control-files"> |
| 122 | <span·id="s-sd-1"></span><h2><span·class="section-number">4.1.·</span>Syntax·of·control·files<a·class="headerlink"·href="#syntax-of-control-files"·title="Link·to·this·heading"></a></h2> | 122 | <span·id="s-sd-1"></span><h2><span·class="section-number">4.1.·</span>Syntax·of·control·files<a·class="headerlink"·href="#syntax-of-control-files"·title="Link·to·this·heading"></a></h2> |
| 123 | <p>See·<a·class="reference·internal"·href="ch-controlfields.html#s-controlsyntax"><span·class="std·std-ref">Syntax·of·control·files</span></a>.</p> | 123 | <p>See·<a·class="reference·internal"·href="ch-controlfields.html#s-controlsyntax"><span·class="std·std-ref">Syntax·of·control·files</span></a>.</p> |
| 124 | <p>It·is·important·to·note·that·there·are·several·fields·which·are·optional | 124 | <p>It·is·important·to·note·that·there·are·several·fields·which·are·optional |
| 125 | as·far·as·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·and·the·related·tools·are·concerned,·but·which·must | 125 | as·far·as·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·and·the·related·tools·are·concerned,·but·which·must |
| 126 | appear·in·every·Debian·package,·or·whose·omission·may·cause·problems.</p> | 126 | appear·in·every·Debian·package,·or·whose·omission·may·cause·problems.</p> |
| 127 | </section> | 127 | </section> |
| 128 | <section·id="list-of-fields"> | 128 | <section·id="list-of-fields"> |
| 129 | <span·id="s-sd-2"></span><h2><span·class="section-number">4.2.·</span>List·of·fields<a·class="headerlink"·href="#list-of-fields"·title="Link·to·this·heading"></a></h2> | 129 | <span·id="s-sd-2"></span><h2><span·class="section-number">4.2.·</span>List·of·fields<a·class="headerlink"·href="#list-of-fields"·title="Link·to·this·heading"></a></h2> |
| 130 | <p>See·<a·class="reference·internal"·href="ch-controlfields.html#s-controlfieldslist"><span·class="std·std-ref">List·of·fields</span></a>.</p> | 130 | <p>See·<a·class="reference·internal"·href="ch-controlfields.html#s-controlfieldslist"><span·class="std·std-ref">List·of·fields</span></a>.</p> |
| 131 | <p>This·section·now·contains·only·the·fields·that·didn | 131 | <p>This·section·now·contains·only·the·fields·that·didn’t·belong·to·the |
| 132 | Policy·manual.</p> | 132 | Policy·manual.</p> |
| 133 | <section·id="filename-and-msdos-filename"> | 133 | <section·id="filename-and-msdos-filename"> |
| 134 | <span·id="s-pkg-f-filename"></span><h3><span·class="section-number">4.2.1.·</span><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·class="headerlink"·href="#filename-and-msdos-filename"·title="Link·to·this·heading"></a></h3> | 134 | <span·id="s-pkg-f-filename"></span><h3><span·class="section-number">4.2.1.·</span><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·class="headerlink"·href="#filename-and-msdos-filename"·title="Link·to·this·heading"></a></h3> |
| 135 | <p>These·fields·in·<code·class="docutils·literal·notranslate"><span·class="pre">Packages</span></code>·files·give·the·filename(s)·of·(the·parts | 135 | <p>These·fields·in·<code·class="docutils·literal·notranslate"><span·class="pre">Packages</span></code>·files·give·the·filename(s)·of·(the·parts |
| 136 | of)·a·package·in·the·distribution·directories,·relative·to·the·root·of | 136 | of)·a·package·in·the·distribution·directories,·relative·to·the·root·of |
| 137 | the·Debian·hierarchy.·If·the·package·has·been·split·into·several·parts | 137 | the·Debian·hierarchy.·If·the·package·has·been·split·into·several·parts |
| 138 | the·parts·are·all·listed·in·order,·separated·by·spaces.</p> | 138 | the·parts·are·all·listed·in·order,·separated·by·spaces.</p> |
| Offset 142, 28 lines modified | Offset 142, 28 lines modified | ||
| 142 | <p>These·fields·in·<code·class="docutils·literal·notranslate"><span·class="pre">Packages</span></code>·files·give·the·size·(in·bytes,·expressed·in | 142 | <p>These·fields·in·<code·class="docutils·literal·notranslate"><span·class="pre">Packages</span></code>·files·give·the·size·(in·bytes,·expressed·in |
| 143 | decimal)·and·MD5·checksum·of·the·file(s)·which·make(s)·up·a·binary | 143 | decimal)·and·MD5·checksum·of·the·file(s)·which·make(s)·up·a·binary |
| 144 | package·in·the·distribution.·If·the·package·is·split·into·several·parts | 144 | package·in·the·distribution.·If·the·package·is·split·into·several·parts |
| 145 | the·values·for·the·parts·are·listed·in·order,·separated·by·spaces.</p> | 145 | the·values·for·the·parts·are·listed·in·order,·separated·by·spaces.</p> |
| 146 | </section> | 146 | </section> |
| 147 | <section·id="status"> | 147 | <section·id="status"> |
| 148 | <span·id="s-pkg-f-status"></span><h3><span·class="section-number">4.2.3.·</span><code·class="docutils·literal·notranslate"><span·class="pre">Status</span></code><a·class="headerlink"·href="#status"·title="Link·to·this·heading"></a></h3> | 148 | <span·id="s-pkg-f-status"></span><h3><span·class="section-number">4.2.3.·</span><code·class="docutils·literal·notranslate"><span·class="pre">Status</span></code><a·class="headerlink"·href="#status"·title="Link·to·this·heading"></a></h3> |
| 149 | <p>This·field·in·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code> | 149 | <p>This·field·in·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>’s·status·file·records·whether·the·user·wants·a |
| 150 | package·installed,·removed·or·left·alone,·whether·it·is·broken | 150 | package·installed,·removed·or·left·alone,·whether·it·is·broken |
| 151 | (requiring·re-installation)·or·not·and·what·its·current·state·on·the | 151 | (requiring·re-installation)·or·not·and·what·its·current·state·on·the |
| 152 | system·is.·Each·of·these·pieces·of·information·is·a·single·word.</p> | 152 | system·is.·Each·of·these·pieces·of·information·is·a·single·word.</p> |
| 153 | </section> | 153 | </section> |
| 154 | <section·id="config-version"> | 154 | <section·id="config-version"> |
| 155 | <span·id="s-pkg-f-config-version"></span><h3><span·class="section-number">4.2.4.·</span><code·class="docutils·literal·notranslate"><span·class="pre">Config-Version</span></code><a·class="headerlink"·href="#config-version"·title="Link·to·this·heading"></a></h3> | 155 | <span·id="s-pkg-f-config-version"></span><h3><span·class="section-number">4.2.4.·</span><code·class="docutils·literal·notranslate"><span·class="pre">Config-Version</span></code><a·class="headerlink"·href="#config-version"·title="Link·to·this·heading"></a></h3> |
| 156 | <p>If·a·package·is·not·installed·or·not·configured,·this·field·in | 156 | <p>If·a·package·is·not·installed·or·not·configured,·this·field·in |
| 157 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code> | 157 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>’s·status·file·records·the·last·version·of·the·package·which·was |
| 158 | successfully·configured.</p> | 158 | successfully·configured.</p> |
| 159 | </section> | 159 | </section> |
| 160 | <section·id="conffiles"> | 160 | <section·id="conffiles"> |
| 161 | <span·id="s-pkg-f-conffiles"></span><h3><span·class="section-number">4.2.5.·</span><code·class="docutils·literal·notranslate"><span·class="pre">Conffiles</span></code><a·class="headerlink"·href="#conffiles"·title="Link·to·this·heading"></a></h3> | 161 | <span·id="s-pkg-f-conffiles"></span><h3><span·class="section-number">4.2.5.·</span><code·class="docutils·literal·notranslate"><span·class="pre">Conffiles</span></code><a·class="headerlink"·href="#conffiles"·title="Link·to·this·heading"></a></h3> |
| 162 | <p>This·field·in·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code> | 162 | <p>This·field·in·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>’s·status·file·contains·information·about·the |
| 163 | automatically-managed·configuration·files·held·by·a·package.·This·field | 163 | automatically-managed·configuration·files·held·by·a·package.·This·field |
| 164 | should·<em>not</em>·appear·anywhere·in·a·package!</p> | 164 | should·<em>not</em>·appear·anywhere·in·a·package!</p> |
| 165 | </section> | 165 | </section> |
| 166 | <section·id="obsolete-fields"> | 166 | <section·id="obsolete-fields"> |
| 167 | <span·id="s-sd-2-6"></span><h3><span·class="section-number">4.2.6.·</span>Obsolete·fields<a·class="headerlink"·href="#obsolete-fields"·title="Link·to·this·heading"></a></h3> | 167 | <span·id="s-sd-2-6"></span><h3><span·class="section-number">4.2.6.·</span>Obsolete·fields<a·class="headerlink"·href="#obsolete-fields"·title="Link·to·this·heading"></a></h3> |
| 168 | <p>These·are·still·recognized·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·but·should·not·appear·anywhere | 168 | <p>These·are·still·recognized·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·but·should·not·appear·anywhere |
| 169 | any·more.</p> | 169 | any·more.</p> |
| Offset 38, 45 lines modified | Offset 38, 45 lines modified | ||
| 38 | ····*·4.·Control·files·and·their·fields·(from·old·Packaging·Manual) | 38 | ····*·4.·Control·files·and·their·fields·(from·old·Packaging·Manual) |
| 39 | ····*·_\x8V_\x8i_\x8e_\x8w_\x8·_\x8p_\x8a_\x8g_\x8e_\x8·_\x8s_\x8o_\x8u_\x8r_\x8c_\x8e | 39 | ····*·_\x8V_\x8i_\x8e_\x8w_\x8·_\x8p_\x8a_\x8g_\x8e_\x8·_\x8s_\x8o_\x8u_\x8r_\x8c_\x8e |
| 40 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t | 40 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t |
| 41 | =============================================================================== | 41 | =============================================================================== |
| 42 | *\x8**\x8**\x8**\x8**\x8**\x8*·4\x84.\x8.·C\x8Co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8es\x8s·a\x8an\x8nd\x8d·t\x8th\x8he\x8ei\x8ir\x8r·f\x8fi\x8ie\x8el\x8ld\x8ds\x8s·(\x8(f\x8fr\x8ro\x8om\x8m·o\x8ol\x8ld\x8d·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8gi\x8in\x8ng\x8g·M\x8Ma\x8an\x8nu\x8ua\x8al\x8l)\x8)_\x8?\x8·*\x8**\x8**\x8**\x8**\x8**\x8* | 42 | *\x8**\x8**\x8**\x8**\x8**\x8*·4\x84.\x8.·C\x8Co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8es\x8s·a\x8an\x8nd\x8d·t\x8th\x8he\x8ei\x8ir\x8r·f\x8fi\x8ie\x8el\x8ld\x8ds\x8s·(\x8(f\x8fr\x8ro\x8om\x8m·o\x8ol\x8ld\x8d·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8gi\x8in\x8ng\x8g·M\x8Ma\x8an\x8nu\x8ua\x8al\x8l)\x8)_\x8?\x8·*\x8**\x8**\x8**\x8**\x8**\x8* |
| 43 | Many·of·the·tools·in·the·dpkg·suite·manipulate·data·in·a·common·format,·known | 43 | Many·of·the·tools·in·the·dpkg·suite·manipulate·data·in·a·common·format,·known |
| 44 | as·control·files.·Binary·and·source·packages·have·control·data·as·do·the | 44 | as·control·files.·Binary·and·source·packages·have·control·data·as·do·the |
| 45 | .changes·files·which·control·the·installation·of·uploaded·files,·and·dpkg | 45 | .changes·files·which·control·the·installation·of·uploaded·files,·and·dpkg’s |
| 46 | internal·databases·are·in·a·similar·format. | 46 | internal·databases·are·in·a·similar·format. |
| 47 | *\x8**\x8**\x8**\x8**\x8*·4\x84.\x8.1\x81.\x8.·S\x8Sy\x8yn\x8nt\x8ta\x8ax\x8x·o\x8of\x8f·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 47 | *\x8**\x8**\x8**\x8**\x8*·4\x84.\x8.1\x81.\x8.·S\x8Sy\x8yn\x8nt\x8ta\x8ax\x8x·o\x8of\x8f·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 48 | See·_\x8S_\x8y_\x8n_\x8t_\x8a_\x8x_\x8·_\x8o_\x8f_\x8·_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s. | 48 | See·_\x8S_\x8y_\x8n_\x8t_\x8a_\x8x_\x8·_\x8o_\x8f_\x8·_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s. |
| 49 | It·is·important·to·note·that·there·are·several·fields·which·are·optional·as·far | 49 | It·is·important·to·note·that·there·are·several·fields·which·are·optional·as·far |
| 50 | as·dpkg·and·the·related·tools·are·concerned,·but·which·must·appear·in·every | 50 | as·dpkg·and·the·related·tools·are·concerned,·but·which·must·appear·in·every |
| 51 | Debian·package,·or·whose·omission·may·cause·problems. | 51 | Debian·package,·or·whose·omission·may·cause·problems. |
| 52 | *\x8**\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.·L\x8Li\x8is\x8st\x8t·o\x8of\x8f·f\x8fi\x8ie\x8el\x8ld\x8ds\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 52 | *\x8**\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.·L\x8Li\x8is\x8st\x8t·o\x8of\x8f·f\x8fi\x8ie\x8el\x8ld\x8ds\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 53 | See·_\x8L_\x8i_\x8s_\x8t_\x8·_\x8o_\x8f_\x8·_\x8f_\x8i_\x8e_\x8l_\x8d_\x8s. | 53 | See·_\x8L_\x8i_\x8s_\x8t_\x8·_\x8o_\x8f_\x8·_\x8f_\x8i_\x8e_\x8l_\x8d_\x8s. |
| 54 | This·section·now·contains·only·the·fields·that·didn | 54 | This·section·now·contains·only·the·fields·that·didn’t·belong·to·the·Policy |
| 55 | manual. | 55 | manual. |
| 56 | *\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.1\x81.\x8.·F\x8Fi\x8il\x8le\x8en\x8na\x8am\x8me\x8e·a\x8an\x8nd\x8d·M\x8MS\x8SD\x8DO\x8OS\x8S-\x8-F\x8Fi\x8il\x8le\x8en\x8na\x8am\x8me\x8e_\x8?\x8·*\x8**\x8**\x8**\x8* | 56 | *\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.1\x81.\x8.·F\x8Fi\x8il\x8le\x8en\x8na\x8am\x8me\x8e·a\x8an\x8nd\x8d·M\x8MS\x8SD\x8DO\x8OS\x8S-\x8-F\x8Fi\x8il\x8le\x8en\x8na\x8am\x8me\x8e_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 57 | These·fields·in·Packages·files·give·the·filename(s)·of·(the·parts·of)·a·package | 57 | These·fields·in·Packages·files·give·the·filename(s)·of·(the·parts·of)·a·package |
| 58 | in·the·distribution·directories,·relative·to·the·root·of·the·Debian·hierarchy. | 58 | in·the·distribution·directories,·relative·to·the·root·of·the·Debian·hierarchy. |
| 59 | If·the·package·has·been·split·into·several·parts·the·parts·are·all·listed·in | 59 | If·the·package·has·been·split·into·several·parts·the·parts·are·all·listed·in |
| 60 | order,·separated·by·spaces. | 60 | order,·separated·by·spaces. |
| 61 | *\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.2\x82.\x8.·S\x8Si\x8iz\x8ze\x8e·a\x8an\x8nd\x8d·M\x8MD\x8D5\x85s\x8su\x8um\x8m_\x8?\x8·*\x8**\x8**\x8**\x8* | 61 | *\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.2\x82.\x8.·S\x8Si\x8iz\x8ze\x8e·a\x8an\x8nd\x8d·M\x8MD\x8D5\x85s\x8su\x8um\x8m_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 62 | These·fields·in·Packages·files·give·the·size·(in·bytes,·expressed·in·decimal) | 62 | These·fields·in·Packages·files·give·the·size·(in·bytes,·expressed·in·decimal) |
| 63 | and·MD5·checksum·of·the·file(s)·which·make(s)·up·a·binary·package·in·the | 63 | and·MD5·checksum·of·the·file(s)·which·make(s)·up·a·binary·package·in·the |
| 64 | distribution.·If·the·package·is·split·into·several·parts·the·values·for·the | 64 | distribution.·If·the·package·is·split·into·several·parts·the·values·for·the |
| 65 | parts·are·listed·in·order,·separated·by·spaces. | 65 | parts·are·listed·in·order,·separated·by·spaces. |
| 66 | *\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.3\x83.\x8.·S\x8St\x8ta\x8at\x8tu\x8us\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 66 | *\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.3\x83.\x8.·S\x8St\x8ta\x8at\x8tu\x8us\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 67 | This·field·in·dpkg | 67 | This·field·in·dpkg’s·status·file·records·whether·the·user·wants·a·package |
| 68 | installed,·removed·or·left·alone,·whether·it·is·broken·(requiring·re- | 68 | installed,·removed·or·left·alone,·whether·it·is·broken·(requiring·re- |
| 69 | installation)·or·not·and·what·its·current·state·on·the·system·is.·Each·of·these | 69 | installation)·or·not·and·what·its·current·state·on·the·system·is.·Each·of·these |
| 70 | pieces·of·information·is·a·single·word. | 70 | pieces·of·information·is·a·single·word. |
| 71 | *\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.4\x84.\x8.·C\x8Co\x8on\x8nf\x8fi\x8ig\x8g-\x8-V\x8Ve\x8er\x8rs\x8si\x8io\x8on\x8n_\x8?\x8·*\x8**\x8**\x8**\x8* | 71 | *\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.4\x84.\x8.·C\x8Co\x8on\x8nf\x8fi\x8ig\x8g-\x8-V\x8Ve\x8er\x8rs\x8si\x8io\x8on\x8n_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 72 | If·a·package·is·not·installed·or·not·configured,·this·field·in·dpkg | 72 | If·a·package·is·not·installed·or·not·configured,·this·field·in·dpkg’s·status |
| 73 | file·records·the·last·version·of·the·package·which·was·successfully·configured. | 73 | file·records·the·last·version·of·the·package·which·was·successfully·configured. |
| 74 | *\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.5\x85.\x8.·C\x8Co\x8on\x8nf\x8ff\x8fi\x8il\x8le\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 74 | *\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.5\x85.\x8.·C\x8Co\x8on\x8nf\x8ff\x8fi\x8il\x8le\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 75 | This·field·in·dpkg | 75 | This·field·in·dpkg’s·status·file·contains·information·about·the·automatically- |
| 76 | managed·configuration·files·held·by·a·package.·This·field·should·n\x8no\x8ot\x8t·appear | 76 | managed·configuration·files·held·by·a·package.·This·field·should·n\x8no\x8ot\x8t·appear |
| 77 | anywhere·in·a·package! | 77 | anywhere·in·a·package! |
| 78 | *\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.6\x86.\x8.·O\x8Ob\x8bs\x8so\x8ol\x8le\x8et\x8te\x8e·f\x8fi\x8ie\x8el\x8ld\x8ds\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 78 | *\x8**\x8**\x8**\x8*·4\x84.\x8.2\x82.\x8.6\x86.\x8.·O\x8Ob\x8bs\x8so\x8ol\x8le\x8et\x8te\x8e·f\x8fi\x8ie\x8el\x8ld\x8ds\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 79 | These·are·still·recognized·by·dpkg·but·should·not·appear·anywhere·any·more. | 79 | These·are·still·recognized·by·dpkg·but·should·not·appear·anywhere·any·more. |
| 80 | ··Revision;·Package-Revision;·Package_Revision | 80 | ··Revision;·Package-Revision;·Package_Revision |
| 81 | ······The·Debian·revision·part·of·the·package·version·was·at·one·point·in·a | 81 | ······The·Debian·revision·part·of·the·package·version·was·at·one·point·in·a |
| 82 | ······separate·control·field.·This·field·went·through·several·names. | 82 | ······separate·control·field.·This·field·went·through·several·names. |
| Offset 96, 20 lines modified | Offset 96, 20 lines modified | ||
| 96 | ··</div> | 96 | ··</div> |
| 97 | ··<hr/> | 97 | ··<hr/> |
| 98 | </div> | 98 | </div> |
| 99 | ··········<div·role="main"·class="document"·itemscope="itemscope"·itemtype="http://schema.org/Article"> | 99 | ··········<div·role="main"·class="document"·itemscope="itemscope"·itemtype="http://schema.org/Article"> |
| 100 | ···········<div·itemprop="articleBody"> | 100 | ···········<div·itemprop="articleBody"> |
| 101 | ············· | 101 | ············· |
| 102 | ··<section·id="diversions-overriding-a-package-s-version-of-a-file-from-old-packaging-manual"> | 102 | ··<section·id="diversions-overriding-a-package-s-version-of-a-file-from-old-packaging-manual"> |
| 103 | <h1><span·class="section-number">7.·</span>Diversions·-·overriding·a·package | 103 | <h1><span·class="section-number">7.·</span>Diversions·-·overriding·a·package’s·version·of·a·file·(from·old·Packaging·Manual)<a·class="headerlink"·href="#diversions-overriding-a-package-s-version-of-a-file-from-old-packaging-manual"·title="Link·to·this·heading"></a></h1> |
| 104 | <p>It·is·possible·to·have·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·not·overwrite·a·file·when·it·reinstalls | 104 | <p>It·is·possible·to·have·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·not·overwrite·a·file·when·it·reinstalls |
| 105 | the·package·it·belongs·to,·and·to·have·it·put·the·file·from·the·package | 105 | the·package·it·belongs·to,·and·to·have·it·put·the·file·from·the·package |
| 106 | somewhere·else·instead.</p> | 106 | somewhere·else·instead.</p> |
| 107 | <p>This·can·be·used·locally·to·override·a·package | 107 | <p>This·can·be·used·locally·to·override·a·package’s·version·of·a·file,·or |
| 108 | by·one·package·to·override·another | 108 | by·one·package·to·override·another’s·version·(or·provide·a·wrapper·for |
| 109 | it).</p> | 109 | it).</p> |
| 110 | <p>Before·deciding·to·use·a·diversion,·read | 110 | <p>Before·deciding·to·use·a·diversion,·read |
| 111 | <a·class="reference·internal"·href="ap-pkg-alternatives.html"><span·class="doc">Alternative·versions·of·an·interface·-·update-alternatives·(from·old·Packaging·Manual)</span></a>·to·see·if·you·really·want·a | 111 | <a·class="reference·internal"·href="ap-pkg-alternatives.html"><span·class="doc">Alternative·versions·of·an·interface·-·update-alternatives·(from·old·Packaging·Manual)</span></a>·to·see·if·you·really·want·a |
| 112 | diversion·rather·than·several·alternative·versions·of·a·program.</p> | 112 | diversion·rather·than·several·alternative·versions·of·a·program.</p> |
| 113 | <p>There·is·a·diversion·list,·which·is·read·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>,·and·updated·by·a | 113 | <p>There·is·a·diversion·list,·which·is·read·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>,·and·updated·by·a |
| 114 | special·program·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-divert</span></code>.·Please·see·<em·class="manpage">dpkg-divert(8)</em>·for | 114 | special·program·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-divert</span></code>.·Please·see·<em·class="manpage">dpkg-divert(8)</em>·for |
| 115 | full·details·of·its·operation.</p> | 115 | full·details·of·its·operation.</p> |
| Offset 117, 17 lines modified | Offset 117, 17 lines modified | ||
| 117 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg-divert</span></code>·in·its·preinst·to·add·the·diversion·and·rename·the | 117 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg-divert</span></code>·in·its·preinst·to·add·the·diversion·and·rename·the |
| 118 | existing·file.·For·example,·supposing·that·a·<code·class="docutils·literal·notranslate"><span·class="pre">smailwrapper</span></code>·package | 118 | existing·file.·For·example,·supposing·that·a·<code·class="docutils·literal·notranslate"><span·class="pre">smailwrapper</span></code>·package |
| 119 | wishes·to·install·a·wrapper·around·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/sbin/smail</span></code>:</p> | 119 | wishes·to·install·a·wrapper·around·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/sbin/smail</span></code>:</p> |
| 120 | <div·class="highlight-default·notranslate"><div·class="highlight"><pre><span></span><span·class="n">dpkg</span><span·class="o">-</span><span·class="n">divert</span>·<span·class="o">--</span><span·class="n">package</span>·<span·class="n">smailwrapper</span>·<span·class="o">--</span><span·class="n">add</span>·<span·class="o">--</span><span·class="n">rename</span>·\ | 120 | <div·class="highlight-default·notranslate"><div·class="highlight"><pre><span></span><span·class="n">dpkg</span><span·class="o">-</span><span·class="n">divert</span>·<span·class="o">--</span><span·class="n">package</span>·<span·class="n">smailwrapper</span>·<span·class="o">--</span><span·class="n">add</span>·<span·class="o">--</span><span·class="n">rename</span>·\ |
| 121 | ····<span·class="o">--</span><span·class="n">divert</span>·<span·class="o">/</span><span·class="n">usr</span><span·class="o">/</span><span·class="n">sbin</span><span·class="o">/</span><span·class="n">smail</span><span·class="o">.</span><span·class="n">real</span>·<span·class="o">/</span><span·class="n">usr</span><span·class="o">/</span><span·class="n">sbin</span><span·class="o">/</span><span·class="n">smail</span> | 121 | ····<span·class="o">--</span><span·class="n">divert</span>·<span·class="o">/</span><span·class="n">usr</span><span·class="o">/</span><span·class="n">sbin</span><span·class="o">/</span><span·class="n">smail</span><span·class="o">.</span><span·class="n">real</span>·<span·class="o">/</span><span·class="n">usr</span><span·class="o">/</span><span·class="n">sbin</span><span·class="o">/</span><span·class="n">smail</span> |
| 122 | </pre></div> | 122 | </pre></div> |
| 123 | </div> | 123 | </div> |
| 124 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">--package</span>·<span·class="pre">smailwrapper</span></code>·ensures·that·<code·class="docutils·literal·notranslate"><span·class="pre">smailwrapper</span></code> | 124 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">--package</span>·<span·class="pre">smailwrapper</span></code>·ensures·that·<code·class="docutils·literal·notranslate"><span·class="pre">smailwrapper</span></code>’s·copy·of |
| 125 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/sbin/smail</span></code>·can·bypass·the·diversion·and·get·installed·as·the | 125 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/sbin/smail</span></code>·can·bypass·the·diversion·and·get·installed·as·the |
| 126 | true·version.·It | 126 | true·version.·It’s·safe·to·add·the·diversion·unconditionally·on·upgrades |
| 127 | since·it·will·be·left·unchanged·if·it·already·exists,·but | 127 | since·it·will·be·left·unchanged·if·it·already·exists,·but |
| 128 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg-divert</span></code>·will·display·a·message.·To·suppress·that·message,·make | 128 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg-divert</span></code>·will·display·a·message.·To·suppress·that·message,·make |
| 129 | the·command·conditional·on·the·version·from·which·the·package·is·being | 129 | the·command·conditional·on·the·version·from·which·the·package·is·being |
| 130 | upgraded:</p> | 130 | upgraded:</p> |
| 131 | <div·class="highlight-default·notranslate"><div·class="highlight"><pre><span></span><span·class="k">if</span>·<span·class="p">[</span>·<span·class="n">upgrade</span>·<span·class="o">!=</span>·<span·class="s2">"$1"</span>·<span·class="p">]</span>·<span·class="o">||</span>·<span·class="n">dpkg</span>·<span·class="o">--</span><span·class="n">compare</span><span·class="o">-</span><span·class="n">versions</span>·<span·class="s2">"$2"</span>·<span·class="n">lt</span>·<span·class="mf">1.0</span><span·class="o">-</span><span·class="mi">2</span><span·class="p">;</span>·<span·class="n">then</span> | 131 | <div·class="highlight-default·notranslate"><div·class="highlight"><pre><span></span><span·class="k">if</span>·<span·class="p">[</span>·<span·class="n">upgrade</span>·<span·class="o">!=</span>·<span·class="s2">"$1"</span>·<span·class="p">]</span>·<span·class="o">||</span>·<span·class="n">dpkg</span>·<span·class="o">--</span><span·class="n">compare</span><span·class="o">-</span><span·class="n">versions</span>·<span·class="s2">"$2"</span>·<span·class="n">lt</span>·<span·class="mf">1.0</span><span·class="o">-</span><span·class="mi">2</span><span·class="p">;</span>·<span·class="n">then</span> |
| 132 | ····<span·class="n">dpkg</span><span·class="o">-</span><span·class="n">divert</span>·<span·class="o">--</span><span·class="n">package</span>·<span·class="n">smailwrapper</span>·<span·class="o">--</span><span·class="n">add</span>·<span·class="o">--</span><span·class="n">rename</span>·\ | 132 | ····<span·class="n">dpkg</span><span·class="o">-</span><span·class="n">divert</span>·<span·class="o">--</span><span·class="n">package</span>·<span·class="n">smailwrapper</span>·<span·class="o">--</span><span·class="n">add</span>·<span·class="o">--</span><span·class="n">rename</span>·\ |
| 133 | ········<span·class="o">--</span><span·class="n">divert</span>·<span·class="o">/</span><span·class="n">usr</span><span·class="o">/</span><span·class="n">sbin</span><span·class="o">/</span><span·class="n">smail</span><span·class="o">.</span><span·class="n">real</span>·<span·class="o">/</span><span·class="n">usr</span><span·class="o">/</span><span·class="n">sbin</span><span·class="o">/</span><span·class="n">smail</span> | 133 | ········<span·class="o">--</span><span·class="n">divert</span>·<span·class="o">/</span><span·class="n">usr</span><span·class="o">/</span><span·class="n">sbin</span><span·class="o">/</span><span·class="n">smail</span><span·class="o">.</span><span·class="n">real</span>·<span·class="o">/</span><span·class="n">usr</span><span·class="o">/</span><span·class="n">sbin</span><span·class="o">/</span><span·class="n">smail</span> |
| Offset 152, 19 lines modified | Offset 152, 19 lines modified | ||
| 152 | ····<span·class="n">dpkg</span><span·class="o">-</span><span·class="n">divert</span>·<span·class="o">--</span><span·class="n">package</span>·<span·class="n">smailwrapper</span>·<span·class="o">--</span><span·class="n">remove</span>·<span·class="o">--</span><span·class="n">rename</span>·\ | 152 | ····<span·class="n">dpkg</span><span·class="o">-</span><span·class="n">divert</span>·<span·class="o">--</span><span·class="n">package</span>·<span·class="n">smailwrapper</span>·<span·class="o">--</span><span·class="n">remove</span>·<span·class="o">--</span><span·class="n">rename</span>·\ |
| 153 | ········<span·class="o">--</span><span·class="n">divert</span>·<span·class="o">/</span><span·class="n">usr</span><span·class="o">/</span><span·class="n">sbin</span><span·class="o">/</span><span·class="n">smail</span><span·class="o">.</span><span·class="n">real</span>·<span·class="o">/</span><span·class="n">usr</span><span·class="o">/</span><span·class="n">sbin</span><span·class="o">/</span><span·class="n">smail</span> | 153 | ········<span·class="o">--</span><span·class="n">divert</span>·<span·class="o">/</span><span·class="n">usr</span><span·class="o">/</span><span·class="n">sbin</span><span·class="o">/</span><span·class="n">smail</span><span·class="o">.</span><span·class="n">real</span>·<span·class="o">/</span><span·class="n">usr</span><span·class="o">/</span><span·class="n">sbin</span><span·class="o">/</span><span·class="n">smail</span> |
| 154 | <span·class="n">fi</span> | 154 | <span·class="n">fi</span> |
| 155 | </pre></div> | 155 | </pre></div> |
| 156 | </div> | 156 | </div> |
| 157 | <p>where·<code·class="docutils·literal·notranslate"><span·class="pre">1.0-2</span></code>·is·the·version·at·which·the·diversion·was·first·added·to | 157 | <p>where·<code·class="docutils·literal·notranslate"><span·class="pre">1.0-2</span></code>·is·the·version·at·which·the·diversion·was·first·added·to |
| 158 | the·package.·The·postrm·should·not·remove·the·diversion·on·upgrades·both | 158 | the·package.·The·postrm·should·not·remove·the·diversion·on·upgrades·both |
| 159 | because·there | 159 | because·there’s·no·reason·to·remove·the·diversion·only·to·immediately |
| 160 | re-add·it·and·since·the·postrm·of·the·old·package·is·run·after·unpacking | 160 | re-add·it·and·since·the·postrm·of·the·old·package·is·run·after·unpacking |
| 161 | so·the·removal·of·the·diversion·will·fail.</p> | 161 | so·the·removal·of·the·diversion·will·fail.</p> |
| 162 | <p>Do·not·attempt·to·divert·a·file·which·is·vitally·important·for·the | 162 | <p>Do·not·attempt·to·divert·a·file·which·is·vitally·important·for·the |
| 163 | system | 163 | system’s·operation·-·when·using·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-divert</span></code>·there·is·a·time,·after |
| 164 | it·has·been·diverted·but·before·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·has·installed·the·new·version, | 164 | it·has·been·diverted·but·before·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·has·installed·the·new·version, |
| 165 | when·the·file·does·not·exist.</p> | 165 | when·the·file·does·not·exist.</p> |
| 166 | <p>Do·not·attempt·to·divert·a·conffile,·as·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·does·not·handle·it | 166 | <p>Do·not·attempt·to·divert·a·conffile,·as·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·does·not·handle·it |
| 167 | well.</p> | 167 | well.</p> |
| 168 | <p>Do·not·use·diversions·for·files·that·have·their·own·native·override·mechanisms, | 168 | <p>Do·not·use·diversions·for·files·that·have·their·own·native·override·mechanisms, |
| 169 | such·as·<code·class="docutils·literal·notranslate"><span·class="pre">systemd</span></code>·unit·files.·See·<a·class="reference·internal"·href="ch-binary.html"><span·class="doc">Binary·packages</span></a>·for·more·information.</p> | 169 | such·as·<code·class="docutils·literal·notranslate"><span·class="pre">systemd</span></code>·unit·files.·See·<a·class="reference·internal"·href="ch-binary.html"><span·class="doc">Binary·packages</span></a>·for·more·information.</p> |
| 170 | </section> | 170 | </section> |
| Offset 28, 35 lines modified | Offset 28, 35 lines modified | ||
| 28 | ····*·_\x81_\x81_\x8._\x8·_\x8L_\x8i_\x8c_\x8e_\x8n_\x8s_\x8e | 28 | ····*·_\x81_\x81_\x8._\x8·_\x8L_\x8i_\x8c_\x8e_\x8n_\x8s_\x8e |
| 29 | _\x8D_\x8e_\x8b_\x8i_\x8a_\x8n_\x8·_\x8P_\x8o_\x8l_\x8i_\x8c_\x8y_\x8·_\x8M_\x8a_\x8n_\x8u_\x8a_\x8l | 29 | _\x8D_\x8e_\x8b_\x8i_\x8a_\x8n_\x8·_\x8P_\x8o_\x8l_\x8i_\x8c_\x8y_\x8·_\x8M_\x8a_\x8n_\x8u_\x8a_\x8l |
| 30 | ····*·7.·Diversions·-·overriding·a·package’s·version·of·a·file·(from·old | 30 | ····*·7.·Diversions·-·overriding·a·package’s·version·of·a·file·(from·old |
| 31 | ······Packaging·Manual) | 31 | ······Packaging·Manual) |
| 32 | ····*·_\x8V_\x8i_\x8e_\x8w_\x8·_\x8p_\x8a_\x8g_\x8e_\x8·_\x8s_\x8o_\x8u_\x8r_\x8c_\x8e | 32 | ····*·_\x8V_\x8i_\x8e_\x8w_\x8·_\x8p_\x8a_\x8g_\x8e_\x8·_\x8s_\x8o_\x8u_\x8r_\x8c_\x8e |
| 33 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t | 33 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t |
| 34 | =============================================================================== | 34 | =============================================================================== |
| 35 | *\x8**\x8**\x8**\x8**\x8**\x8*·7\x87.\x8.·D\x8Di\x8iv\x8ve\x8er\x8rs\x8si\x8io\x8on\x8ns\x8s·-\x8-·o\x8ov\x8ve\x8er\x8rr\x8ri\x8id\x8di\x8in\x8ng\x8g·a\x8a·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e | 35 | *\x8**\x8**\x8**\x8**\x8**\x8*·7\x87.\x8.·D\x8Di\x8iv\x8ve\x8er\x8rs\x8si\x8io\x8on\x8ns\x8s·-\x8-·o\x8ov\x8ve\x8er\x8rr\x8ri\x8id\x8di\x8in\x8ng\x8g·a\x8a·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e?.’s\x8s·v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·o\x8of\x8f·a\x8a·f\x8fi\x8il\x8le\x8e·(\x8(f\x8fr\x8ro\x8om\x8m·o\x8ol\x8ld\x8d |
| 36 | P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8gi\x8in\x8ng\x8g·M\x8Ma\x8an\x8nu\x8ua\x8al\x8l)\x8)_\x8?\x8·*\x8**\x8**\x8**\x8**\x8**\x8* | 36 | P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8gi\x8in\x8ng\x8g·M\x8Ma\x8an\x8nu\x8ua\x8al\x8l)\x8)_\x8?\x8·*\x8**\x8**\x8**\x8**\x8**\x8* |
| 37 | It·is·possible·to·have·dpkg·not·overwrite·a·file·when·it·reinstalls·the·package | 37 | It·is·possible·to·have·dpkg·not·overwrite·a·file·when·it·reinstalls·the·package |
| 38 | it·belongs·to,·and·to·have·it·put·the·file·from·the·package·somewhere·else | 38 | it·belongs·to,·and·to·have·it·put·the·file·from·the·package·somewhere·else |
| 39 | instead. | 39 | instead. |
| 40 | This·can·be·used·locally·to·override·a·package | 40 | This·can·be·used·locally·to·override·a·package’s·version·of·a·file,·or·by·one |
| 41 | package·to·override·another | 41 | package·to·override·another’s·version·(or·provide·a·wrapper·for·it). |
| 42 | Before·deciding·to·use·a·diversion,·read·_\x8A_\x8l_\x8t_\x8e_\x8r_\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8·_\x8v_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n_\x8s_\x8·_\x8o_\x8f_\x8·_\x8a_\x8n_\x8·_\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e_\x8·_\x8- | 42 | Before·deciding·to·use·a·diversion,·read·_\x8A_\x8l_\x8t_\x8e_\x8r_\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8·_\x8v_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n_\x8s_\x8·_\x8o_\x8f_\x8·_\x8a_\x8n_\x8·_\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e_\x8·_\x8- |
| 43 | _\x8u_\x8p_\x8d_\x8a_\x8t_\x8e_\x8-_\x8a_\x8l_\x8t_\x8e_\x8r_\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8s_\x8·_\x8(_\x8f_\x8r_\x8o_\x8m_\x8·_\x8o_\x8l_\x8d_\x8·_\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8i_\x8n_\x8g_\x8·_\x8M_\x8a_\x8n_\x8u_\x8a_\x8l_\x8)·to·see·if·you·really·want·a | 43 | _\x8u_\x8p_\x8d_\x8a_\x8t_\x8e_\x8-_\x8a_\x8l_\x8t_\x8e_\x8r_\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8s_\x8·_\x8(_\x8f_\x8r_\x8o_\x8m_\x8·_\x8o_\x8l_\x8d_\x8·_\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8i_\x8n_\x8g_\x8·_\x8M_\x8a_\x8n_\x8u_\x8a_\x8l_\x8)·to·see·if·you·really·want·a |
| 44 | diversion·rather·than·several·alternative·versions·of·a·program. | 44 | diversion·rather·than·several·alternative·versions·of·a·program. |
| 45 | There·is·a·diversion·list,·which·is·read·by·dpkg,·and·updated·by·a·special | 45 | There·is·a·diversion·list,·which·is·read·by·dpkg,·and·updated·by·a·special |
| 46 | program·dpkg-divert.·Please·see·d\x8dp\x8pk\x8kg\x8g-\x8-d\x8di\x8iv\x8ve\x8er\x8rt\x8t(\x8(8\x88)\x8)·for·full·details·of·its | 46 | program·dpkg-divert.·Please·see·d\x8dp\x8pk\x8kg\x8g-\x8-d\x8di\x8iv\x8ve\x8er\x8rt\x8t(\x8(8\x88)\x8)·for·full·details·of·its |
| 47 | operation. | 47 | operation. |
| 48 | When·a·package·wishes·to·divert·a·file·from·another,·it·should·call·dpkg-divert | 48 | When·a·package·wishes·to·divert·a·file·from·another,·it·should·call·dpkg-divert |
| 49 | in·its·preinst·to·add·the·diversion·and·rename·the·existing·file.·For·example, | 49 | in·its·preinst·to·add·the·diversion·and·rename·the·existing·file.·For·example, |
| 50 | supposing·that·a·smailwrapper·package·wishes·to·install·a·wrapper·around·/usr/ | 50 | supposing·that·a·smailwrapper·package·wishes·to·install·a·wrapper·around·/usr/ |
| 51 | sbin/smail: | 51 | sbin/smail: |
| 52 | dpkg-divert·--package·smailwrapper·--add·--rename·\ | 52 | dpkg-divert·--package·smailwrapper·--add·--rename·\ |
| 53 | ····--divert·/usr/sbin/smail.real·/usr/sbin/smail | 53 | ····--divert·/usr/sbin/smail.real·/usr/sbin/smail |
| 54 | The·--package·smailwrapper·ensures·that·smailwrapper | 54 | The·--package·smailwrapper·ensures·that·smailwrapper’s·copy·of·/usr/sbin/smail |
| 55 | can·bypass·the·diversion·and·get·installed·as·the·true·version.·It | 55 | can·bypass·the·diversion·and·get·installed·as·the·true·version.·It’s·safe·to |
| 56 | add·the·diversion·unconditionally·on·upgrades·since·it·will·be·left·unchanged | 56 | add·the·diversion·unconditionally·on·upgrades·since·it·will·be·left·unchanged |
| 57 | if·it·already·exists,·but·dpkg-divert·will·display·a·message.·To·suppress·that | 57 | if·it·already·exists,·but·dpkg-divert·will·display·a·message.·To·suppress·that |
| 58 | message,·make·the·command·conditional·on·the·version·from·which·the·package·is | 58 | message,·make·the·command·conditional·on·the·version·from·which·the·package·is |
| 59 | being·upgraded: | 59 | being·upgraded: |
| 60 | if·[·upgrade·!=·"$1"·]·||·dpkg·--compare-versions·"$2"·lt·1.0-2;·then | 60 | if·[·upgrade·!=·"$1"·]·||·dpkg·--compare-versions·"$2"·lt·1.0-2;·then |
| 61 | ····dpkg-divert·--package·smailwrapper·--add·--rename·\ | 61 | ····dpkg-divert·--package·smailwrapper·--add·--rename·\ |
| 62 | ········--divert·/usr/sbin/smail.real·/usr/sbin/smail | 62 | ········--divert·/usr/sbin/smail.real·/usr/sbin/smail |
| Offset 73, 18 lines modified | Offset 73, 18 lines modified | ||
| 73 | version·is·so·old·that·direct·upgrades·are·no·longer·supported): | 73 | version·is·so·old·that·direct·upgrades·are·no·longer·supported): |
| 74 | if·[·abort-upgrade·=·"$1"·]·&&·dpkg·--compare-versions·"$2"·lt·1.0-2;·then | 74 | if·[·abort-upgrade·=·"$1"·]·&&·dpkg·--compare-versions·"$2"·lt·1.0-2;·then |
| 75 | ····dpkg-divert·--package·smailwrapper·--remove·--rename·\ | 75 | ····dpkg-divert·--package·smailwrapper·--remove·--rename·\ |
| 76 | ········--divert·/usr/sbin/smail.real·/usr/sbin/smail | 76 | ········--divert·/usr/sbin/smail.real·/usr/sbin/smail |
| 77 | fi | 77 | fi |
| 78 | where·1.0-2·is·the·version·at·which·the·diversion·was·first·added·to·the | 78 | where·1.0-2·is·the·version·at·which·the·diversion·was·first·added·to·the |
| 79 | package.·The·postrm·should·not·remove·the·diversion·on·upgrades·both·because | 79 | package.·The·postrm·should·not·remove·the·diversion·on·upgrades·both·because |
| 80 | there | 80 | there’s·no·reason·to·remove·the·diversion·only·to·immediately·re-add·it·and |
| 81 | since·the·postrm·of·the·old·package·is·run·after·unpacking·so·the·removal·of | 81 | since·the·postrm·of·the·old·package·is·run·after·unpacking·so·the·removal·of |
| 82 | the·diversion·will·fail. | 82 | the·diversion·will·fail. |
| 83 | Do·not·attempt·to·divert·a·file·which·is·vitally·important·for·the·system | 83 | Do·not·attempt·to·divert·a·file·which·is·vitally·important·for·the·system’s |
| 84 | operation·-·when·using·dpkg-divert·there·is·a·time,·after·it·has·been·diverted | 84 | operation·-·when·using·dpkg-divert·there·is·a·time,·after·it·has·been·diverted |
| 85 | but·before·dpkg·has·installed·the·new·version,·when·the·file·does·not·exist. | 85 | but·before·dpkg·has·installed·the·new·version,·when·the·file·does·not·exist. |
| 86 | Do·not·attempt·to·divert·a·conffile,·as·dpkg·does·not·handle·it·well. | 86 | Do·not·attempt·to·divert·a·conffile,·as·dpkg·does·not·handle·it·well. |
| 87 | Do·not·use·diversions·for·files·that·have·their·own·native·override·mechanisms, | 87 | Do·not·use·diversions·for·files·that·have·their·own·native·override·mechanisms, |
| 88 | such·as·systemd·unit·files.·See·_\x8B_\x8i_\x8n_\x8a_\x8r_\x8y_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8s·for·more·information. | 88 | such·as·systemd·unit·files.·See·_\x8B_\x8i_\x8n_\x8a_\x8r_\x8y_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8s·for·more·information. |
| 89 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t | 89 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t |
| 90 | =============================================================================== | 90 | =============================================================================== |
| Offset 128, 24 lines modified | Offset 128, 24 lines modified | ||
| 128 | of·some·packages.</p> | 128 | of·some·packages.</p> |
| 129 | <p>This·manual·describes·the·technical·aspects·of·creating·Debian·binary | 129 | <p>This·manual·describes·the·technical·aspects·of·creating·Debian·binary |
| 130 | packages·(<code·class="docutils·literal·notranslate"><span·class="pre">.deb</span></code>·files).·It·documents·the·behavior·of·the·package | 130 | packages·(<code·class="docutils·literal·notranslate"><span·class="pre">.deb</span></code>·files).·It·documents·the·behavior·of·the·package |
| 131 | management·programs·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>,·<code·class="docutils·literal·notranslate"><span·class="pre">dselect</span></code>·et·al.·and·the·way·they | 131 | management·programs·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>,·<code·class="docutils·literal·notranslate"><span·class="pre">dselect</span></code>·et·al.·and·the·way·they |
| 132 | interact·with·packages.</p> | 132 | interact·with·packages.</p> |
| 133 | <p>This·manual·does·not·go·into·detail·about·the·options·and·usage·of·the | 133 | <p>This·manual·does·not·go·into·detail·about·the·options·and·usage·of·the |
| 134 | package·building·and·installation·tools.·It·should·therefore·be·read·in | 134 | package·building·and·installation·tools.·It·should·therefore·be·read·in |
| 135 | conjunction·with·those·programs | 135 | conjunction·with·those·programs’·man·pages.</p> |
| 136 | <p>The·utility·programs·which·are·provided·with·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·not·described·in | 136 | <p>The·utility·programs·which·are·provided·with·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·not·described·in |
| 137 | detail·here,·are·documented·in·their·man·pages.</p> | 137 | detail·here,·are·documented·in·their·man·pages.</p> |
| 138 | <p>It·is·assumed·that·the·reader·is·reasonably·familiar·with·the·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code> | 138 | <p>It·is·assumed·that·the·reader·is·reasonably·familiar·with·the·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code> |
| 139 | System·Administrators | 139 | System·Administrators’·manual.·Unfortunately·this·manual·does·not·yet |
| 140 | exist.</p> | 140 | exist.</p> |
| 141 | <p>The·Debian·version·of·the·FSF | 141 | <p>The·Debian·version·of·the·FSF’s·GNU·hello·program·is·provided·as·an |
| 142 | example·for·people·wishing·to·create·Debian·packages.·However,·while·the | 142 | example·for·people·wishing·to·create·Debian·packages.·However,·while·the |
| 143 | examples·are·helpful,·they·do·not·replace·the·need·to·read·and·follow | 143 | examples·are·helpful,·they·do·not·replace·the·need·to·read·and·follow |
| 144 | the·Policy·and·Programmer | 144 | the·Policy·and·Programmer’s·Manual.</p> |
| 145 | <aside·class="footnote-list·brackets"> | 145 | <aside·class="footnote-list·brackets"> |
| 146 | <aside·class="footnote·brackets"·id="id2"·role="doc-footnote"> | 146 | <aside·class="footnote·brackets"·id="id2"·role="doc-footnote"> |
| 147 | <span·class="label"><span·class="fn-bracket">[</span><a·role="doc-backlink"·href="#id1">1</a><span·class="fn-bracket">]</span></span> | 147 | <span·class="label"><span·class="fn-bracket">[</span><a·role="doc-backlink"·href="#id1">1</a><span·class="fn-bracket">]</span></span> |
| 148 | <p><code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·is·targeted·primarily·at·Debian,·but·may·work·on·or·be | 148 | <p><code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·is·targeted·primarily·at·Debian,·but·may·work·on·or·be |
| 149 | ported·to·other·systems.</p> | 149 | ported·to·other·systems.</p> |
| 150 | </aside> | 150 | </aside> |
| 151 | </aside> | 151 | </aside> |
| Offset 55, 21 lines modified | Offset 55, 21 lines modified | ||
| 55 | programs·(usually·compiled·binaries)·and·their·associated·data,·though·source | 55 | programs·(usually·compiled·binaries)·and·their·associated·data,·though·source |
| 56 | code·examples·and·documentation·are·provided·as·part·of·some·packages. | 56 | code·examples·and·documentation·are·provided·as·part·of·some·packages. |
| 57 | This·manual·describes·the·technical·aspects·of·creating·Debian·binary·packages | 57 | This·manual·describes·the·technical·aspects·of·creating·Debian·binary·packages |
| 58 | (.deb·files).·It·documents·the·behavior·of·the·package·management·programs | 58 | (.deb·files).·It·documents·the·behavior·of·the·package·management·programs |
| 59 | dpkg,·dselect·et·al.·and·the·way·they·interact·with·packages. | 59 | dpkg,·dselect·et·al.·and·the·way·they·interact·with·packages. |
| 60 | This·manual·does·not·go·into·detail·about·the·options·and·usage·of·the·package | 60 | This·manual·does·not·go·into·detail·about·the·options·and·usage·of·the·package |
| 61 | building·and·installation·tools.·It·should·therefore·be·read·in·conjunction | 61 | building·and·installation·tools.·It·should·therefore·be·read·in·conjunction |
| 62 | with·those·programs | 62 | with·those·programs’·man·pages. |
| 63 | The·utility·programs·which·are·provided·with·dpkg·not·described·in·detail·here, | 63 | The·utility·programs·which·are·provided·with·dpkg·not·described·in·detail·here, |
| 64 | are·documented·in·their·man·pages. | 64 | are·documented·in·their·man·pages. |
| 65 | It·is·assumed·that·the·reader·is·reasonably·familiar·with·the·dpkg·System | 65 | It·is·assumed·that·the·reader·is·reasonably·familiar·with·the·dpkg·System |
| 66 | Administrators | 66 | Administrators’·manual.·Unfortunately·this·manual·does·not·yet·exist. |
| 67 | The·Debian·version·of·the·FSF | 67 | The·Debian·version·of·the·FSF’s·GNU·hello·program·is·provided·as·an·example·for |
| 68 | people·wishing·to·create·Debian·packages.·However,·while·the·examples·are | 68 | people·wishing·to·create·Debian·packages.·However,·while·the·examples·are |
| 69 | helpful,·they·do·not·replace·the·need·to·read·and·follow·the·Policy·and | 69 | helpful,·they·do·not·replace·the·need·to·read·and·follow·the·Policy·and |
| 70 | Programmer | 70 | Programmer’s·Manual. |
| 71 | [_\x81] | 71 | [_\x81] |
| 72 | dpkg·is·targeted·primarily·at·Debian,·but·may·work·on·or·be·ported·to·other | 72 | dpkg·is·targeted·primarily·at·Debian,·but·may·work·on·or·be·ported·to·other |
| 73 | systems. | 73 | systems. |
| 74 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t | 74 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t |
| 75 | =============================================================================== | 75 | =============================================================================== |
| Offset 184, 27 lines modified | Offset 184, 27 lines modified | ||
| 184 | it·in·<code·class="docutils·literal·notranslate"><span·class="pre">debian/tmp</span></code>·relative·to·the·top·of·the·source·package,·it·is | 184 | it·in·<code·class="docutils·literal·notranslate"><span·class="pre">debian/tmp</span></code>·relative·to·the·top·of·the·source·package,·it·is |
| 185 | usually·sufficient·to·call·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-gencontrol</span></code>.</p> | 185 | usually·sufficient·to·call·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-gencontrol</span></code>.</p> |
| 186 | <p>Sources·which·build·several·binaries·will·typically·need·something·like:</p> | 186 | <p>Sources·which·build·several·binaries·will·typically·need·something·like:</p> |
| 187 | <div·class="highlight-default·notranslate"><div·class="highlight"><pre><span></span><span·class="n">dpkg</span><span·class="o">-</span><span·class="n">gencontrol</span>·<span·class="o">-</span><span·class="n">Pdebian</span><span·class="o">/</span><span·class="n">pkg</span>·<span·class="o">-</span><span·class="n">ppackage</span> | 187 | <div·class="highlight-default·notranslate"><div·class="highlight"><pre><span></span><span·class="n">dpkg</span><span·class="o">-</span><span·class="n">gencontrol</span>·<span·class="o">-</span><span·class="n">Pdebian</span><span·class="o">/</span><span·class="n">pkg</span>·<span·class="o">-</span><span·class="n">ppackage</span> |
| 188 | </pre></div> | 188 | </pre></div> |
| 189 | </div> | 189 | </div> |
| 190 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">-P</span></code>·tells·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-gencontrol</span></code>·that·the·package·is·being·built·in | 190 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">-P</span></code>·tells·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-gencontrol</span></code>·that·the·package·is·being·built·in |
| 191 | a·non-default·directory,·and·the·<code·class="docutils·literal·notranslate"><span·class="pre">-p</span></code>·tells·it·which·binary·package | 191 | a·non-default·directory,·and·the·<code·class="docutils·literal·notranslate"><span·class="pre">-p</span></code>·tells·it·which·binary·package’s |
| 192 | control·file·should·be·generated.</p> | 192 | control·file·should·be·generated.</p> |
| 193 | <p><code·class="docutils·literal·notranslate"><span·class="pre">dpkg-gencontrol</span></code>·also·adds·information·to·the·list·of·files·in | 193 | <p><code·class="docutils·literal·notranslate"><span·class="pre">dpkg-gencontrol</span></code>·also·adds·information·to·the·list·of·files·in |
| 194 | <code·class="docutils·literal·notranslate"><span·class="pre">debian/files</span></code>,·for·the·benefit·of·(for·example)·a·future·invocation | 194 | <code·class="docutils·literal·notranslate"><span·class="pre">debian/files</span></code>,·for·the·benefit·of·(for·example)·a·future·invocation |
| 195 | of·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-genchanges</span></code>.</p> | 195 | of·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-genchanges</span></code>.</p> |
| 196 | </section> | 196 | </section> |
| 197 | <section·id="dpkg-shlibdeps-calculates-shared-library-dependencies"> | 197 | <section·id="dpkg-shlibdeps-calculates-shared-library-dependencies"> |
| 198 | <span·id="s-pkg-dpkg-shlibdeps"></span><h3><span·class="section-number">3.1.4.·</span><code·class="docutils·literal·notranslate"><span·class="pre">dpkg-shlibdeps</span></code>·-·calculates·shared·library·dependencies<a·class="headerlink"·href="#dpkg-shlibdeps-calculates-shared-library-dependencies"·title="Link·to·this·heading"></a></h3> | 198 | <span·id="s-pkg-dpkg-shlibdeps"></span><h3><span·class="section-number">3.1.4.·</span><code·class="docutils·literal·notranslate"><span·class="pre">dpkg-shlibdeps</span></code>·-·calculates·shared·library·dependencies<a·class="headerlink"·href="#dpkg-shlibdeps-calculates-shared-library-dependencies"·title="Link·to·this·heading"></a></h3> |
| 199 | <p>See·<em·class="manpage">dpkg-shlibdeps(1)</em>.</p> | 199 | <p>See·<em·class="manpage">dpkg-shlibdeps(1)</em>.</p> |
| 200 | </section> | 200 | </section> |
| 201 | <section·id="dpkg-distaddfile-adds-a-file-to-debian-files"> | 201 | <section·id="dpkg-distaddfile-adds-a-file-to-debian-files"> |
| 202 | <span·id="s-pkg-dpkg-distaddfile"></span><h3><span·class="section-number">3.1.5.·</span><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·class="headerlink"·href="#dpkg-distaddfile-adds-a-file-to-debian-files"·title="Link·to·this·heading"></a></h3> | 202 | <span·id="s-pkg-dpkg-distaddfile"></span><h3><span·class="section-number">3.1.5.·</span><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·class="headerlink"·href="#dpkg-distaddfile-adds-a-file-to-debian-files"·title="Link·to·this·heading"></a></h3> |
| 203 | <p>Some·packages | 203 | <p>Some·packages’·uploads·need·to·include·files·other·than·the·source·and |
| 204 | binary·package·files.</p> | 204 | binary·package·files.</p> |
| 205 | <p><code·class="docutils·literal·notranslate"><span·class="pre">dpkg-distaddfile</span></code>·adds·a·file·to·the·<code·class="docutils·literal·notranslate"><span·class="pre">debian/files</span></code>·file·so·that·it | 205 | <p><code·class="docutils·literal·notranslate"><span·class="pre">dpkg-distaddfile</span></code>·adds·a·file·to·the·<code·class="docutils·literal·notranslate"><span·class="pre">debian/files</span></code>·file·so·that·it |
| 206 | will·be·included·in·the·<code·class="docutils·literal·notranslate"><span·class="pre">.changes</span></code>·file·when·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-genchanges</span></code>·is | 206 | will·be·included·in·the·<code·class="docutils·literal·notranslate"><span·class="pre">.changes</span></code>·file·when·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-genchanges</span></code>·is |
| 207 | run.</p> | 207 | run.</p> |
| 208 | <p>It·is·usually·invoked·from·the·<code·class="docutils·literal·notranslate"><span·class="pre">binary</span></code>·target·of·<code·class="docutils·literal·notranslate"><span·class="pre">debian/rules</span></code>:</p> | 208 | <p>It·is·usually·invoked·from·the·<code·class="docutils·literal·notranslate"><span·class="pre">binary</span></code>·target·of·<code·class="docutils·literal·notranslate"><span·class="pre">debian/rules</span></code>:</p> |
| 209 | <div·class="highlight-default·notranslate"><div·class="highlight"><pre><span></span><span·class="n">dpkg</span><span·class="o">-</span><span·class="n">distaddfile</span>·<span·class="n">filename</span>·<span·class="n">section</span>·<span·class="n">priority</span> | 209 | <div·class="highlight-default·notranslate"><div·class="highlight"><pre><span></span><span·class="n">dpkg</span><span·class="o">-</span><span·class="n">distaddfile</span>·<span·class="n">filename</span>·<span·class="n">section</span>·<span·class="n">priority</span> |
| 210 | </pre></div> | 210 | </pre></div> |
| Offset 253, 15 lines modified | Offset 253, 15 lines modified | ||
| 253 | <p>See·<a·class="reference·internal"·href="ch-source.html#s-debianfiles"><span·class="std·std-ref">Generated·files·list:·debian/files</span></a>.</p> | 253 | <p>See·<a·class="reference·internal"·href="ch-source.html#s-debianfiles"><span·class="std·std-ref">Generated·files·list:·debian/files</span></a>.</p> |
| 254 | </section> | 254 | </section> |
| 255 | <section·id="debian-tmp"> | 255 | <section·id="debian-tmp"> |
| 256 | <span·id="s-sc-2-4"></span><h3><span·class="section-number">3.2.4.·</span><code·class="docutils·literal·notranslate"><span·class="pre">debian/tmp</span></code><a·class="headerlink"·href="#debian-tmp"·title="Link·to·this·heading"></a></h3> | 256 | <span·id="s-sc-2-4"></span><h3><span·class="section-number">3.2.4.·</span><code·class="docutils·literal·notranslate"><span·class="pre">debian/tmp</span></code><a·class="headerlink"·href="#debian-tmp"·title="Link·to·this·heading"></a></h3> |
| 257 | <p>This·is·the·default·temporary·location·for·the·construction·of·binary | 257 | <p>This·is·the·default·temporary·location·for·the·construction·of·binary |
| 258 | packages·by·the·<code·class="docutils·literal·notranslate"><span·class="pre">binary</span></code>·target.·The·directory·<code·class="docutils·literal·notranslate"><span·class="pre">tmp</span></code>·serves·as·the | 258 | packages·by·the·<code·class="docutils·literal·notranslate"><span·class="pre">binary</span></code>·target.·The·directory·<code·class="docutils·literal·notranslate"><span·class="pre">tmp</span></code>·serves·as·the |
| 259 | root·of·the·file·system·tree·as·it·is·being·constructed·(for·example,·by | 259 | root·of·the·file·system·tree·as·it·is·being·constructed·(for·example,·by |
| 260 | using·the·package | 260 | using·the·package’s·upstream·makefiles·install·targets·and·redirecting |
| 261 | the·output·there),·and·it·also·contains·the·<code·class="docutils·literal·notranslate"><span·class="pre">DEBIAN</span></code>·subdirectory.·See | 261 | the·output·there),·and·it·also·contains·the·<code·class="docutils·literal·notranslate"><span·class="pre">DEBIAN</span></code>·subdirectory.·See |
| 262 | <a·class="reference·internal"·href="ap-pkg-binarypkg.html#s-pkg-bincreating"><span·class="std·std-ref">Creating·package·files·-·dpkg-deb</span></a>.</p> | 262 | <a·class="reference·internal"·href="ap-pkg-binarypkg.html#s-pkg-bincreating"><span·class="std·std-ref">Creating·package·files·-·dpkg-deb</span></a>.</p> |
| 263 | <p>This·is·only·a·default·and·can·be·easily·overridden.·Most·packaging | 263 | <p>This·is·only·a·default·and·can·be·easily·overridden.·Most·packaging |
| 264 | tools·no·longer·use·<code·class="docutils·literal·notranslate"><span·class="pre">debian/tmp</span></code>,·instead·preferring·<code·class="docutils·literal·notranslate"><span·class="pre">debian/pkg</span></code> | 264 | tools·no·longer·use·<code·class="docutils·literal·notranslate"><span·class="pre">debian/tmp</span></code>,·instead·preferring·<code·class="docutils·literal·notranslate"><span·class="pre">debian/pkg</span></code> |
| 265 | for·the·common·case·of·a·source·package·building·only·one·binary | 265 | for·the·common·case·of·a·source·package·building·only·one·binary |
| 266 | package.·Such·tools·usually·only·use·<code·class="docutils·literal·notranslate"><span·class="pre">debian/tmp</span></code>·as·a·temporary | 266 | package.·Such·tools·usually·only·use·<code·class="docutils·literal·notranslate"><span·class="pre">debian/tmp</span></code>·as·a·temporary |
| 267 | staging·area·for·built·files·and·do·not·construct·packages·from·it.</p> | 267 | staging·area·for·built·files·and·do·not·construct·packages·from·it.</p> |
| Offset 97, 22 lines modified | Offset 97, 22 lines modified | ||
| 97 | available. | 97 | available. |
| 98 | For·a·package·which·generates·only·one·binary·package,·and·which·builds·it·in | 98 | For·a·package·which·generates·only·one·binary·package,·and·which·builds·it·in |
| 99 | debian/tmp·relative·to·the·top·of·the·source·package,·it·is·usually·sufficient | 99 | debian/tmp·relative·to·the·top·of·the·source·package,·it·is·usually·sufficient |
| 100 | to·call·dpkg-gencontrol. | 100 | to·call·dpkg-gencontrol. |
| 101 | Sources·which·build·several·binaries·will·typically·need·something·like: | 101 | Sources·which·build·several·binaries·will·typically·need·something·like: |
| 102 | dpkg-gencontrol·-Pdebian/pkg·-ppackage | 102 | dpkg-gencontrol·-Pdebian/pkg·-ppackage |
| 103 | The·-P·tells·dpkg-gencontrol·that·the·package·is·being·built·in·a·non-default | 103 | The·-P·tells·dpkg-gencontrol·that·the·package·is·being·built·in·a·non-default |
| 104 | directory,·and·the·-p·tells·it·which·binary·package | 104 | directory,·and·the·-p·tells·it·which·binary·package’s·control·file·should·be |
| 105 | generated. | 105 | generated. |
| 106 | dpkg-gencontrol·also·adds·information·to·the·list·of·files·in·debian/files,·for | 106 | dpkg-gencontrol·also·adds·information·to·the·list·of·files·in·debian/files,·for |
| 107 | the·benefit·of·(for·example)·a·future·invocation·of·dpkg-genchanges. | 107 | the·benefit·of·(for·example)·a·future·invocation·of·dpkg-genchanges. |
| 108 | *\x8**\x8**\x8**\x8*·3\x83.\x8.1\x81.\x8.4\x84.\x8.·d\x8dp\x8pk\x8kg\x8g-\x8-s\x8sh\x8hl\x8li\x8ib\x8bd\x8de\x8ep\x8ps\x8s·-\x8-·c\x8ca\x8al\x8lc\x8cu\x8ul\x8la\x8at\x8te\x8es\x8s·s\x8sh\x8ha\x8ar\x8re\x8ed\x8d·l\x8li\x8ib\x8br\x8ra\x8ar\x8ry\x8y·d\x8de\x8ep\x8pe\x8en\x8nd\x8de\x8en\x8nc\x8ci\x8ie\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 108 | *\x8**\x8**\x8**\x8*·3\x83.\x8.1\x81.\x8.4\x84.\x8.·d\x8dp\x8pk\x8kg\x8g-\x8-s\x8sh\x8hl\x8li\x8ib\x8bd\x8de\x8ep\x8ps\x8s·-\x8-·c\x8ca\x8al\x8lc\x8cu\x8ul\x8la\x8at\x8te\x8es\x8s·s\x8sh\x8ha\x8ar\x8re\x8ed\x8d·l\x8li\x8ib\x8br\x8ra\x8ar\x8ry\x8y·d\x8de\x8ep\x8pe\x8en\x8nd\x8de\x8en\x8nc\x8ci\x8ie\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 109 | See·d\x8dp\x8pk\x8kg\x8g-\x8-s\x8sh\x8hl\x8li\x8ib\x8bd\x8de\x8ep\x8ps\x8s(\x8(1\x81)\x8). | 109 | See·d\x8dp\x8pk\x8kg\x8g-\x8-s\x8sh\x8hl\x8li\x8ib\x8bd\x8de\x8ep\x8ps\x8s(\x8(1\x81)\x8). |
| 110 | *\x8**\x8**\x8**\x8*·3\x83.\x8.1\x81.\x8.5\x85.\x8.·d\x8dp\x8pk\x8kg\x8g-\x8-d\x8di\x8is\x8st\x8ta\x8ad\x8dd\x8df\x8fi\x8il\x8le\x8e·-\x8-·a\x8ad\x8dd\x8ds\x8s·a\x8a·f\x8fi\x8il\x8le\x8e·t\x8to\x8o·d\x8de\x8eb\x8bi\x8ia\x8an\x8n/\x8/f\x8fi\x8il\x8le\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 110 | *\x8**\x8**\x8**\x8*·3\x83.\x8.1\x81.\x8.5\x85.\x8.·d\x8dp\x8pk\x8kg\x8g-\x8-d\x8di\x8is\x8st\x8ta\x8ad\x8dd\x8df\x8fi\x8il\x8le\x8e·-\x8-·a\x8ad\x8dd\x8ds\x8s·a\x8a·f\x8fi\x8il\x8le\x8e·t\x8to\x8o·d\x8de\x8eb\x8bi\x8ia\x8an\x8n/\x8/f\x8fi\x8il\x8le\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 111 | Some·packages | 111 | Some·packages’·uploads·need·to·include·files·other·than·the·source·and·binary |
| 112 | package·files. | 112 | package·files. |
| 113 | dpkg-distaddfile·adds·a·file·to·the·debian/files·file·so·that·it·will·be | 113 | dpkg-distaddfile·adds·a·file·to·the·debian/files·file·so·that·it·will·be |
| 114 | included·in·the·.changes·file·when·dpkg-genchanges·is·run. | 114 | included·in·the·.changes·file·when·dpkg-genchanges·is·run. |
| 115 | It·is·usually·invoked·from·the·binary·target·of·debian/rules: | 115 | It·is·usually·invoked·from·the·binary·target·of·debian/rules: |
| 116 | dpkg-distaddfile·filename·section·priority | 116 | dpkg-distaddfile·filename·section·priority |
| 117 | The·filename·is·relative·to·the·directory·where·dpkg-genchanges·will·expect·to | 117 | The·filename·is·relative·to·the·directory·where·dpkg-genchanges·will·expect·to |
| 118 | find·it·-·this·is·usually·the·directory·above·the·top·level·of·the·source·tree. | 118 | find·it·-·this·is·usually·the·directory·above·the·top·level·of·the·source·tree. |
| Offset 141, 15 lines modified | Offset 141, 15 lines modified | ||
| 141 | *\x8**\x8**\x8**\x8*·3\x83.\x8.2\x82.\x8.2\x82.\x8.·d\x8de\x8eb\x8bi\x8ia\x8an\x8n/\x8/s\x8su\x8ub\x8bs\x8st\x8tv\x8va\x8ar\x8rs\x8s·a\x8an\x8nd\x8d·v\x8va\x8ar\x8ri\x8ia\x8ab\x8bl\x8le\x8e·s\x8su\x8ub\x8bs\x8st\x8ti\x8it\x8tu\x8ut\x8ti\x8io\x8on\x8ns\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 141 | *\x8**\x8**\x8**\x8*·3\x83.\x8.2\x82.\x8.2\x82.\x8.·d\x8de\x8eb\x8bi\x8ia\x8an\x8n/\x8/s\x8su\x8ub\x8bs\x8st\x8tv\x8va\x8ar\x8rs\x8s·a\x8an\x8nd\x8d·v\x8va\x8ar\x8ri\x8ia\x8ab\x8bl\x8le\x8e·s\x8su\x8ub\x8bs\x8st\x8ti\x8it\x8tu\x8ut\x8ti\x8io\x8on\x8ns\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 142 | See·_\x8V_\x8a_\x8r_\x8i_\x8a_\x8b_\x8l_\x8e_\x8·_\x8s_\x8u_\x8b_\x8s_\x8t_\x8i_\x8t_\x8u_\x8t_\x8i_\x8o_\x8n_\x8s_\x8:_\x8·_\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8/_\x8s_\x8u_\x8b_\x8s_\x8t_\x8v_\x8a_\x8r_\x8s. | 142 | See·_\x8V_\x8a_\x8r_\x8i_\x8a_\x8b_\x8l_\x8e_\x8·_\x8s_\x8u_\x8b_\x8s_\x8t_\x8i_\x8t_\x8u_\x8t_\x8i_\x8o_\x8n_\x8s_\x8:_\x8·_\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8/_\x8s_\x8u_\x8b_\x8s_\x8t_\x8v_\x8a_\x8r_\x8s. |
| 143 | *\x8**\x8**\x8**\x8*·3\x83.\x8.2\x82.\x8.3\x83.\x8.·d\x8de\x8eb\x8bi\x8ia\x8an\x8n/\x8/f\x8fi\x8il\x8le\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 143 | *\x8**\x8**\x8**\x8*·3\x83.\x8.2\x82.\x8.3\x83.\x8.·d\x8de\x8eb\x8bi\x8ia\x8an\x8n/\x8/f\x8fi\x8il\x8le\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 144 | See·_\x8G_\x8e_\x8n_\x8e_\x8r_\x8a_\x8t_\x8e_\x8d_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s_\x8·_\x8l_\x8i_\x8s_\x8t_\x8:_\x8·_\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8/_\x8f_\x8i_\x8l_\x8e_\x8s. | 144 | See·_\x8G_\x8e_\x8n_\x8e_\x8r_\x8a_\x8t_\x8e_\x8d_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s_\x8·_\x8l_\x8i_\x8s_\x8t_\x8:_\x8·_\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8/_\x8f_\x8i_\x8l_\x8e_\x8s. |
| 145 | *\x8**\x8**\x8**\x8*·3\x83.\x8.2\x82.\x8.4\x84.\x8.·d\x8de\x8eb\x8bi\x8ia\x8an\x8n/\x8/t\x8tm\x8mp\x8p_\x8?\x8·*\x8**\x8**\x8**\x8* | 145 | *\x8**\x8**\x8**\x8*·3\x83.\x8.2\x82.\x8.4\x84.\x8.·d\x8de\x8eb\x8bi\x8ia\x8an\x8n/\x8/t\x8tm\x8mp\x8p_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 146 | This·is·the·default·temporary·location·for·the·construction·of·binary·packages | 146 | This·is·the·default·temporary·location·for·the·construction·of·binary·packages |
| 147 | by·the·binary·target.·The·directory·tmp·serves·as·the·root·of·the·file·system | 147 | by·the·binary·target.·The·directory·tmp·serves·as·the·root·of·the·file·system |
| 148 | tree·as·it·is·being·constructed·(for·example,·by·using·the·package | 148 | tree·as·it·is·being·constructed·(for·example,·by·using·the·package’s·upstream |
| 149 | makefiles·install·targets·and·redirecting·the·output·there),·and·it·also | 149 | makefiles·install·targets·and·redirecting·the·output·there),·and·it·also |
| 150 | contains·the·DEBIAN·subdirectory.·See·_\x8C_\x8r_\x8e_\x8a_\x8t_\x8i_\x8n_\x8g_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s_\x8·_\x8-_\x8·_\x8d_\x8p_\x8k_\x8g_\x8-_\x8d_\x8e_\x8b. | 150 | contains·the·DEBIAN·subdirectory.·See·_\x8C_\x8r_\x8e_\x8a_\x8t_\x8i_\x8n_\x8g_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s_\x8·_\x8-_\x8·_\x8d_\x8p_\x8k_\x8g_\x8-_\x8d_\x8e_\x8b. |
| 151 | This·is·only·a·default·and·can·be·easily·overridden.·Most·packaging·tools·no | 151 | This·is·only·a·default·and·can·be·easily·overridden.·Most·packaging·tools·no |
| 152 | longer·use·debian/tmp,·instead·preferring·debian/pkg·for·the·common·case·of·a | 152 | longer·use·debian/tmp,·instead·preferring·debian/pkg·for·the·common·case·of·a |
| 153 | source·package·building·only·one·binary·package.·Such·tools·usually·only·use | 153 | source·package·building·only·one·binary·package.·Such·tools·usually·only·use |
| 154 | debian/tmp·as·a·temporary·staging·area·for·built·files·and·do·not·construct | 154 | debian/tmp·as·a·temporary·staging·area·for·built·files·and·do·not·construct |
| 155 | packages·from·it. | 155 | packages·from·it. |
| Offset 197, 28 lines modified | Offset 197, 28 lines modified | ||
| 197 | proposal,·in·which·case·one·may·skip·this·step·and·move·directly·to | 197 | proposal,·in·which·case·one·may·skip·this·step·and·move·directly·to |
| 198 | patch·tag.</p> | 198 | patch·tag.</p> |
| 199 | </section> | 199 | </section> |
| 200 | <section·id="state-d-wording-proposed"> | 200 | <section·id="state-d-wording-proposed"> |
| 201 | <span·id="id4"></span><h3><span·class="section-number">8.3.4.·</span>State·D:·Wording·proposed<a·class="headerlink"·href="#state-d-wording-proposed"·title="Link·to·this·heading"></a></h3> | 201 | <span·id="id4"></span><h3><span·class="section-number">8.3.4.·</span>State·D:·Wording·proposed<a·class="headerlink"·href="#state-d-wording-proposed"·title="Link·to·this·heading"></a></h3> |
| 202 | <p>A·patch·against·the·Policy·document·reflecting·the·consensus·has·been | 202 | <p>A·patch·against·the·Policy·document·reflecting·the·consensus·has·been |
| 203 | created·and·is·waiting·for·formal·seconds.·The·standard·patch·tag·is | 203 | created·and·is·waiting·for·formal·seconds.·The·standard·patch·tag·is |
| 204 | used·for·this·state,·since·it | 204 | used·for·this·state,·since·it’s·essentially·equivalent·to·the·standard |
| 205 | meaning·of·that·tag.</p> | 205 | meaning·of·that·tag.</p> |
| 206 | <p><a·class="reference·external"·href="https://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=patch">TAG:·patch</a></p> | 206 | <p><a·class="reference·external"·href="https://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=patch">TAG:·patch</a></p> |
| 207 | <p>What·needs·to·happen·next:·The·proposal·needs·to·be·reviewed·and | 207 | <p>What·needs·to·happen·next:·The·proposal·needs·to·be·reviewed·and |
| 208 | seconded.·Any·Debian·developer·who·agrees·with·the·change·and·the | 208 | seconded.·Any·Debian·developer·who·agrees·with·the·change·and·the |
| 209 | conclusion·of·rough·consensus·from·the·discussion·should·say·so·in·the | 209 | conclusion·of·rough·consensus·from·the·discussion·should·say·so·in·the |
| 210 | bug·log·by·seconding·the·proposal.</p> | 210 | bug·log·by·seconding·the·proposal.</p> |
| 211 | </section> | 211 | </section> |
| 212 | <section·id="state-e-seconded"> | 212 | <section·id="state-e-seconded"> |
| 213 | <span·id="id5"></span><h3><span·class="section-number">8.3.5.·</span>State·E:·Seconded<a·class="headerlink"·href="#state-e-seconded"·title="Link·to·this·heading"></a></h3> | 213 | <span·id="id5"></span><h3><span·class="section-number">8.3.5.·</span>State·E:·Seconded<a·class="headerlink"·href="#state-e-seconded"·title="Link·to·this·heading"></a></h3> |
| 214 | <p>The·proposal·is·signed·off·on·by·N·Debian·Developers.·To·start·with, | 214 | <p>The·proposal·is·signed·off·on·by·N·Debian·Developers.·To·start·with, |
| 215 | we | 215 | we’re·going·with·N=3,·meaning·that·if·three·Debian·Developers·agree,·not |
| 216 | just·with·the·proposal·but·with·the·conclusion·that·it·reflects | 216 | just·with·the·proposal·but·with·the·conclusion·that·it·reflects |
| 217 | consensus·and·addresses·the·original·issue· | 217 | consensus·and·addresses·the·original·issue·–·it·is·considered·eligible |
| 218 | for·inclusion·in·the·next·version·of·Policy.·Since·Policy·is·partly·a | 218 | for·inclusion·in·the·next·version·of·Policy.·Since·Policy·is·partly·a |
| 219 | technical·project·governance·method,·one·must·be·a·Debian·Developer·to | 219 | technical·project·governance·method,·one·must·be·a·Debian·Developer·to |
| 220 | formally·second,·although·review·and·discussion·is·welcome·from·anyone. | 220 | formally·second,·although·review·and·discussion·is·welcome·from·anyone. |
| 221 | Once·this·tag·has·been·applied,·the·bug·is·waiting·for·a·Policy·team | 221 | Once·this·tag·has·been·applied,·the·bug·is·waiting·for·a·Policy·team |
| 222 | member·to·apply·the·patch·to·the·package·repository.</p> | 222 | member·to·apply·the·patch·to·the·package·repository.</p> |
| 223 | <p><a·class="reference·external"·href="https://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=seconded">TAG:·seconded</a></p> | 223 | <p><a·class="reference·external"·href="https://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=seconded">TAG:·seconded</a></p> |
| 224 | <p>What·needs·to·happen·next:·A·Policy·maintainer·does·the·final·review·and | 224 | <p>What·needs·to·happen·next:·A·Policy·maintainer·does·the·final·review·and |
| Offset 229, 27 lines modified | Offset 229, 27 lines modified | ||
| 229 | </section> | 229 | </section> |
| 230 | <section·id="state-f-accepted"> | 230 | <section·id="state-f-accepted"> |
| 231 | <span·id="id6"></span><h3><span·class="section-number">8.3.6.·</span>State·F:·Accepted<a·class="headerlink"·href="#state-f-accepted"·title="Link·to·this·heading"></a></h3> | 231 | <span·id="id6"></span><h3><span·class="section-number">8.3.6.·</span>State·F:·Accepted<a·class="headerlink"·href="#state-f-accepted"·title="Link·to·this·heading"></a></h3> |
| 232 | <p>Change·accepted,·will·be·in·next·upload.·The·standard·pending·tag·is | 232 | <p>Change·accepted,·will·be·in·next·upload.·The·standard·pending·tag·is |
| 233 | used·for·this·state·since·it·matches·the·regular·meaning·of·pending.</p> | 233 | used·for·this·state·since·it·matches·the·regular·meaning·of·pending.</p> |
| 234 | <p><a·class="reference·external"·href="https://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=pending">TAG:·pending</a></p> | 234 | <p><a·class="reference·external"·href="https://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=pending">TAG:·pending</a></p> |
| 235 | <p>What·needs·to·happen·next:·The·bug·is·now·in·the·waiting·queue·for·the | 235 | <p>What·needs·to·happen·next:·The·bug·is·now·in·the·waiting·queue·for·the |
| 236 | next·Policy·release,·and·there | 236 | next·Policy·release,·and·there’s·nothing·left·to·do·except·for·upload·a |
| 237 | new·version·of·Policy.</p> | 237 | new·version·of·Policy.</p> |
| 238 | </section> | 238 | </section> |
| 239 | <section·id="state-g-reject"> | 239 | <section·id="state-g-reject"> |
| 240 | <span·id="id7"></span><h3><span·class="section-number">8.3.7.·</span>State·G:·Reject<a·class="headerlink"·href="#state-g-reject"·title="Link·to·this·heading"></a></h3> | 240 | <span·id="id7"></span><h3><span·class="section-number">8.3.7.·</span>State·G:·Reject<a·class="headerlink"·href="#state-g-reject"·title="Link·to·this·heading"></a></h3> |
| 241 | <p>Rejected·proposals.·The·standard·wontfix·is·used·for·this·state. | 241 | <p>Rejected·proposals.·The·standard·wontfix·is·used·for·this·state. |
| 242 | Normally,·bugs·in·this·state·will·not·remain·open·(excepting | 242 | Normally,·bugs·in·this·state·will·not·remain·open·(excepting |
| 243 | <strong>stalled</strong>);·instead,·a·Policy·team·member·will·close·them·with·an | 243 | <strong>stalled</strong>);·instead,·a·Policy·team·member·will·close·them·with·an |
| 244 | explanation.·The·submitter·may·then·appeal·to·the·tech-ctte·if·they·so | 244 | explanation.·The·submitter·may·then·appeal·to·the·tech-ctte·if·they·so |
| 245 | desire.·Alternately,·issues·appealed·to·the·tech-ctte·may·remain·open | 245 | desire.·Alternately,·issues·appealed·to·the·tech-ctte·may·remain·open |
| 246 | with·this·tag·while·that·appeal·proceeds.</p> | 246 | with·this·tag·while·that·appeal·proceeds.</p> |
| 247 | <p><a·class="reference·external"·href="https://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=rejected">TAG:·wontfix</a></p> | 247 | <p><a·class="reference·external"·href="https://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=rejected">TAG:·wontfix</a></p> |
| 248 | <p>We·may·use·one·of·the·following·tags·here.·It | 248 | <p>We·may·use·one·of·the·following·tags·here.·It’s·not·clear·whether·we |
| 249 | need·more·tags·for·this·stage.</p> | 249 | need·more·tags·for·this·stage.</p> |
| 250 | <dl·class="simple"> | 250 | <dl·class="simple"> |
| 251 | <dt><strong>dubious</strong></dt><dd><p>Not·a·policy·matter</p> | 251 | <dt><strong>dubious</strong></dt><dd><p>Not·a·policy·matter</p> |
| 252 | </dd> | 252 | </dd> |
| 253 | <dt><strong>ctte</strong></dt><dd><p>Referred·to·the·Technical·Committee·(tech-ctte)</p> | 253 | <dt><strong>ctte</strong></dt><dd><p>Referred·to·the·Technical·Committee·(tech-ctte)</p> |
| 254 | </dd> | 254 | </dd> |
| 255 | <dt><strong>devel</strong></dt><dd><p>Referred·to·the·developer·body</p> | 255 | <dt><strong>devel</strong></dt><dd><p>Referred·to·the·developer·body</p> |
| Offset 292, 15 lines modified | Offset 292, 15 lines modified | ||
| 292 | (used·with·their·normal·meanings).</p> | 292 | (used·with·their·normal·meanings).</p> |
| 293 | <p><a·class="reference·external"·href="https://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=packaging">TAG:·packaging</a></p> | 293 | <p><a·class="reference·external"·href="https://bugs.debian.org/cgi-bin/pkgreport.cgi?src=debian-policy&pend-exc=done&tag=packaging">TAG:·packaging</a></p> |
| 294 | <aside·class="footnote-list·brackets"> | 294 | <aside·class="footnote-list·brackets"> |
| 295 | <aside·class="footnote·brackets"·id="id8"·role="doc-footnote"> | 295 | <aside·class="footnote·brackets"·id="id8"·role="doc-footnote"> |
| 296 | <span·class="label"><span·class="fn-bracket">[</span><a·role="doc-backlink"·href="#id1">1</a><span·class="fn-bracket">]</span></span> | 296 | <span·class="label"><span·class="fn-bracket">[</span><a·role="doc-backlink"·href="#id1">1</a><span·class="fn-bracket">]</span></span> |
| 297 | <p>This·process·was·originally·developed·by·Margarita·Manterola,·Clint | 297 | <p>This·process·was·originally·developed·by·Margarita·Manterola,·Clint |
| 298 | Adams,·Russ·Allbery·and·Manoj·Srivastava.··In·2017,·Sean·Whitton | 298 | Adams,·Russ·Allbery·and·Manoj·Srivastava.··In·2017,·Sean·Whitton |
| 299 | deprecated·the· | 299 | deprecated·the·‘issue’·usertag·and·added·use·of·the·‘moreinfo’·tag, |
| 300 | after·discussions·at·DebConf17.</p> | 300 | after·discussions·at·DebConf17.</p> |
| 301 | </aside> | 301 | </aside> |
| 302 | </aside> | 302 | </aside> |
| 303 | </section> | 303 | </section> |
| 304 | </section> | 304 | </section> |
| Offset 102, 49 lines modified | Offset 102, 49 lines modified | ||
| 102 | What·needs·to·happen·next:·Provided·that·the·rough·consensus·persists,·develop | 102 | What·needs·to·happen·next:·Provided·that·the·rough·consensus·persists,·develop |
| 103 | a·patch·against·the·current·Policy·document·with·specific·wording·of·the | 103 | a·patch·against·the·current·Policy·document·with·specific·wording·of·the |
| 104 | change.·Often·this·is·done·in·conjunction·with·the·proposal,·in·which·case·one | 104 | change.·Often·this·is·done·in·conjunction·with·the·proposal,·in·which·case·one |
| 105 | may·skip·this·step·and·move·directly·to·patch·tag. | 105 | may·skip·this·step·and·move·directly·to·patch·tag. |
| 106 | *\x8**\x8**\x8**\x8*·8\x88.\x8.3\x83.\x8.4\x84.\x8.·S\x8St\x8ta\x8at\x8te\x8e·D\x8D:\x8:·W\x8Wo\x8or\x8rd\x8di\x8in\x8ng\x8g·p\x8pr\x8ro\x8op\x8po\x8os\x8se\x8ed\x8d_\x8?\x8·*\x8**\x8**\x8**\x8* | 106 | *\x8**\x8**\x8**\x8*·8\x88.\x8.3\x83.\x8.4\x84.\x8.·S\x8St\x8ta\x8at\x8te\x8e·D\x8D:\x8:·W\x8Wo\x8or\x8rd\x8di\x8in\x8ng\x8g·p\x8pr\x8ro\x8op\x8po\x8os\x8se\x8ed\x8d_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 107 | A·patch·against·the·Policy·document·reflecting·the·consensus·has·been·created | 107 | A·patch·against·the·Policy·document·reflecting·the·consensus·has·been·created |
| 108 | and·is·waiting·for·formal·seconds.·The·standard·patch·tag·is·used·for·this | 108 | and·is·waiting·for·formal·seconds.·The·standard·patch·tag·is·used·for·this |
| 109 | state,·since·it | 109 | state,·since·it’s·essentially·equivalent·to·the·standard·meaning·of·that·tag. |
| 110 | _\x8T_\x8A_\x8G_\x8:_\x8·_\x8p_\x8a_\x8t_\x8c_\x8h | 110 | _\x8T_\x8A_\x8G_\x8:_\x8·_\x8p_\x8a_\x8t_\x8c_\x8h |
| 111 | What·needs·to·happen·next:·The·proposal·needs·to·be·reviewed·and·seconded.·Any | 111 | What·needs·to·happen·next:·The·proposal·needs·to·be·reviewed·and·seconded.·Any |
| 112 | Debian·developer·who·agrees·with·the·change·and·the·conclusion·of·rough | 112 | Debian·developer·who·agrees·with·the·change·and·the·conclusion·of·rough |
| 113 | consensus·from·the·discussion·should·say·so·in·the·bug·log·by·seconding·the | 113 | consensus·from·the·discussion·should·say·so·in·the·bug·log·by·seconding·the |
| 114 | proposal. | 114 | proposal. |
| 115 | *\x8**\x8**\x8**\x8*·8\x88.\x8.3\x83.\x8.5\x85.\x8.·S\x8St\x8ta\x8at\x8te\x8e·E\x8E:\x8:·S\x8Se\x8ec\x8co\x8on\x8nd\x8de\x8ed\x8d_\x8?\x8·*\x8**\x8**\x8**\x8* | 115 | *\x8**\x8**\x8**\x8*·8\x88.\x8.3\x83.\x8.5\x85.\x8.·S\x8St\x8ta\x8at\x8te\x8e·E\x8E:\x8:·S\x8Se\x8ec\x8co\x8on\x8nd\x8de\x8ed\x8d_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 116 | The·proposal·is·signed·off·on·by·N·Debian·Developers.·To·start·with,·we | 116 | The·proposal·is·signed·off·on·by·N·Debian·Developers.·To·start·with,·we’re |
| 117 | going·with·N=3,·meaning·that·if·three·Debian·Developers·agree,·not·just·with | 117 | going·with·N=3,·meaning·that·if·three·Debian·Developers·agree,·not·just·with |
| 118 | the·proposal·but·with·the·conclusion·that·it·reflects·consensus·and·addresses | 118 | the·proposal·but·with·the·conclusion·that·it·reflects·consensus·and·addresses |
| 119 | the·original·issue· | 119 | the·original·issue·–·it·is·considered·eligible·for·inclusion·in·the·next |
| 120 | version·of·Policy.·Since·Policy·is·partly·a·technical·project·governance | 120 | version·of·Policy.·Since·Policy·is·partly·a·technical·project·governance |
| 121 | method,·one·must·be·a·Debian·Developer·to·formally·second,·although·review·and | 121 | method,·one·must·be·a·Debian·Developer·to·formally·second,·although·review·and |
| 122 | discussion·is·welcome·from·anyone.·Once·this·tag·has·been·applied,·the·bug·is | 122 | discussion·is·welcome·from·anyone.·Once·this·tag·has·been·applied,·the·bug·is |
| 123 | waiting·for·a·Policy·team·member·to·apply·the·patch·to·the·package·repository. | 123 | waiting·for·a·Policy·team·member·to·apply·the·patch·to·the·package·repository. |
| 124 | _\x8T_\x8A_\x8G_\x8:_\x8·_\x8s_\x8e_\x8c_\x8o_\x8n_\x8d_\x8e_\x8d | 124 | _\x8T_\x8A_\x8G_\x8:_\x8·_\x8s_\x8e_\x8c_\x8o_\x8n_\x8d_\x8e_\x8d |
| 125 | What·needs·to·happen·next:·A·Policy·maintainer·does·the·final·review·and | 125 | What·needs·to·happen·next:·A·Policy·maintainer·does·the·final·review·and |
| 126 | confirmation,·and·then·applies·the·patch·for·the·next·Policy·release. | 126 | confirmation,·and·then·applies·the·patch·for·the·next·Policy·release. |
| 127 | This·tag·is·not·used·very·much·because·normally·a·Policy·maintainer·applies·the | 127 | This·tag·is·not·used·very·much·because·normally·a·Policy·maintainer·applies·the |
| 128 | patch·and·moves·the·proposal·to·the·next·state·once·enough·seconds·are·reached. | 128 | patch·and·moves·the·proposal·to·the·next·state·once·enough·seconds·are·reached. |
| 129 | *\x8**\x8**\x8**\x8*·8\x88.\x8.3\x83.\x8.6\x86.\x8.·S\x8St\x8ta\x8at\x8te\x8e·F\x8F:\x8:·A\x8Ac\x8cc\x8ce\x8ep\x8pt\x8te\x8ed\x8d_\x8?\x8·*\x8**\x8**\x8**\x8* | 129 | *\x8**\x8**\x8**\x8*·8\x88.\x8.3\x83.\x8.6\x86.\x8.·S\x8St\x8ta\x8at\x8te\x8e·F\x8F:\x8:·A\x8Ac\x8cc\x8ce\x8ep\x8pt\x8te\x8ed\x8d_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 130 | Change·accepted,·will·be·in·next·upload.·The·standard·pending·tag·is·used·for | 130 | Change·accepted,·will·be·in·next·upload.·The·standard·pending·tag·is·used·for |
| 131 | this·state·since·it·matches·the·regular·meaning·of·pending. | 131 | this·state·since·it·matches·the·regular·meaning·of·pending. |
| 132 | _\x8T_\x8A_\x8G_\x8:_\x8·_\x8p_\x8e_\x8n_\x8d_\x8i_\x8n_\x8g | 132 | _\x8T_\x8A_\x8G_\x8:_\x8·_\x8p_\x8e_\x8n_\x8d_\x8i_\x8n_\x8g |
| 133 | What·needs·to·happen·next:·The·bug·is·now·in·the·waiting·queue·for·the·next | 133 | What·needs·to·happen·next:·The·bug·is·now·in·the·waiting·queue·for·the·next |
| 134 | Policy·release,·and·there | 134 | Policy·release,·and·there’s·nothing·left·to·do·except·for·upload·a·new·version |
| 135 | of·Policy. | 135 | of·Policy. |
| 136 | *\x8**\x8**\x8**\x8*·8\x88.\x8.3\x83.\x8.7\x87.\x8.·S\x8St\x8ta\x8at\x8te\x8e·G\x8G:\x8:·R\x8Re\x8ej\x8je\x8ec\x8ct\x8t_\x8?\x8·*\x8**\x8**\x8**\x8* | 136 | *\x8**\x8**\x8**\x8*·8\x88.\x8.3\x83.\x8.7\x87.\x8.·S\x8St\x8ta\x8at\x8te\x8e·G\x8G:\x8:·R\x8Re\x8ej\x8je\x8ec\x8ct\x8t_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 137 | Rejected·proposals.·The·standard·wontfix·is·used·for·this·state.·Normally,·bugs | 137 | Rejected·proposals.·The·standard·wontfix·is·used·for·this·state.·Normally,·bugs |
| 138 | in·this·state·will·not·remain·open·(excepting·s\x8st\x8ta\x8al\x8ll\x8le\x8ed\x8d);·instead,·a·Policy·team | 138 | in·this·state·will·not·remain·open·(excepting·s\x8st\x8ta\x8al\x8ll\x8le\x8ed\x8d);·instead,·a·Policy·team |
| 139 | member·will·close·them·with·an·explanation.·The·submitter·may·then·appeal·to | 139 | member·will·close·them·with·an·explanation.·The·submitter·may·then·appeal·to |
| 140 | the·tech-ctte·if·they·so·desire.·Alternately,·issues·appealed·to·the·tech-ctte | 140 | the·tech-ctte·if·they·so·desire.·Alternately,·issues·appealed·to·the·tech-ctte |
| 141 | may·remain·open·with·this·tag·while·that·appeal·proceeds. | 141 | may·remain·open·with·this·tag·while·that·appeal·proceeds. |
| 142 | _\x8T_\x8A_\x8G_\x8:_\x8·_\x8w_\x8o_\x8n_\x8t_\x8f_\x8i_\x8x | 142 | _\x8T_\x8A_\x8G_\x8:_\x8·_\x8w_\x8o_\x8n_\x8t_\x8f_\x8i_\x8x |
| 143 | We·may·use·one·of·the·following·tags·here.·It | 143 | We·may·use·one·of·the·following·tags·here.·It’s·not·clear·whether·we·need·more |
| 144 | tags·for·this·stage. | 144 | tags·for·this·stage. |
| 145 | ··d\x8du\x8ub\x8bi\x8io\x8ou\x8us\x8s | 145 | ··d\x8du\x8ub\x8bi\x8io\x8ou\x8us\x8s |
| 146 | ······Not·a·policy·matter | 146 | ······Not·a·policy·matter |
| 147 | ··c\x8ct\x8tt\x8te\x8e | 147 | ··c\x8ct\x8tt\x8te\x8e |
| 148 | ······Referred·to·the·Technical·Committee·(tech-ctte) | 148 | ······Referred·to·the·Technical·Committee·(tech-ctte) |
| 149 | ··d\x8de\x8ev\x8ve\x8el\x8l | 149 | ··d\x8de\x8ev\x8ve\x8el\x8l |
| 150 | ······Referred·to·the·developer·body | 150 | ······Referred·to·the·developer·body |
| Offset 177, 11 lines modified | Offset 177, 11 lines modified | ||
| 177 | The·packaging·tag·is·used·for·bugs·about·the·packaging·and·build·process·of·the | 177 | The·packaging·tag·is·used·for·bugs·about·the·packaging·and·build·process·of·the |
| 178 | debian-policy·Debian·package.·These·bugs·do·not·follow·the·normal·process·and | 178 | debian-policy·Debian·package.·These·bugs·do·not·follow·the·normal·process·and |
| 179 | will·not·have·the·other·tags·except·for·pending·and·wontfix·(used·with·their | 179 | will·not·have·the·other·tags·except·for·pending·and·wontfix·(used·with·their |
| 180 | normal·meanings). | 180 | normal·meanings). |
| 181 | _\x8T_\x8A_\x8G_\x8:_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8i_\x8n_\x8g | 181 | _\x8T_\x8A_\x8G_\x8:_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8i_\x8n_\x8g |
| 182 | [_\x81] | 182 | [_\x81] |
| 183 | This·process·was·originally·developed·by·Margarita·Manterola,·Clint·Adams,·Russ | 183 | This·process·was·originally·developed·by·Margarita·Manterola,·Clint·Adams,·Russ |
| 184 | Allbery·and·Manoj·Srivastava.·In·2017,·Sean·Whitton·deprecated·the· | 184 | Allbery·and·Manoj·Srivastava.·In·2017,·Sean·Whitton·deprecated·the·‘issue’ |
| 185 | usertag·and·added·use·of·the· | 185 | usertag·and·added·use·of·the·‘moreinfo’·tag,·after·discussions·at·DebConf17. |
| 186 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t | 186 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t |
| 187 | =============================================================================== | 187 | =============================================================================== |
| Offset 136, 24 lines modified | Offset 136, 24 lines modified | ||
| 136 | <code·class="docutils·literal·notranslate"><span·class="pre">contrib</span></code>,·<code·class="docutils·literal·notranslate"><span·class="pre">non-free</span></code>)·are·not·considered·to·be·part·of·the·Debian | 136 | <code·class="docutils·literal·notranslate"><span·class="pre">contrib</span></code>,·<code·class="docutils·literal·notranslate"><span·class="pre">non-free</span></code>)·are·not·considered·to·be·part·of·the·Debian |
| 137 | distribution,·although·we·support·their·use·and·provide·infrastructure | 137 | distribution,·although·we·support·their·use·and·provide·infrastructure |
| 138 | for·them·(such·as·our·bug-tracking·system·and·mailing·lists).·This | 138 | for·them·(such·as·our·bug-tracking·system·and·mailing·lists).·This |
| 139 | Debian·Policy·Manual·applies·to·these·packages·as·well.</p> | 139 | Debian·Policy·Manual·applies·to·these·packages·as·well.</p> |
| 140 | <aside·class="footnote-list·brackets"> | 140 | <aside·class="footnote-list·brackets"> |
| 141 | <aside·class="footnote·brackets"·id="id2"·role="doc-footnote"> | 141 | <aside·class="footnote·brackets"·id="id2"·role="doc-footnote"> |
| 142 | <span·class="label"><span·class="fn-bracket">[</span><a·role="doc-backlink"·href="#id1">1</a><span·class="fn-bracket">]</span></span> | 142 | <span·class="label"><span·class="fn-bracket">[</span><a·role="doc-backlink"·href="#id1">1</a><span·class="fn-bracket">]</span></span> |
| 143 | <p>The·Debian·archive·software·uses·the·term· | 143 | <p>The·Debian·archive·software·uses·the·term·“component”·internally·and |
| 144 | in·the·Release·file·format·to·refer·to·the·division·of·an·archive. | 144 | in·the·Release·file·format·to·refer·to·the·division·of·an·archive. |
| 145 | The·Debian·Social·Contract·simply·refers·to· | 145 | The·Debian·Social·Contract·simply·refers·to·“areas.”·This·document |
| 146 | uses·terminology·similar·to·the·Social·Contract.</p> | 146 | uses·terminology·similar·to·the·Social·Contract.</p> |
| 147 | </aside> | 147 | </aside> |
| 148 | </aside> | 148 | </aside> |
| 149 | <section·id="the-debian-free-software-guidelines"> | 149 | <section·id="the-debian-free-software-guidelines"> |
| 150 | <span·id="s-dfsg"></span><h2><span·class="section-number">2.1.·</span>The·Debian·Free·Software·Guidelines<a·class="headerlink"·href="#the-debian-free-software-guidelines"·title="Link·to·this·heading"></a></h2> | 150 | <span·id="s-dfsg"></span><h2><span·class="section-number">2.1.·</span>The·Debian·Free·Software·Guidelines<a·class="headerlink"·href="#the-debian-free-software-guidelines"·title="Link·to·this·heading"></a></h2> |
| 151 | <p>The·Debian·Free·Software·Guidelines·(DFSG)·form·our·definition·of· | 151 | <p>The·Debian·Free·Software·Guidelines·(DFSG)·form·our·definition·of·“free |
| 152 | software | 152 | software”.·These·are:</p> |
| 153 | <ol·class="arabic·simple"> | 153 | <ol·class="arabic·simple"> |
| 154 | <li><dl·class="simple"> | 154 | <li><dl·class="simple"> |
| 155 | <dt>Free·Redistribution</dt><dd><p>The·license·of·a·Debian·component·may·not·restrict·any·party·from | 155 | <dt>Free·Redistribution</dt><dd><p>The·license·of·a·Debian·component·may·not·restrict·any·party·from |
| 156 | selling·or·giving·away·the·software·as·a·component·of·an·aggregate | 156 | selling·or·giving·away·the·software·as·a·component·of·an·aggregate |
| 157 | software·distribution·containing·programs·from·several·different | 157 | software·distribution·containing·programs·from·several·different |
| 158 | sources.·The·license·may·not·require·a·royalty·or·other·fee·for·such | 158 | sources.·The·license·may·not·require·a·royalty·or·other·fee·for·such |
| 159 | sale.</p> | 159 | sale.</p> |
| Offset 170, 17 lines modified | Offset 170, 17 lines modified | ||
| 170 | <dt>Derived·Works</dt><dd><p>The·license·must·allow·modifications·and·derived·works,·and·must | 170 | <dt>Derived·Works</dt><dd><p>The·license·must·allow·modifications·and·derived·works,·and·must |
| 171 | allow·them·to·be·distributed·under·the·same·terms·as·the·license·of | 171 | allow·them·to·be·distributed·under·the·same·terms·as·the·license·of |
| 172 | the·original·software.</p> | 172 | the·original·software.</p> |
| 173 | </dd> | 173 | </dd> |
| 174 | </dl> | 174 | </dl> |
| 175 | </li> | 175 | </li> |
| 176 | <li><dl·class="simple"> | 176 | <li><dl·class="simple"> |
| 177 | <dt>Integrity·of·The·Author | 177 | <dt>Integrity·of·The·Author’s·Source·Code</dt><dd><p>The·license·may·restrict·source-code·from·being·distributed·in |
| 178 | modified·form·<em>only</em>·if·the·license·allows·the·distribution·of | 178 | modified·form·<em>only</em>·if·the·license·allows·the·distribution·of |
| 179 | 179 | “patch·files”·with·the·source·code·for·the·purpose·of·modifying·the | |
| 180 | program·at·build·time.·The·license·must·explicitly·permit | 180 | program·at·build·time.·The·license·must·explicitly·permit |
| 181 | distribution·of·software·built·from·modified·source·code.·The | 181 | distribution·of·software·built·from·modified·source·code.·The |
| 182 | license·may·require·derived·works·to·carry·a·different·name·or | 182 | license·may·require·derived·works·to·carry·a·different·name·or |
| 183 | version·number·from·the·original·software.·(This·is·a·compromise. | 183 | version·number·from·the·original·software.·(This·is·a·compromise. |
| 184 | The·Debian·Project·encourages·all·authors·to·not·restrict·any·files, | 184 | The·Debian·Project·encourages·all·authors·to·not·restrict·any·files, |
| 185 | source·or·binary,·from·being·modified.)</p> | 185 | source·or·binary,·from·being·modified.)</p> |
| 186 | </dd> | 186 | </dd> |
| Offset 204, 33 lines modified | Offset 204, 33 lines modified | ||
| 204 | <dt>Distribution·of·License</dt><dd><p>The·rights·attached·to·the·program·must·apply·to·all·to·whom·the | 204 | <dt>Distribution·of·License</dt><dd><p>The·rights·attached·to·the·program·must·apply·to·all·to·whom·the |
| 205 | program·is·redistributed·without·the·need·for·execution·of·an | 205 | program·is·redistributed·without·the·need·for·execution·of·an |
| 206 | additional·license·by·those·parties.</p> | 206 | additional·license·by·those·parties.</p> |
| 207 | </dd> | 207 | </dd> |
| 208 | </dl> | 208 | </dl> |
| 209 | </li> | 209 | </li> |
| 210 | <li><dl·class="simple"> | 210 | <li><dl·class="simple"> |
| 211 | <dt>License·Must·Not·Be·Specific·to·Debian</dt><dd><p>The·rights·attached·to·the·program·must·not·depend·on·the·program | 211 | <dt>License·Must·Not·Be·Specific·to·Debian</dt><dd><p>The·rights·attached·to·the·program·must·not·depend·on·the·program’s |
| 212 | being·part·of·a·Debian·system.·If·the·program·is·extracted·from | 212 | being·part·of·a·Debian·system.·If·the·program·is·extracted·from |
| 213 | Debian·and·used·or·distributed·without·Debian·but·otherwise·within | 213 | Debian·and·used·or·distributed·without·Debian·but·otherwise·within |
| 214 | the·terms·of·the·program | 214 | the·terms·of·the·program’s·license,·all·parties·to·whom·the·program |
| 215 | is·redistributed·must·have·the·same·rights·as·those·that·are·granted | 215 | is·redistributed·must·have·the·same·rights·as·those·that·are·granted |
| 216 | in·conjunction·with·the·Debian·system.</p> | 216 | in·conjunction·with·the·Debian·system.</p> |
| 217 | </dd> | 217 | </dd> |
| 218 | </dl> | 218 | </dl> |
| 219 | </li> | 219 | </li> |
| 220 | <li><dl·class="simple"> | 220 | <li><dl·class="simple"> |
| 221 | <dt>License·Must·Not·Contaminate·Other·Software</dt><dd><p>The·license·must·not·place·restrictions·on·other·software·that·is | 221 | <dt>License·Must·Not·Contaminate·Other·Software</dt><dd><p>The·license·must·not·place·restrictions·on·other·software·that·is |
| 222 | distributed·along·with·the·licensed·software.·For·example,·the | 222 | distributed·along·with·the·licensed·software.·For·example,·the |
| 223 | license·must·not·insist·that·all·other·programs·distributed·on·the | 223 | license·must·not·insist·that·all·other·programs·distributed·on·the |
| 224 | same·medium·must·be·free·software.</p> | 224 | same·medium·must·be·free·software.</p> |
| 225 | </dd> | 225 | </dd> |
| 226 | </dl> | 226 | </dl> |
| 227 | </li> | 227 | </li> |
| 228 | <li><dl·class="simple"> | 228 | <li><dl·class="simple"> |
| 229 | <dt>Example·Licenses</dt><dd><p>The· | 229 | <dt>Example·Licenses</dt><dd><p>The·“GPL,”·“BSD,”·and·“Artistic”·licenses·are·examples·of·licenses |
| 230 | that·we·consider·<em>free</em>.</p> | 230 | that·we·consider·<em>free</em>.</p> |
| 231 | </dd> | 231 | </dd> |
| 232 | </dl> | 232 | </dl> |
| 233 | </li> | 233 | </li> |
| 234 | </ol> | 234 | </ol> |
| 235 | </section> | 235 | </section> |
| 236 | <section·id="archive-areas"> | 236 | <section·id="archive-areas"> |
| Offset 254, 15 lines modified | Offset 254, 15 lines modified | ||
| 254 | alternative·for·a·package·in·<em>main</em>),</p></li> | 254 | alternative·for·a·package·in·<em>main</em>),</p></li> |
| 255 | <li><p>must·not·be·so·buggy·that·we·refuse·to·support·them,·and</p></li> | 255 | <li><p>must·not·be·so·buggy·that·we·refuse·to·support·them,·and</p></li> |
| 256 | <li><p>must·meet·all·policy·requirements·presented·in·this·manual.</p></li> | 256 | <li><p>must·meet·all·policy·requirements·presented·in·this·manual.</p></li> |
| 257 | </ul> | 257 | </ul> |
| 258 | <p>If·a·source·package·is·in·the·<em>main</em>·archive·area,·then·at·least·one·of | 258 | <p>If·a·source·package·is·in·the·<em>main</em>·archive·area,·then·at·least·one·of |
| 259 | its·binary·packages·must·be·in·the·<em>main</em>·archive·area,·and·each·of·the | 259 | its·binary·packages·must·be·in·the·<em>main</em>·archive·area,·and·each·of·the |
| 260 | remaining·packages·must·be·in·either·the·<em>main</em>·or·<em>contrib</em>·archive | 260 | remaining·packages·must·be·in·either·the·<em>main</em>·or·<em>contrib</em>·archive |
| 261 | area.·Each·binary·package | 261 | area.·Each·binary·package’s·archive·area·is·indicated·by·its·<code·class="docutils·literal·notranslate"><span·class="pre">Section</span></code> |
| 262 | field:·see·<a·class="reference·internal"·href="#s-subsections"><span·class="std·std-ref">Sections</span></a>.</p> | 262 | field:·see·<a·class="reference·internal"·href="#s-subsections"><span·class="std·std-ref">Sections</span></a>.</p> |
| 263 | <p>Source·packages·in·<em>main</em>·with·a·mixture·of·<em>main</em>·and·<em>contrib</em>·binary | 263 | <p>Source·packages·in·<em>main</em>·with·a·mixture·of·<em>main</em>·and·<em>contrib</em>·binary |
| 264 | packages·are·more·complex·for·archive·tooling·to·handle,·and·therefore | 264 | packages·are·more·complex·for·archive·tooling·to·handle,·and·therefore |
| 265 | should·be·limited·to·situations·where·it·would·be·inconvenient·to·split | 265 | should·be·limited·to·situations·where·it·would·be·inconvenient·to·split |
| 266 | the·source·package.·If·it·is·straightforward·to·split·the·source·package | 266 | the·source·package.·If·it·is·straightforward·to·split·the·source·package |
| 267 | into·a·<em>main</em>·part·and·a·<em>contrib</em>·part·that·are·built·separately,·then | 267 | into·a·<em>main</em>·part·and·a·<em>contrib</em>·part·that·are·built·separately,·then |
| 268 | those·parts·should·be·represented·as·separate·source·packages.</p> | 268 | those·parts·should·be·represented·as·separate·source·packages.</p> |
| Offset 277, 17 lines modified | Offset 277, 17 lines modified | ||
| 277 | <aside·class="footnote·brackets"·id="id5"·role="doc-footnote"> | 277 | <aside·class="footnote·brackets"·id="id5"·role="doc-footnote"> |
| 278 | <span·class="label"><span·class="fn-bracket">[</span><a·role="doc-backlink"·href="#id3">2</a><span·class="fn-bracket">]</span></span> | 278 | <span·class="label"><span·class="fn-bracket">[</span><a·role="doc-backlink"·href="#id3">2</a><span·class="fn-bracket">]</span></span> |
| 279 | <p>See·<a·class="reference·external"·href="https://www.debian.org/intro/free">What·Does·Free·Mean?</a>·for | 279 | <p>See·<a·class="reference·external"·href="https://www.debian.org/intro/free">What·Does·Free·Mean?</a>·for |
| 280 | more·about·what·we·mean·by·free·software.</p> | 280 | more·about·what·we·mean·by·free·software.</p> |
| 281 | </aside> | 281 | </aside> |
| 282 | <aside·class="footnote·brackets"·id="id6"·role="doc-footnote"> | 282 | <aside·class="footnote·brackets"·id="id6"·role="doc-footnote"> |
| 283 | <span·class="label"><span·class="fn-bracket">[</span><a·role="doc-backlink"·href="#id4">3</a><span·class="fn-bracket">]</span></span> | 283 | <span·class="label"><span·class="fn-bracket">[</span><a·role="doc-backlink"·href="#id4">3</a><span·class="fn-bracket">]</span></span> |
| 284 | <p>Debian | 284 | <p>Debian’s·FTP·Masters·publish·a |
| 285 | <a·class="reference·external"·href="https://ftp-master.debian.org/REJECT-FAQ.html">REJECT-FAQ</a>·which | 285 | <a·class="reference·external"·href="https://ftp-master.debian.org/REJECT-FAQ.html">REJECT-FAQ</a>·which |
| 286 | details·the·project | 286 | details·the·project’s·current·working·interpretation·of·the·DFSG.</p> |
| 287 | </aside> | 287 | </aside> |
| 288 | </aside> | 288 | </aside> |
| 289 | </section> | 289 | </section> |
| 290 | <section·id="the-non-free-firmware-archive-area"> | 290 | <section·id="the-non-free-firmware-archive-area"> |
| 291 | <span·id="s-non-free-firmware"></span><h3><span·class="section-number">2.2.2.·</span>The·non-free-firmware·archive·area<a·class="headerlink"·href="#the-non-free-firmware-archive-area"·title="Link·to·this·heading"></a></h3> | 291 | <span·id="s-non-free-firmware"></span><h3><span·class="section-number">2.2.2.·</span>The·non-free-firmware·archive·area<a·class="headerlink"·href="#the-non-free-firmware-archive-area"·title="Link·to·this·heading"></a></h3> |
| 292 | <p>The·<em>non-free-firmware</em>·archive·area·contains·packages·providing | 292 | <p>The·<em>non-free-firmware</em>·archive·area·contains·packages·providing |
| 293 | firmware·needed·to·initialize,·use·or·keep·updated·hardware·required | 293 | firmware·needed·to·initialize,·use·or·keep·updated·hardware·required |
| Offset 412, 35 lines modified | Offset 412, 35 lines modified | ||
| 412 | supposedly-free·software.·It·is·often·worthwhile·contacting·such·authors | 412 | supposedly-free·software.·It·is·often·worthwhile·contacting·such·authors |
| 413 | diplomatically·to·ask·them·to·modify·their·license·terms.·However,·this | 413 | diplomatically·to·ask·them·to·modify·their·license·terms.·However,·this |
| 414 | can·be·a·politically·difficult·thing·to·do·and·you·should·ask·for·advice | 414 | can·be·a·politically·difficult·thing·to·do·and·you·should·ask·for·advice |
| 415 | on·the·<code·class="docutils·literal·notranslate"><span·class="pre">debian-legal</span></code>·mailing·list·first,·as·explained·below.</p> | 415 | on·the·<code·class="docutils·literal·notranslate"><span·class="pre">debian-legal</span></code>·mailing·list·first,·as·explained·below.</p> |
| 416 | <p>When·in·doubt·about·a·copyright,·send·mail·to | 416 | <p>When·in·doubt·about·a·copyright,·send·mail·to |
| 417 | <a·class="reference·external"·href="mailto:debian-legal%40lists.debian.org">debian-legal<span>@</span>lists<span>.</span>debian<span>.</span>org</a>.·Be·prepared·to·provide·us·with·the | 417 | <a·class="reference·external"·href="mailto:debian-legal%40lists.debian.org">debian-legal<span>@</span>lists<span>.</span>debian<span>.</span>org</a>.·Be·prepared·to·provide·us·with·the |
| 418 | copyright·statement.·Software·covered·by·the·GPL,·public·domain·software | 418 | copyright·statement.·Software·covered·by·the·GPL,·public·domain·software |
| 419 | and·BSD-like·copyrights·are·safe;·be·wary·of·the·phrases· | 419 | and·BSD-like·copyrights·are·safe;·be·wary·of·the·phrases·“commercial·use |
| 420 | prohibited | 420 | prohibited”·and·“distribution·restricted”.</p> |
| 421 | <aside·class="footnote-list·brackets"> | 421 | <aside·class="footnote-list·brackets"> |
| 422 | <aside·class="footnote·brackets"·id="id11"·role="doc-footnote"> | 422 | <aside·class="footnote·brackets"·id="id11"·role="doc-footnote"> |
| 423 | <span·class="label"><span·class="fn-bracket">[</span><a·role="doc-backlink"·href="#id10">5</a><span·class="fn-bracket">]</span></span> | 423 | <span·class="label"><span·class="fn-bracket">[</span><a·role="doc-backlink"·href="#id10">5</a><span·class="fn-bracket">]</span></span> |
| 424 | <p>Licenses·that·are·not·thought·to·require·the·copying·of·all | 424 | <p>Licenses·that·are·not·thought·to·require·the·copying·of·all |
| 425 | copyright·notices·into·Debian | 425 | copyright·notices·into·Debian’s·copyright·file·include·Apache-2.0 |
| 426 | and·the·Boost·Software·License,·version·1.0.··Final·determination | 426 | and·the·Boost·Software·License,·version·1.0.··Final·determination |
| 427 | as·to·whether·a·package | 427 | as·to·whether·a·package’s·copyright·file·is·sufficient·lies·with |
| Max diff block lines reached; 5872/14926 bytes (39.34%) of diff not shown. | |||
| Offset 57, 38 lines modified | Offset 57, 38 lines modified | ||
| 57 | ······laws. | 57 | ······laws. |
| 58 | The·m\x8ma\x8ai\x8in\x8n·archive·area·forms·the·D\x8De\x8eb\x8bi\x8ia\x8an\x8n·d\x8di\x8is\x8st\x8tr\x8ri\x8ib\x8bu\x8ut\x8ti\x8io\x8on\x8n. | 58 | The·m\x8ma\x8ai\x8in\x8n·archive·area·forms·the·D\x8De\x8eb\x8bi\x8ia\x8an\x8n·d\x8di\x8is\x8st\x8tr\x8ri\x8ib\x8bu\x8ut\x8ti\x8io\x8on\x8n. |
| 59 | Packages·in·the·other·archive·areas·(non-free-firmware,·contrib,·non-free)·are | 59 | Packages·in·the·other·archive·areas·(non-free-firmware,·contrib,·non-free)·are |
| 60 | not·considered·to·be·part·of·the·Debian·distribution,·although·we·support·their | 60 | not·considered·to·be·part·of·the·Debian·distribution,·although·we·support·their |
| 61 | use·and·provide·infrastructure·for·them·(such·as·our·bug-tracking·system·and | 61 | use·and·provide·infrastructure·for·them·(such·as·our·bug-tracking·system·and |
| 62 | mailing·lists).·This·Debian·Policy·Manual·applies·to·these·packages·as·well. | 62 | mailing·lists).·This·Debian·Policy·Manual·applies·to·these·packages·as·well. |
| 63 | [_\x81] | 63 | [_\x81] |
| 64 | The·Debian·archive·software·uses·the·term· | 64 | The·Debian·archive·software·uses·the·term·“component”·internally·and·in·the |
| 65 | Release·file·format·to·refer·to·the·division·of·an·archive.·The·Debian·Social | 65 | Release·file·format·to·refer·to·the·division·of·an·archive.·The·Debian·Social |
| 66 | Contract·simply·refers·to· | 66 | Contract·simply·refers·to·“areas.”·This·document·uses·terminology·similar·to |
| 67 | the·Social·Contract. | 67 | the·Social·Contract. |
| 68 | *\x8**\x8**\x8**\x8**\x8*·2\x82.\x8.1\x81.\x8.·T\x8Th\x8he\x8e·D\x8De\x8eb\x8bi\x8ia\x8an\x8n·F\x8Fr\x8re\x8ee\x8e·S\x8So\x8of\x8ft\x8tw\x8wa\x8ar\x8re\x8e·G\x8Gu\x8ui\x8id\x8de\x8el\x8li\x8in\x8ne\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 68 | *\x8**\x8**\x8**\x8**\x8*·2\x82.\x8.1\x81.\x8.·T\x8Th\x8he\x8e·D\x8De\x8eb\x8bi\x8ia\x8an\x8n·F\x8Fr\x8re\x8ee\x8e·S\x8So\x8of\x8ft\x8tw\x8wa\x8ar\x8re\x8e·G\x8Gu\x8ui\x8id\x8de\x8el\x8li\x8in\x8ne\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 69 | The·Debian·Free·Software·Guidelines·(DFSG)·form·our·definition·of· | 69 | The·Debian·Free·Software·Guidelines·(DFSG)·form·our·definition·of·“free |
| 70 | software | 70 | software”.·These·are: |
| 71 | ···1.···Free·Redistribution | 71 | ···1.···Free·Redistribution |
| 72 | ············The·license·of·a·Debian·component·may·not·restrict·any·party·from | 72 | ············The·license·of·a·Debian·component·may·not·restrict·any·party·from |
| 73 | ············selling·or·giving·away·the·software·as·a·component·of·an·aggregate | 73 | ············selling·or·giving·away·the·software·as·a·component·of·an·aggregate |
| 74 | ············software·distribution·containing·programs·from·several·different | 74 | ············software·distribution·containing·programs·from·several·different |
| 75 | ············sources.·The·license·may·not·require·a·royalty·or·other·fee·for | 75 | ············sources.·The·license·may·not·require·a·royalty·or·other·fee·for |
| 76 | ············such·sale. | 76 | ············such·sale. |
| 77 | ···2.···Source·Code | 77 | ···2.···Source·Code |
| 78 | ············The·program·must·include·source·code,·and·must·allow·distribution | 78 | ············The·program·must·include·source·code,·and·must·allow·distribution |
| 79 | ············in·source·code·as·well·as·compiled·form. | 79 | ············in·source·code·as·well·as·compiled·form. |
| 80 | ···3.···Derived·Works | 80 | ···3.···Derived·Works |
| 81 | ············The·license·must·allow·modifications·and·derived·works,·and·must | 81 | ············The·license·must·allow·modifications·and·derived·works,·and·must |
| 82 | ············allow·them·to·be·distributed·under·the·same·terms·as·the·license·of | 82 | ············allow·them·to·be·distributed·under·the·same·terms·as·the·license·of |
| 83 | ············the·original·software. | 83 | ············the·original·software. |
| 84 | ···4.···Integrity·of·The·Author | 84 | ···4.···Integrity·of·The·Author’s·Source·Code |
| 85 | ············The·license·may·restrict·source-code·from·being·distributed·in | 85 | ············The·license·may·restrict·source-code·from·being·distributed·in |
| 86 | ············modified·form·o\x8on\x8nl\x8ly\x8y·if·the·license·allows·the·distribution·of· | 86 | ············modified·form·o\x8on\x8nl\x8ly\x8y·if·the·license·allows·the·distribution·of·“patch |
| 87 | ············files | 87 | ············files”·with·the·source·code·for·the·purpose·of·modifying·the |
| 88 | ············program·at·build·time.·The·license·must·explicitly·permit | 88 | ············program·at·build·time.·The·license·must·explicitly·permit |
| 89 | ············distribution·of·software·built·from·modified·source·code.·The | 89 | ············distribution·of·software·built·from·modified·source·code.·The |
| 90 | ············license·may·require·derived·works·to·carry·a·different·name·or | 90 | ············license·may·require·derived·works·to·carry·a·different·name·or |
| 91 | ············version·number·from·the·original·software.·(This·is·a·compromise. | 91 | ············version·number·from·the·original·software.·(This·is·a·compromise. |
| 92 | ············The·Debian·Project·encourages·all·authors·to·not·restrict·any | 92 | ············The·Debian·Project·encourages·all·authors·to·not·restrict·any |
| 93 | ············files,·source·or·binary,·from·being·modified.) | 93 | ············files,·source·or·binary,·from·being·modified.) |
| 94 | ···5.···No·Discrimination·Against·Persons·or·Groups | 94 | ···5.···No·Discrimination·Against·Persons·or·Groups |
| Offset 100, 27 lines modified | Offset 100, 27 lines modified | ||
| 100 | ············the·program·from·being·used·in·a·business,·or·from·being·used·for | 100 | ············the·program·from·being·used·in·a·business,·or·from·being·used·for |
| 101 | ············genetic·research. | 101 | ············genetic·research. |
| 102 | ···7.···Distribution·of·License | 102 | ···7.···Distribution·of·License |
| 103 | ············The·rights·attached·to·the·program·must·apply·to·all·to·whom·the | 103 | ············The·rights·attached·to·the·program·must·apply·to·all·to·whom·the |
| 104 | ············program·is·redistributed·without·the·need·for·execution·of·an | 104 | ············program·is·redistributed·without·the·need·for·execution·of·an |
| 105 | ············additional·license·by·those·parties. | 105 | ············additional·license·by·those·parties. |
| 106 | ···8.···License·Must·Not·Be·Specific·to·Debian | 106 | ···8.···License·Must·Not·Be·Specific·to·Debian |
| 107 | ············The·rights·attached·to·the·program·must·not·depend·on·the·program | 107 | ············The·rights·attached·to·the·program·must·not·depend·on·the·program’s |
| 108 | ············being·part·of·a·Debian·system.·If·the·program·is·extracted·from | 108 | ············being·part·of·a·Debian·system.·If·the·program·is·extracted·from |
| 109 | ············Debian·and·used·or·distributed·without·Debian·but·otherwise·within | 109 | ············Debian·and·used·or·distributed·without·Debian·but·otherwise·within |
| 110 | ············the·terms·of·the·program | 110 | ············the·terms·of·the·program’s·license,·all·parties·to·whom·the·program |
| 111 | ············is·redistributed·must·have·the·same·rights·as·those·that·are | 111 | ············is·redistributed·must·have·the·same·rights·as·those·that·are |
| 112 | ············granted·in·conjunction·with·the·Debian·system. | 112 | ············granted·in·conjunction·with·the·Debian·system. |
| 113 | ···9.···License·Must·Not·Contaminate·Other·Software | 113 | ···9.···License·Must·Not·Contaminate·Other·Software |
| 114 | ············The·license·must·not·place·restrictions·on·other·software·that·is | 114 | ············The·license·must·not·place·restrictions·on·other·software·that·is |
| 115 | ············distributed·along·with·the·licensed·software.·For·example,·the | 115 | ············distributed·along·with·the·licensed·software.·For·example,·the |
| 116 | ············license·must·not·insist·that·all·other·programs·distributed·on·the | 116 | ············license·must·not·insist·that·all·other·programs·distributed·on·the |
| 117 | ············same·medium·must·be·free·software. | 117 | ············same·medium·must·be·free·software. |
| 118 | ··10.···Example·Licenses | 118 | ··10.···Example·Licenses |
| 119 | ············The· | 119 | ············The·“GPL,”·“BSD,”·and·“Artistic”·licenses·are·examples·of·licenses |
| 120 | ············that·we·consider·f\x8fr\x8re\x8ee\x8e. | 120 | ············that·we·consider·f\x8fr\x8re\x8ee\x8e. |
| 121 | *\x8**\x8**\x8**\x8**\x8*·2\x82.\x8.2\x82.\x8.·A\x8Ar\x8rc\x8ch\x8hi\x8iv\x8ve\x8e·a\x8ar\x8re\x8ea\x8as\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 121 | *\x8**\x8**\x8**\x8**\x8*·2\x82.\x8.2\x82.\x8.·A\x8Ar\x8rc\x8ch\x8hi\x8iv\x8ve\x8e·a\x8ar\x8re\x8ea\x8as\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 122 | *\x8**\x8**\x8**\x8*·2\x82.\x8.2\x82.\x8.1\x81.\x8.·T\x8Th\x8he\x8e·m\x8ma\x8ai\x8in\x8n·a\x8ar\x8rc\x8ch\x8hi\x8iv\x8ve\x8e·a\x8ar\x8re\x8ea\x8a_\x8?\x8·*\x8**\x8**\x8**\x8* | 122 | *\x8**\x8**\x8**\x8*·2\x82.\x8.2\x82.\x8.1\x81.\x8.·T\x8Th\x8he\x8e·m\x8ma\x8ai\x8in\x8n·a\x8ar\x8rc\x8ch\x8hi\x8iv\x8ve\x8e·a\x8ar\x8re\x8ea\x8a_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 123 | The·m\x8ma\x8ai\x8in\x8n·archive·area·comprises·the·Debian·distribution.·Only·the·packages·in | 123 | The·m\x8ma\x8ai\x8in\x8n·archive·area·comprises·the·Debian·distribution.·Only·the·packages·in |
| 124 | this·area·are·considered·part·of·the·distribution.·None·of·the·packages·in·the | 124 | this·area·are·considered·part·of·the·distribution.·None·of·the·packages·in·the |
| 125 | m\x8ma\x8ai\x8in\x8n·archive·area·require·software·outside·of·that·area·to·function.·Anyone·may | 125 | m\x8ma\x8ai\x8in\x8n·archive·area·require·software·outside·of·that·area·to·function.·Anyone·may |
| 126 | use,·share,·modify·and·redistribute·the·packages·in·this·archive·area·freely | 126 | use,·share,·modify·and·redistribute·the·packages·in·this·archive·area·freely |
| Offset 134, 15 lines modified | Offset 134, 15 lines modified | ||
| 134 | ······relationship·on·a·non-m\x8ma\x8ai\x8in\x8n·package·unless·that·package·is·only·listed·as | 134 | ······relationship·on·a·non-m\x8ma\x8ai\x8in\x8n·package·unless·that·package·is·only·listed·as |
| 135 | ······a·non-default·alternative·for·a·package·in·m\x8ma\x8ai\x8in\x8n), | 135 | ······a·non-default·alternative·for·a·package·in·m\x8ma\x8ai\x8in\x8n), |
| 136 | ····*·must·not·be·so·buggy·that·we·refuse·to·support·them,·and | 136 | ····*·must·not·be·so·buggy·that·we·refuse·to·support·them,·and |
| 137 | ····*·must·meet·all·policy·requirements·presented·in·this·manual. | 137 | ····*·must·meet·all·policy·requirements·presented·in·this·manual. |
| 138 | If·a·source·package·is·in·the·m\x8ma\x8ai\x8in\x8n·archive·area,·then·at·least·one·of·its | 138 | If·a·source·package·is·in·the·m\x8ma\x8ai\x8in\x8n·archive·area,·then·at·least·one·of·its |
| 139 | binary·packages·must·be·in·the·m\x8ma\x8ai\x8in\x8n·archive·area,·and·each·of·the·remaining | 139 | binary·packages·must·be·in·the·m\x8ma\x8ai\x8in\x8n·archive·area,·and·each·of·the·remaining |
| 140 | packages·must·be·in·either·the·m\x8ma\x8ai\x8in\x8n·or·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·archive·area.·Each·binary | 140 | packages·must·be·in·either·the·m\x8ma\x8ai\x8in\x8n·or·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·archive·area.·Each·binary |
| 141 | package | 141 | package’s·archive·area·is·indicated·by·its·Section·field:·see·_\x8S_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n_\x8s. |
| 142 | Source·packages·in·m\x8ma\x8ai\x8in\x8n·with·a·mixture·of·m\x8ma\x8ai\x8in\x8n·and·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·binary·packages·are | 142 | Source·packages·in·m\x8ma\x8ai\x8in\x8n·with·a·mixture·of·m\x8ma\x8ai\x8in\x8n·and·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·binary·packages·are |
| 143 | more·complex·for·archive·tooling·to·handle,·and·therefore·should·be·limited·to | 143 | more·complex·for·archive·tooling·to·handle,·and·therefore·should·be·limited·to |
| 144 | situations·where·it·would·be·inconvenient·to·split·the·source·package.·If·it·is | 144 | situations·where·it·would·be·inconvenient·to·split·the·source·package.·If·it·is |
| 145 | straightforward·to·split·the·source·package·into·a·m\x8ma\x8ai\x8in\x8n·part·and·a·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·part | 145 | straightforward·to·split·the·source·package·into·a·m\x8ma\x8ai\x8in\x8n·part·and·a·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·part |
| 146 | that·are·built·separately,·then·those·parts·should·be·represented·as·separate | 146 | that·are·built·separately,·then·those·parts·should·be·represented·as·separate |
| 147 | source·packages. | 147 | source·packages. |
| 148 | When·a·m\x8ma\x8ai\x8in\x8n·source·package·has·a·mixture·of·m\x8ma\x8ai\x8in\x8n·and·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·binary·packages, | 148 | When·a·m\x8ma\x8ai\x8in\x8n·source·package·has·a·mixture·of·m\x8ma\x8ai\x8in\x8n·and·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·binary·packages, |
| Offset 150, 15 lines modified | Offset 150, 15 lines modified | ||
| 150 | for·m\x8ma\x8ai\x8in\x8n·packages,·but·the·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·binary·packages·may·follow·the·weaker | 150 | for·m\x8ma\x8ai\x8in\x8n·packages,·but·the·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·binary·packages·may·follow·the·weaker |
| 151 | requirements·for·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·packages.·In·particular,·source·packages·in·m\x8ma\x8ai\x8in\x8n·must | 151 | requirements·for·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·packages.·In·particular,·source·packages·in·m\x8ma\x8ai\x8in\x8n·must |
| 152 | not·have·build·dependencies·outside·m\x8ma\x8ai\x8in\x8n,·but·the·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·binary·packages·may | 152 | not·have·build·dependencies·outside·m\x8ma\x8ai\x8in\x8n,·but·the·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·binary·packages·may |
| 153 | have·runtime·dependencies·outside·m\x8ma\x8ai\x8in\x8n. | 153 | have·runtime·dependencies·outside·m\x8ma\x8ai\x8in\x8n. |
| 154 | [_\x82] | 154 | [_\x82] |
| 155 | See·_\x8W_\x8h_\x8a_\x8t_\x8·_\x8D_\x8o_\x8e_\x8s_\x8·_\x8F_\x8r_\x8e_\x8e_\x8·_\x8M_\x8e_\x8a_\x8n_\x8?·for·more·about·what·we·mean·by·free·software. | 155 | See·_\x8W_\x8h_\x8a_\x8t_\x8·_\x8D_\x8o_\x8e_\x8s_\x8·_\x8F_\x8r_\x8e_\x8e_\x8·_\x8M_\x8e_\x8a_\x8n_\x8?·for·more·about·what·we·mean·by·free·software. |
| 156 | [_\x83] | 156 | [_\x83] |
| 157 | Debian | 157 | Debian’s·FTP·Masters·publish·a·_.R_.E_.J_.E_.C_.T_.-_.F_.A_.Q·which·details·the·project’s·current |
| 158 | working·interpretation·of·the·DFSG. | 158 | working·interpretation·of·the·DFSG. |
| 159 | *\x8**\x8**\x8**\x8*·2\x82.\x8.2\x82.\x8.2\x82.\x8.·T\x8Th\x8he\x8e·n\x8no\x8on\x8n-\x8-f\x8fr\x8re\x8ee\x8e-\x8-f\x8fi\x8ir\x8rm\x8mw\x8wa\x8ar\x8re\x8e·a\x8ar\x8rc\x8ch\x8hi\x8iv\x8ve\x8e·a\x8ar\x8re\x8ea\x8a_\x8?\x8·*\x8**\x8**\x8**\x8* | 159 | *\x8**\x8**\x8**\x8*·2\x82.\x8.2\x82.\x8.2\x82.\x8.·T\x8Th\x8he\x8e·n\x8no\x8on\x8n-\x8-f\x8fr\x8re\x8ee\x8e-\x8-f\x8fi\x8ir\x8rm\x8mw\x8wa\x8ar\x8re\x8e·a\x8ar\x8rc\x8ch\x8hi\x8iv\x8ve\x8e·a\x8ar\x8re\x8ea\x8a_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 160 | The·n\x8no\x8on\x8n-\x8-f\x8fr\x8re\x8ee\x8e-\x8-f\x8fi\x8ir\x8rm\x8mw\x8wa\x8ar\x8re\x8e·archive·area·contains·packages·providing·firmware·needed | 160 | The·n\x8no\x8on\x8n-\x8-f\x8fr\x8re\x8ee\x8e-\x8-f\x8fi\x8ir\x8rm\x8mw\x8wa\x8ar\x8re\x8e·archive·area·contains·packages·providing·firmware·needed |
| 161 | to·initialize,·use·or·keep·updated·hardware·required·by·our·users,·typically | 161 | to·initialize,·use·or·keep·updated·hardware·required·by·our·users,·typically |
| 162 | necessary·for·important·functions·to·be·available·(i.e.·wireless·network | 162 | necessary·for·important·functions·to·be·available·(i.e.·wireless·network |
| 163 | connectivity)·or·for·fixing·security·defects·in·hardware·(i.e.·CPU·microcode | 163 | connectivity)·or·for·fixing·security·defects·in·hardware·(i.e.·CPU·microcode |
| 164 | updates).·Packages·in·this·archive·may·not·comply·with·all·of·the·policy | 164 | updates).·Packages·in·this·archive·may·not·comply·with·all·of·the·policy |
| Offset 249, 27 lines modified | Offset 249, 27 lines modified | ||
| 249 | software.·It·is·often·worthwhile·contacting·such·authors·diplomatically·to·ask | 249 | software.·It·is·often·worthwhile·contacting·such·authors·diplomatically·to·ask |
| 250 | them·to·modify·their·license·terms.·However,·this·can·be·a·politically | 250 | them·to·modify·their·license·terms.·However,·this·can·be·a·politically |
| 251 | difficult·thing·to·do·and·you·should·ask·for·advice·on·the·debian-legal·mailing | 251 | difficult·thing·to·do·and·you·should·ask·for·advice·on·the·debian-legal·mailing |
| 252 | list·first,·as·explained·below. | 252 | list·first,·as·explained·below. |
| 253 | When·in·doubt·about·a·copyright,·send·mail·to·_\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8-_\x8l_\x8e_\x8g_\x8a_\x8l_\x8@_\x8l_\x8i_\x8s_\x8t_\x8s_\x8._\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8._\x8o_\x8r_\x8g.·Be | 253 | When·in·doubt·about·a·copyright,·send·mail·to·_\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8-_\x8l_\x8e_\x8g_\x8a_\x8l_\x8@_\x8l_\x8i_\x8s_\x8t_\x8s_\x8._\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8._\x8o_\x8r_\x8g.·Be |
| 254 | prepared·to·provide·us·with·the·copyright·statement.·Software·covered·by·the | 254 | prepared·to·provide·us·with·the·copyright·statement.·Software·covered·by·the |
| 255 | GPL,·public·domain·software·and·BSD-like·copyrights·are·safe;·be·wary·of·the | 255 | GPL,·public·domain·software·and·BSD-like·copyrights·are·safe;·be·wary·of·the |
| 256 | phrases· | 256 | phrases·“commercial·use·prohibited”·and·“distribution·restricted”. |
| 257 | [_\x85] | 257 | [_\x85] |
| 258 | Licenses·that·are·not·thought·to·require·the·copying·of·all·copyright·notices | 258 | Licenses·that·are·not·thought·to·require·the·copying·of·all·copyright·notices |
| 259 | into·Debian | 259 | into·Debian’s·copyright·file·include·Apache-2.0·and·the·Boost·Software·License, |
| 260 | version·1.0.·Final·determination·as·to·whether·a·package | 260 | version·1.0.·Final·determination·as·to·whether·a·package’s·copyright·file·is |
| 261 | sufficient·lies·with·the·FTP·team. | 261 | sufficient·lies·with·the·FTP·team. |
| 262 | To·help·find·copyright·notices·you·need·to·copy,·you·might·try·grep·-- | 262 | To·help·find·copyright·notices·you·need·to·copy,·you·might·try·grep·-- |
| 263 | color=always·-Eir·'(copyright|©)'·*·|·less·-R | 263 | color=always·-Eir·'(copyright|©)'·*·|·less·-R |
| 264 | *\x8**\x8**\x8**\x8**\x8*·2\x82.\x8.4\x84.\x8.·S\x8Se\x8ec\x8ct\x8ti\x8io\x8on\x8ns\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 264 | *\x8**\x8**\x8**\x8**\x8*·2\x82.\x8.4\x84.\x8.·S\x8Se\x8ec\x8ct\x8ti\x8io\x8on\x8ns\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 265 | The·packages·in·the·archive·areas·m\x8ma\x8ai\x8in\x8n,·n\x8no\x8on\x8n-\x8-f\x8fr\x8re\x8ee\x8e-\x8-f\x8fi\x8ir\x8rm\x8mw\x8wa\x8ar\x8re\x8e,·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·and·n\x8no\x8on\x8n-\x8-f\x8fr\x8re\x8ee\x8e | 265 | The·packages·in·the·archive·areas·m\x8ma\x8ai\x8in\x8n,·n\x8no\x8on\x8n-\x8-f\x8fr\x8re\x8ee\x8e-\x8-f\x8fi\x8ir\x8rm\x8mw\x8wa\x8ar\x8re\x8e,·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·and·n\x8no\x8on\x8n-\x8-f\x8fr\x8re\x8ee\x8e |
| 266 | are·grouped·further·into·s\x8se\x8ec\x8ct\x8ti\x8io\x8on\x8ns\x8s·to·simplify·handling. | 266 | are·grouped·further·into·s\x8se\x8ec\x8ct\x8ti\x8io\x8on\x8ns\x8s·to·simplify·handling. |
| 267 | The·archive·area·and·section·for·each·package·should·be·specified·in·the | 267 | The·archive·area·and·section·for·each·package·should·be·specified·in·the |
| 268 | package | 268 | package’s·Section·control·field·(see·_\x8S_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n).·However,·the·maintainer·of·the |
| 269 | Debian·archive·may·override·this·selection·to·ensure·the·consistency·of·the | 269 | Debian·archive·may·override·this·selection·to·ensure·the·consistency·of·the |
| 270 | Debian·distribution.·The·Section·field·should·be·of·the·form: | 270 | Debian·distribution.·The·Section·field·should·be·of·the·form: |
| 271 | ····*·s\x8se\x8ec\x8ct\x8ti\x8io\x8on\x8n·if·the·package·is·in·the·m\x8ma\x8ai\x8in\x8n·archive·area, | 271 | ····*·s\x8se\x8ec\x8ct\x8ti\x8io\x8on\x8n·if·the·package·is·in·the·m\x8ma\x8ai\x8in\x8n·archive·area, |
| 272 | ····*·a\x8ar\x8re\x8ea\x8a/\x8/s\x8se\x8ec\x8ct\x8ti\x8io\x8on\x8n·if·the·package·is·in·the·n\x8no\x8on\x8n-\x8-f\x8fr\x8re\x8ee\x8e-\x8-f\x8fi\x8ir\x8rm\x8mw\x8wa\x8ar\x8re\x8e,·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·or·n\x8no\x8on\x8n-\x8- | 272 | ····*·a\x8ar\x8re\x8ea\x8a/\x8/s\x8se\x8ec\x8ct\x8ti\x8io\x8on\x8n·if·the·package·is·in·the·n\x8no\x8on\x8n-\x8-f\x8fr\x8re\x8ee\x8e-\x8-f\x8fi\x8ir\x8rm\x8mw\x8wa\x8ar\x8re\x8e,·c\x8co\x8on\x8nt\x8tr\x8ri\x8ib\x8b·or·n\x8no\x8on\x8n-\x8- |
| 273 | ······f\x8fr\x8re\x8ee\x8e·archive·areas. | 273 | ······f\x8fr\x8re\x8ee\x8e·archive·areas. |
| 274 | The·Debian·archive·maintainers·provide·the·authoritative·list·of·sections.·At | 274 | The·Debian·archive·maintainers·provide·the·authoritative·list·of·sections.·At |
| 275 | present,·they·are:·admin,·cli-mono,·comm,·database,·debug,·devel,·doc,·editors, | 275 | present,·they·are:·admin,·cli-mono,·comm,·database,·debug,·devel,·doc,·editors, |
| Offset 280, 15 lines modified | Offset 280, 15 lines modified | ||
| Max diff block lines reached; 2980/13103 bytes (22.74%) of diff not shown. | |||
| Offset 133, 40 lines modified | Offset 133, 40 lines modified | ||
| 133 | on·the·system·when·the·package·is·installed,·and·a·set·of·files·that | 133 | on·the·system·when·the·package·is·installed,·and·a·set·of·files·that |
| 134 | provide·additional·metadata·about·the·package·or·which·are·executed·when | 134 | provide·additional·metadata·about·the·package·or·which·are·executed·when |
| 135 | the·package·is·installed·or·removed.·This·second·set·of·files·is·called | 135 | the·package·is·installed·or·removed.·This·second·set·of·files·is·called |
| 136 | <em>package·metadata·files</em>.·Among·those·files·are·the·package·maintainer | 136 | <em>package·metadata·files</em>.·Among·those·files·are·the·package·maintainer |
| 137 | scripts·and·<code·class="docutils·literal·notranslate"><span·class="pre">control</span></code>,·the·<a·class="reference·internal"·href="ch-controlfields.html#s-binarycontrolfiles"><span·class="std·std-ref">binary·package·control·file</span></a>·that·contains·the·control·fields·for·the | 137 | scripts·and·<code·class="docutils·literal·notranslate"><span·class="pre">control</span></code>,·the·<a·class="reference·internal"·href="ch-controlfields.html#s-binarycontrolfiles"><span·class="std·std-ref">binary·package·control·file</span></a>·that·contains·the·control·fields·for·the |
| 138 | package.·Other·package·metadata·files·include·<a·class="reference·internal"·href="ch-sharedlibs.html#s-sharedlibs-symbols"><span·class="std·std-ref">symbols</span></a>·or·<a·class="reference·internal"·href="ch-sharedlibs.html#s-sharedlibs-shlibdeps"><span·class="std·std-ref">shlibs</span></a>·used·to | 138 | package.·Other·package·metadata·files·include·<a·class="reference·internal"·href="ch-sharedlibs.html#s-sharedlibs-symbols"><span·class="std·std-ref">symbols</span></a>·or·<a·class="reference·internal"·href="ch-sharedlibs.html#s-sharedlibs-shlibdeps"><span·class="std·std-ref">shlibs</span></a>·used·to |
| 139 | store·shared·library·dependency·information·and·the·<code·class="docutils·literal·notranslate"><span·class="pre">conffiles</span></code>·file | 139 | store·shared·library·dependency·information·and·the·<code·class="docutils·literal·notranslate"><span·class="pre">conffiles</span></code>·file |
| 140 | that·lists·the·package | 140 | that·lists·the·package’s·configuration·files·(described·in |
| 141 | <a·class="reference·internal"·href="ch-files.html#s-config-files"><span·class="std·std-ref">Configuration·files</span></a>).</p> | 141 | <a·class="reference·internal"·href="ch-files.html#s-config-files"><span·class="std·std-ref">Configuration·files</span></a>).</p> |
| 142 | <p>There·is·unfortunately·a·collision·of·terminology·here·between·control | 142 | <p>There·is·unfortunately·a·collision·of·terminology·here·between·control |
| 143 | information·files·and·files·in·the·Debian·control·file·format. | 143 | information·files·and·files·in·the·Debian·control·file·format. |
| 144 | Throughout·this·document,·a·<em>control·file</em>·refers·to·a·file·in·the | 144 | Throughout·this·document,·a·<em>control·file</em>·refers·to·a·file·in·the |
| 145 | Debian·control·file·format.·These·files·are·documented·in | 145 | Debian·control·file·format.·These·files·are·documented·in |
| 146 | <a·class="reference·internal"·href="ch-controlfields.html"><span·class="doc">Control·files·and·their·fields</span></a>.·Only·files | 146 | <a·class="reference·internal"·href="ch-controlfields.html"><span·class="doc">Control·files·and·their·fields</span></a>.·Only·files |
| 147 | referred·to·specifically·as·<em>package·metadata·files</em>·are·the·files | 147 | referred·to·specifically·as·<em>package·metadata·files</em>·are·the·files |
| 148 | included·in·the·package·metadata·member·(called·<code·class="docutils·literal·notranslate"><span·class="pre">control.tar</span></code>)·of·the | 148 | included·in·the·package·metadata·member·(called·<code·class="docutils·literal·notranslate"><span·class="pre">control.tar</span></code>)·of·the |
| 149 | <code·class="docutils·literal·notranslate"><span·class="pre">.deb</span></code>·file·format·used·by·binary·packages.·Most·package·metadata·files | 149 | <code·class="docutils·literal·notranslate"><span·class="pre">.deb</span></code>·file·format·used·by·binary·packages.·Most·package·metadata·files |
| 150 | are·not·in·the·Debian·control·file·format.</p> | 150 | are·not·in·the·Debian·control·file·format.</p> |
| 151 | <section·id="the-package-name"> | 151 | <section·id="the-package-name"> |
| 152 | <span·id="s3-1"></span><h2><span·class="section-number">3.1.·</span>The·package·name<a·class="headerlink"·href="#the-package-name"·title="Link·to·this·heading"></a></h2> | 152 | <span·id="s3-1"></span><h2><span·class="section-number">3.1.·</span>The·package·name<a·class="headerlink"·href="#the-package-name"·title="Link·to·this·heading"></a></h2> |
| 153 | <p>Every·package·must·have·a·name·that | 153 | <p>Every·package·must·have·a·name·that’s·unique·within·the·Debian·archive.</p> |
| 154 | <p>The·package·name·is·included·in·the·control·field·<code·class="docutils·literal·notranslate"><span·class="pre">Package</span></code>,·the | 154 | <p>The·package·name·is·included·in·the·control·field·<code·class="docutils·literal·notranslate"><span·class="pre">Package</span></code>,·the |
| 155 | format·of·which·is·described·in·<a·class="reference·internal"·href="ch-controlfields.html#s-f-package"><span·class="std·std-ref">Package</span></a>.·The | 155 | format·of·which·is·described·in·<a·class="reference·internal"·href="ch-controlfields.html#s-f-package"><span·class="std·std-ref">Package</span></a>.·The |
| 156 | package·name·is·also·included·as·a·part·of·the·file·name·of·the·<code·class="docutils·literal·notranslate"><span·class="pre">.deb</span></code> | 156 | package·name·is·also·included·as·a·part·of·the·file·name·of·the·<code·class="docutils·literal·notranslate"><span·class="pre">.deb</span></code> |
| 157 | file.</p> | 157 | file.</p> |
| 158 | <section·id="packages-with-potentially-offensive-content"> | 158 | <section·id="packages-with-potentially-offensive-content"> |
| 159 | <span·id="s3-1-1"></span><h3><span·class="section-number">3.1.1.·</span>Packages·with·potentially·offensive·content<a·class="headerlink"·href="#packages-with-potentially-offensive-content"·title="Link·to·this·heading"></a></h3> | 159 | <span·id="s3-1-1"></span><h3><span·class="section-number">3.1.1.·</span>Packages·with·potentially·offensive·content<a·class="headerlink"·href="#packages-with-potentially-offensive-content"·title="Link·to·this·heading"></a></h3> |
| 160 | <p>As·a·maintainer·you·should·make·a·judgement·about·whether·the·contents | 160 | <p>As·a·maintainer·you·should·make·a·judgement·about·whether·the·contents |
| 161 | of·a·package·is·appropriate·to·include,·whether·it·needs·any·kind·of | 161 | of·a·package·is·appropriate·to·include,·whether·it·needs·any·kind·of |
| 162 | content·warning,·and·whether·some·parts·should·be·split·out·into·a | 162 | content·warning,·and·whether·some·parts·should·be·split·out·into·a |
| 163 | separate·package·(so·that·users·who·want·to·avoid·certain·parts·can·do | 163 | separate·package·(so·that·users·who·want·to·avoid·certain·parts·can·do |
| 164 | so).··In·making·these·decisions·you·should·take·into·account·the | 164 | so).··In·making·these·decisions·you·should·take·into·account·the |
| 165 | project | 165 | project’s·views·as·expressed·in·our·Diversity·Statement.</p> |
| 166 | <p>If·you·split·out·(potentially)·offensive·or·disturbing·material·into·a | 166 | <p>If·you·split·out·(potentially)·offensive·or·disturbing·material·into·a |
| 167 | separate·package,·you·should·usually·mark·this·in·the·package·name·by | 167 | separate·package,·you·should·usually·mark·this·in·the·package·name·by |
| 168 | adding·<code·class="docutils·literal·notranslate"><span·class="pre">-offensive</span></code>.··For·example,·<code·class="docutils·literal·notranslate"><span·class="pre">cowsay</span></code>·vs | 168 | adding·<code·class="docutils·literal·notranslate"><span·class="pre">-offensive</span></code>.··For·example,·<code·class="docutils·literal·notranslate"><span·class="pre">cowsay</span></code>·vs |
| 169 | <code·class="docutils·literal·notranslate"><span·class="pre">cowsay-offensive</span></code>.··In·this·situation·the·<code·class="docutils·literal·notranslate"><span·class="pre">-offensive</span></code>·package | 169 | <code·class="docutils·literal·notranslate"><span·class="pre">cowsay-offensive</span></code>.··In·this·situation·the·<code·class="docutils·literal·notranslate"><span·class="pre">-offensive</span></code>·package |
| 170 | can·be·Suggested·by·the·core·package(s),·but·should·not·be·Recommended | 170 | can·be·Suggested·by·the·core·package(s),·but·should·not·be·Recommended |
| 171 | or·Depended·on.</p> | 171 | or·Depended·on.</p> |
| 172 | </section> | 172 | </section> |
| Offset 183, 17 lines modified | Offset 183, 17 lines modified | ||
| 183 | comparison·is·concerned)·at·the·beginning.</p> | 183 | comparison·is·concerned)·at·the·beginning.</p> |
| 184 | <p>If·an·upstream·package·has·problematic·version·numbers·they·should·be | 184 | <p>If·an·upstream·package·has·problematic·version·numbers·they·should·be |
| 185 | converted·to·a·sane·form·for·use·in·the·<code·class="docutils·literal·notranslate"><span·class="pre">Version</span></code>·field.</p> | 185 | converted·to·a·sane·form·for·use·in·the·<code·class="docutils·literal·notranslate"><span·class="pre">Version</span></code>·field.</p> |
| 186 | <section·id="version-numbers-based-on-dates"> | 186 | <section·id="version-numbers-based-on-dates"> |
| 187 | <span·id="s3-2-1"></span><h3><span·class="section-number">3.2.1.·</span>Version·numbers·based·on·dates<a·class="headerlink"·href="#version-numbers-based-on-dates"·title="Link·to·this·heading"></a></h3> | 187 | <span·id="s3-2-1"></span><h3><span·class="section-number">3.2.1.·</span>Version·numbers·based·on·dates<a·class="headerlink"·href="#version-numbers-based-on-dates"·title="Link·to·this·heading"></a></h3> |
| 188 | <p>In·general,·Debian·packages·should·use·the·same·version·numbers·as·the | 188 | <p>In·general,·Debian·packages·should·use·the·same·version·numbers·as·the |
| 189 | upstream·sources.·However,·upstream·version·numbers·based·on·some·date | 189 | upstream·sources.·However,·upstream·version·numbers·based·on·some·date |
| 190 | formats·(sometimes·used·for·development·or· | 190 | formats·(sometimes·used·for·development·or·“snapshot”·releases)·will·not |
| 191 | be·ordered·correctly·by·the·package·management·software.·For·example, | 191 | be·ordered·correctly·by·the·package·management·software.·For·example, |
| 192 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·will·consider· | 192 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·will·consider·“96May01”·to·be·greater·than·“96Dec24”.</p> |
| 193 | <p>To·prevent·having·to·use·epochs·for·every·new·upstream·version,·the | 193 | <p>To·prevent·having·to·use·epochs·for·every·new·upstream·version,·the |
| 194 | date-based·portion·of·any·upstream·version·number·should·be·given·in·a | 194 | date-based·portion·of·any·upstream·version·number·should·be·given·in·a |
| 195 | way·that·sorts·correctly:·four-digit·year·first,·followed·by·a·two-digit | 195 | way·that·sorts·correctly:·four-digit·year·first,·followed·by·a·two-digit |
| 196 | numeric·month,·followed·by·a·two-digit·numeric·date,·possibly·with | 196 | numeric·month,·followed·by·a·two-digit·numeric·date,·possibly·with |
| 197 | punctuation·between·the·components.</p> | 197 | punctuation·between·the·components.</p> |
| 198 | <p>Native·Debian·packages·(i.e.,·packages·which·have·been·written | 198 | <p>Native·Debian·packages·(i.e.,·packages·which·have·been·written |
| 199 | especially·for·Debian)·whose·version·numbers·include·dates·should·also | 199 | especially·for·Debian)·whose·version·numbers·include·dates·should·also |
| Offset 221, 15 lines modified | Offset 221, 15 lines modified | ||
| 221 | <p>The·reason·for·these·restrictions·is·as·follows.··Epochs·are·not | 221 | <p>The·reason·for·these·restrictions·is·as·follows.··Epochs·are·not |
| 222 | included·in·the·names·of·the·files·that·compose·source·packages,·or·in | 222 | included·in·the·names·of·the·files·that·compose·source·packages,·or·in |
| 223 | the·filenames·of·binary·packages,·so·reusing·a·version·number,·even·if | 223 | the·filenames·of·binary·packages,·so·reusing·a·version·number,·even·if |
| 224 | the·epoch·differs,·results·in·identically·named·files·with·different | 224 | the·epoch·differs,·results·in·identically·named·files·with·different |
| 225 | contents.··This·can·cause·various·problems.</p> | 225 | contents.··This·can·cause·various·problems.</p> |
| 226 | <p>If·you·find·yourself·wanting·to·reuse·the·part·of·a·version·number | 226 | <p>If·you·find·yourself·wanting·to·reuse·the·part·of·a·version·number |
| 227 | after·the·epoch,·you·can·just·increment·the·Debian·revision,·which | 227 | after·the·epoch,·you·can·just·increment·the·Debian·revision,·which |
| 228 | doesn | 228 | doesn’t·need·to·start·at·1·or·be·consecutive.</p> |
| 229 | </section> | 229 | </section> |
| 230 | </section> | 230 | </section> |
| 231 | <section·id="the-maintainer-of-a-package"> | 231 | <section·id="the-maintainer-of-a-package"> |
| 232 | <span·id="s-maintainer"></span><h2><span·class="section-number">3.3.·</span>The·maintainer·of·a·package<a·class="headerlink"·href="#the-maintainer-of-a-package"·title="Link·to·this·heading"></a></h2> | 232 | <span·id="s-maintainer"></span><h2><span·class="section-number">3.3.·</span>The·maintainer·of·a·package<a·class="headerlink"·href="#the-maintainer-of-a-package"·title="Link·to·this·heading"></a></h2> |
| 233 | <p>Every·package·must·have·a·maintainer,·except·for·orphaned·packages·as | 233 | <p>Every·package·must·have·a·maintainer,·except·for·orphaned·packages·as |
| 234 | described·below.·The·maintainer·may·be·one·person·or·a·group·of·people | 234 | described·below.·The·maintainer·may·be·one·person·or·a·group·of·people |
| 235 | reachable·from·a·common·email·address,·such·as·a·mailing·list.·The | 235 | reachable·from·a·common·email·address,·such·as·a·mailing·list.·The |
| Offset 266, 30 lines modified | Offset 266, 30 lines modified | ||
| 266 | <p>Every·Debian·package·must·have·a·<code·class="docutils·literal·notranslate"><span·class="pre">Description</span></code>·control·field·which | 266 | <p>Every·Debian·package·must·have·a·<code·class="docutils·literal·notranslate"><span·class="pre">Description</span></code>·control·field·which |
| 267 | contains·a·synopsis·and·extended·description·of·the·package.·Technical | 267 | contains·a·synopsis·and·extended·description·of·the·package.·Technical |
| 268 | information·about·the·format·of·the·<code·class="docutils·literal·notranslate"><span·class="pre">Description</span></code>·field·is·in | 268 | information·about·the·format·of·the·<code·class="docutils·literal·notranslate"><span·class="pre">Description</span></code>·field·is·in |
| 269 | <a·class="reference·internal"·href="ch-controlfields.html#s-f-description"><span·class="std·std-ref">Description</span></a>.</p> | 269 | <a·class="reference·internal"·href="ch-controlfields.html#s-f-description"><span·class="std·std-ref">Description</span></a>.</p> |
| 270 | <p>The·description·should·describe·the·package·(the·program)·to·a·user | 270 | <p>The·description·should·describe·the·package·(the·program)·to·a·user |
| 271 | (system·administrator)·who·has·never·met·it·before·so·that·they·have | 271 | (system·administrator)·who·has·never·met·it·before·so·that·they·have |
| 272 | enough·information·to·decide·whether·they·want·to·install·it.·This | 272 | enough·information·to·decide·whether·they·want·to·install·it.·This |
| 273 | description·should·not·just·be·copied·verbatim·from·the·program | 273 | description·should·not·just·be·copied·verbatim·from·the·program’s |
| 274 | documentation.</p> | 274 | documentation.</p> |
| 275 | <p>Put·important·information·first,·both·in·the·synopsis·and·extended | 275 | <p>Put·important·information·first,·both·in·the·synopsis·and·extended |
| 276 | description.·Sometimes·only·the·first·part·of·the·synopsis·or·of·the | 276 | description.·Sometimes·only·the·first·part·of·the·synopsis·or·of·the |
| 277 | description·will·be·displayed.·You·can·assume·that·there·will·usually·be | 277 | description·will·be·displayed.·You·can·assume·that·there·will·usually·be |
| 278 | a·way·to·see·the·whole·extended·description.</p> | 278 | a·way·to·see·the·whole·extended·description.</p> |
| 279 | <p>The·description·should·also·give·information·about·the·significant | 279 | <p>The·description·should·also·give·information·about·the·significant |
| 280 | dependencies·and·conflicts·between·this·package·and·others,·so·that·the | 280 | dependencies·and·conflicts·between·this·package·and·others,·so·that·the |
| 281 | user·knows·why·these·dependencies·and·conflicts·have·been·declared.</p> | 281 | user·knows·why·these·dependencies·and·conflicts·have·been·declared.</p> |
| 282 | <p>Instructions·for·configuring·or·using·the·package·should·not·be·included | 282 | <p>Instructions·for·configuring·or·using·the·package·should·not·be·included |
| 283 | (that·is·what·installation·scripts,·manual·pages,·info·files,·etc.,·are | 283 | (that·is·what·installation·scripts,·manual·pages,·info·files,·etc.,·are |
| 284 | for).·Copyright·statements·and·other·administrivia·should·not·be | 284 | for).·Copyright·statements·and·other·administrivia·should·not·be |
| 285 | included·either·(that·is·what·the·copyright·file·is·for).</p> | 285 | included·either·(that·is·what·the·copyright·file·is·for).</p> |
| 286 | <section·id="the-single-line-synopsis"> | 286 | <section·id="the-single-line-synopsis"> |
| 287 | <span·id="s-synopsis"></span><h3><span·class="section-number">3.4.1.·</span>The·single·line·synopsis<a·class="headerlink"·href="#the-single-line-synopsis"·title="Link·to·this·heading"></a></h3> | 287 | <span·id="s-synopsis"></span><h3><span·class="section-number">3.4.1.·</span>The·single·line·synopsis<a·class="headerlink"·href="#the-single-line-synopsis"·title="Link·to·this·heading"></a></h3> |
| 288 | <p>The·single·line·synopsis·should·be·kept·brief | 288 | <p>The·single·line·synopsis·should·be·kept·brief—certainly·under·80 |
| 289 | characters.</p> | 289 | characters.</p> |
| 290 | <p>Do·not·include·the·package·name·in·the·synopsis·line.·The·display | 290 | <p>Do·not·include·the·package·name·in·the·synopsis·line.·The·display |
| 291 | software·knows·how·to·display·this·already,·and·you·do·not·need·to·state | 291 | software·knows·how·to·display·this·already,·and·you·do·not·need·to·state |
| 292 | it.·Remember·that·in·many·situations·the·user·may·only·see·the·synopsis | 292 | it.·Remember·that·in·many·situations·the·user·may·only·see·the·synopsis |
| 293 | line·-·make·it·as·informative·as·you·can.</p> | 293 | line·-·make·it·as·informative·as·you·can.</p> |
| 294 | </section> | 294 | </section> |
| 295 | <section·id="the-extended-description"> | 295 | <section·id="the-extended-description"> |
| Offset 323, 17 lines modified | Offset 323, 17 lines modified | ||
| 323 | about·doing·that·has·been·reached.</p> | 323 | about·doing·that·has·been·reached.</p> |
| 324 | <p>The·format·of·the·package·interrelationship·control·fields·is·described | 324 | <p>The·format·of·the·package·interrelationship·control·fields·is·described |
| 325 | in·<a·class="reference·internal"·href="ch-relationships.html"><span·class="doc">Declaring·relationships·between·packages</span></a>.</p> | 325 | in·<a·class="reference·internal"·href="ch-relationships.html"><span·class="doc">Declaring·relationships·between·packages</span></a>.</p> |
| 326 | </section> | 326 | </section> |
| 327 | <section·id="virtual-packages"> | 327 | <section·id="virtual-packages"> |
| 328 | <span·id="s-virtual-pkg"></span><h2><span·class="section-number">3.6.·</span>Virtual·packages<a·class="headerlink"·href="#virtual-packages"·title="Link·to·this·heading"></a></h2> | 328 | <span·id="s-virtual-pkg"></span><h2><span·class="section-number">3.6.·</span>Virtual·packages<a·class="headerlink"·href="#virtual-packages"·title="Link·to·this·heading"></a></h2> |
| 329 | <p>Sometimes,·there·are·several·packages·which·offer·more-or-less·the·same | 329 | <p>Sometimes,·there·are·several·packages·which·offer·more-or-less·the·same |
| 330 | functionality.·In·this·case,·it | 330 | functionality.·In·this·case,·it’s·useful·to·define·a·<em>virtual·package</em> |
| 331 | whose·name·describes·that·common·functionality.·(The·virtual·packages | 331 | whose·name·describes·that·common·functionality.·(The·virtual·packages |
| 332 | only·exist·logically,·not·physically;·that | 332 | only·exist·logically,·not·physically;·that’s·why·they·are·called |
| 333 | <em>virtual</em>.)·The·packages·with·this·particular·function·will·then | 333 | <em>virtual</em>.)·The·packages·with·this·particular·function·will·then |
| 334 | <em>provide</em>·the·virtual·package.·Thus,·any·other·package·requiring·that | 334 | <em>provide</em>·the·virtual·package.·Thus,·any·other·package·requiring·that |
| 335 | function·can·simply·depend·on·the·virtual·package·without·having·to | 335 | function·can·simply·depend·on·the·virtual·package·without·having·to |
| 336 | specify·all·possible·packages·individually.</p> | 336 | specify·all·possible·packages·individually.</p> |
| 337 | <p>All·packages·should·use·virtual·package·names·where·appropriate,·and | 337 | <p>All·packages·should·use·virtual·package·names·where·appropriate,·and |
| 338 | arrange·to·create·new·ones·if·necessary.·They·should·not·use·virtual | 338 | arrange·to·create·new·ones·if·necessary.·They·should·not·use·virtual |
| 339 | package·names·(except·privately,·amongst·a·cooperating·group·of | 339 | package·names·(except·privately,·amongst·a·cooperating·group·of |
| Offset 356, 15 lines modified | Offset 356, 15 lines modified | ||
| 356 | <code·class="docutils·literal·notranslate"><span·class="pre">required</span></code>·or·<code·class="docutils·literal·notranslate"><span·class="pre">important</span></code>.·Many·of·them·will·be·tagged·<code·class="docutils·literal·notranslate"><span·class="pre">essential</span></code> | 356 | <code·class="docutils·literal·notranslate"><span·class="pre">required</span></code>·or·<code·class="docutils·literal·notranslate"><span·class="pre">important</span></code>.·Many·of·them·will·be·tagged·<code·class="docutils·literal·notranslate"><span·class="pre">essential</span></code> |
| 357 | (see·below).</p> | 357 | (see·below).</p> |
| 358 | </section> | 358 | </section> |
| Max diff block lines reached; 6259/17495 bytes (35.78%) of diff not shown. | |||
| Offset 53, 35 lines modified | Offset 53, 35 lines modified | ||
| 53 | A·.deb·package·contains·two·sets·of·files:·a·set·of·files·to·install·on·the | 53 | A·.deb·package·contains·two·sets·of·files:·a·set·of·files·to·install·on·the |
| 54 | system·when·the·package·is·installed,·and·a·set·of·files·that·provide | 54 | system·when·the·package·is·installed,·and·a·set·of·files·that·provide |
| 55 | additional·metadata·about·the·package·or·which·are·executed·when·the·package·is | 55 | additional·metadata·about·the·package·or·which·are·executed·when·the·package·is |
| 56 | installed·or·removed.·This·second·set·of·files·is·called·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·m\x8me\x8et\x8ta\x8ad\x8da\x8at\x8ta\x8a | 56 | installed·or·removed.·This·second·set·of·files·is·called·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·m\x8me\x8et\x8ta\x8ad\x8da\x8at\x8ta\x8a |
| 57 | f\x8fi\x8il\x8le\x8es\x8s.·Among·those·files·are·the·package·maintainer·scripts·and·control,·the | 57 | f\x8fi\x8il\x8le\x8es\x8s.·Among·those·files·are·the·package·maintainer·scripts·and·control,·the |
| 58 | _\x8b_\x8i_\x8n_\x8a_\x8r_\x8y_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8·_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e·that·contains·the·control·fields·for·the·package. | 58 | _\x8b_\x8i_\x8n_\x8a_\x8r_\x8y_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8·_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e·that·contains·the·control·fields·for·the·package. |
| 59 | Other·package·metadata·files·include·_\x8s_\x8y_\x8m_\x8b_\x8o_\x8l_\x8s·or·_\x8s_\x8h_\x8l_\x8i_\x8b_\x8s·used·to·store·shared | 59 | Other·package·metadata·files·include·_\x8s_\x8y_\x8m_\x8b_\x8o_\x8l_\x8s·or·_\x8s_\x8h_\x8l_\x8i_\x8b_\x8s·used·to·store·shared |
| 60 | library·dependency·information·and·the·conffiles·file·that·lists·the·package | 60 | library·dependency·information·and·the·conffiles·file·that·lists·the·package’s |
| 61 | configuration·files·(described·in·_\x8C_\x8o_\x8n_\x8f_\x8i_\x8g_\x8u_\x8r_\x8a_\x8t_\x8i_\x8o_\x8n_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s). | 61 | configuration·files·(described·in·_\x8C_\x8o_\x8n_\x8f_\x8i_\x8g_\x8u_\x8r_\x8a_\x8t_\x8i_\x8o_\x8n_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s). |
| 62 | There·is·unfortunately·a·collision·of·terminology·here·between·control | 62 | There·is·unfortunately·a·collision·of·terminology·here·between·control |
| 63 | information·files·and·files·in·the·Debian·control·file·format.·Throughout·this | 63 | information·files·and·files·in·the·Debian·control·file·format.·Throughout·this |
| 64 | document,·a·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8e·refers·to·a·file·in·the·Debian·control·file·format. | 64 | document,·a·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8e·refers·to·a·file·in·the·Debian·control·file·format. |
| 65 | These·files·are·documented·in·_\x8C_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s_\x8·_\x8a_\x8n_\x8d_\x8·_\x8t_\x8h_\x8e_\x8i_\x8r_\x8·_\x8f_\x8i_\x8e_\x8l_\x8d_\x8s.·Only·files | 65 | These·files·are·documented·in·_\x8C_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s_\x8·_\x8a_\x8n_\x8d_\x8·_\x8t_\x8h_\x8e_\x8i_\x8r_\x8·_\x8f_\x8i_\x8e_\x8l_\x8d_\x8s.·Only·files |
| 66 | referred·to·specifically·as·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·m\x8me\x8et\x8ta\x8ad\x8da\x8at\x8ta\x8a·f\x8fi\x8il\x8le\x8es\x8s·are·the·files·included·in | 66 | referred·to·specifically·as·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·m\x8me\x8et\x8ta\x8ad\x8da\x8at\x8ta\x8a·f\x8fi\x8il\x8le\x8es\x8s·are·the·files·included·in |
| 67 | the·package·metadata·member·(called·control.tar)·of·the·.deb·file·format·used | 67 | the·package·metadata·member·(called·control.tar)·of·the·.deb·file·format·used |
| 68 | by·binary·packages.·Most·package·metadata·files·are·not·in·the·Debian·control | 68 | by·binary·packages.·Most·package·metadata·files·are·not·in·the·Debian·control |
| 69 | file·format. | 69 | file·format. |
| 70 | *\x8**\x8**\x8**\x8**\x8*·3\x83.\x8.1\x81.\x8.·T\x8Th\x8he\x8e·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·n\x8na\x8am\x8me\x8e_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 70 | *\x8**\x8**\x8**\x8**\x8*·3\x83.\x8.1\x81.\x8.·T\x8Th\x8he\x8e·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·n\x8na\x8am\x8me\x8e_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 71 | Every·package·must·have·a·name·that | 71 | Every·package·must·have·a·name·that’s·unique·within·the·Debian·archive. |
| 72 | The·package·name·is·included·in·the·control·field·Package,·the·format·of·which | 72 | The·package·name·is·included·in·the·control·field·Package,·the·format·of·which |
| 73 | is·described·in·_\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e.·The·package·name·is·also·included·as·a·part·of·the | 73 | is·described·in·_\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e.·The·package·name·is·also·included·as·a·part·of·the |
| 74 | file·name·of·the·.deb·file. | 74 | file·name·of·the·.deb·file. |
| 75 | *\x8**\x8**\x8**\x8*·3\x83.\x8.1\x81.\x8.1\x81.\x8.·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s·w\x8wi\x8it\x8th\x8h·p\x8po\x8ot\x8te\x8en\x8nt\x8ti\x8ia\x8al\x8ll\x8ly\x8y·o\x8of\x8ff\x8fe\x8en\x8ns\x8si\x8iv\x8ve\x8e·c\x8co\x8on\x8nt\x8te\x8en\x8nt\x8t_\x8?\x8·*\x8**\x8**\x8**\x8* | 75 | *\x8**\x8**\x8**\x8*·3\x83.\x8.1\x81.\x8.1\x81.\x8.·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s·w\x8wi\x8it\x8th\x8h·p\x8po\x8ot\x8te\x8en\x8nt\x8ti\x8ia\x8al\x8ll\x8ly\x8y·o\x8of\x8ff\x8fe\x8en\x8ns\x8si\x8iv\x8ve\x8e·c\x8co\x8on\x8nt\x8te\x8en\x8nt\x8t_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 76 | As·a·maintainer·you·should·make·a·judgement·about·whether·the·contents·of·a | 76 | As·a·maintainer·you·should·make·a·judgement·about·whether·the·contents·of·a |
| 77 | package·is·appropriate·to·include,·whether·it·needs·any·kind·of·content | 77 | package·is·appropriate·to·include,·whether·it·needs·any·kind·of·content |
| 78 | warning,·and·whether·some·parts·should·be·split·out·into·a·separate·package·(so | 78 | warning,·and·whether·some·parts·should·be·split·out·into·a·separate·package·(so |
| 79 | that·users·who·want·to·avoid·certain·parts·can·do·so).·In·making·these | 79 | that·users·who·want·to·avoid·certain·parts·can·do·so).·In·making·these |
| 80 | decisions·you·should·take·into·account·the·project | 80 | decisions·you·should·take·into·account·the·project’s·views·as·expressed·in·our |
| 81 | Diversity·Statement. | 81 | Diversity·Statement. |
| 82 | If·you·split·out·(potentially)·offensive·or·disturbing·material·into·a·separate | 82 | If·you·split·out·(potentially)·offensive·or·disturbing·material·into·a·separate |
| 83 | package,·you·should·usually·mark·this·in·the·package·name·by·adding·-offensive. | 83 | package,·you·should·usually·mark·this·in·the·package·name·by·adding·-offensive. |
| 84 | For·example,·cowsay·vs·cowsay-offensive.·In·this·situation·the·-offensive | 84 | For·example,·cowsay·vs·cowsay-offensive.·In·this·situation·the·-offensive |
| 85 | package·can·be·Suggested·by·the·core·package(s),·but·should·not·be·Recommended | 85 | package·can·be·Suggested·by·the·core·package(s),·but·should·not·be·Recommended |
| 86 | or·Depended·on. | 86 | or·Depended·on. |
| 87 | *\x8**\x8**\x8**\x8**\x8*·3\x83.\x8.2\x82.\x8.·T\x8Th\x8he\x8e·v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·o\x8of\x8f·a\x8a·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 87 | *\x8**\x8**\x8**\x8**\x8*·3\x83.\x8.2\x82.\x8.·T\x8Th\x8he\x8e·v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·o\x8of\x8f·a\x8a·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| Offset 93, 17 lines modified | Offset 93, 17 lines modified | ||
| 93 | newer·than·the·one·installed·on·the·system.·The·version·number·format·has·the | 93 | newer·than·the·one·installed·on·the·system.·The·version·number·format·has·the |
| 94 | most·significant·parts·(as·far·as·comparison·is·concerned)·at·the·beginning. | 94 | most·significant·parts·(as·far·as·comparison·is·concerned)·at·the·beginning. |
| 95 | If·an·upstream·package·has·problematic·version·numbers·they·should·be·converted | 95 | If·an·upstream·package·has·problematic·version·numbers·they·should·be·converted |
| 96 | to·a·sane·form·for·use·in·the·Version·field. | 96 | to·a·sane·form·for·use·in·the·Version·field. |
| 97 | *\x8**\x8**\x8**\x8*·3\x83.\x8.2\x82.\x8.1\x81.\x8.·V\x8Ve\x8er\x8rs\x8si\x8io\x8on\x8n·n\x8nu\x8um\x8mb\x8be\x8er\x8rs\x8s·b\x8ba\x8as\x8se\x8ed\x8d·o\x8on\x8n·d\x8da\x8at\x8te\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 97 | *\x8**\x8**\x8**\x8*·3\x83.\x8.2\x82.\x8.1\x81.\x8.·V\x8Ve\x8er\x8rs\x8si\x8io\x8on\x8n·n\x8nu\x8um\x8mb\x8be\x8er\x8rs\x8s·b\x8ba\x8as\x8se\x8ed\x8d·o\x8on\x8n·d\x8da\x8at\x8te\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 98 | In·general,·Debian·packages·should·use·the·same·version·numbers·as·the·upstream | 98 | In·general,·Debian·packages·should·use·the·same·version·numbers·as·the·upstream |
| 99 | sources.·However,·upstream·version·numbers·based·on·some·date·formats | 99 | sources.·However,·upstream·version·numbers·based·on·some·date·formats |
| 100 | (sometimes·used·for·development·or· | 100 | (sometimes·used·for·development·or·“snapshot”·releases)·will·not·be·ordered |
| 101 | correctly·by·the·package·management·software.·For·example,·dpkg·will·consider | 101 | correctly·by·the·package·management·software.·For·example,·dpkg·will·consider |
| 102 | 102 | “96May01”·to·be·greater·than·“96Dec24”. | |
| 103 | To·prevent·having·to·use·epochs·for·every·new·upstream·version,·the·date-based | 103 | To·prevent·having·to·use·epochs·for·every·new·upstream·version,·the·date-based |
| 104 | portion·of·any·upstream·version·number·should·be·given·in·a·way·that·sorts | 104 | portion·of·any·upstream·version·number·should·be·given·in·a·way·that·sorts |
| 105 | correctly:·four-digit·year·first,·followed·by·a·two-digit·numeric·month, | 105 | correctly:·four-digit·year·first,·followed·by·a·two-digit·numeric·month, |
| 106 | followed·by·a·two-digit·numeric·date,·possibly·with·punctuation·between·the | 106 | followed·by·a·two-digit·numeric·date,·possibly·with·punctuation·between·the |
| 107 | components. | 107 | components. |
| 108 | Native·Debian·packages·(i.e.,·packages·which·have·been·written·especially·for | 108 | Native·Debian·packages·(i.e.,·packages·which·have·been·written·especially·for |
| 109 | Debian)·whose·version·numbers·include·dates·should·also·follow·these·rules.·If | 109 | Debian)·whose·version·numbers·include·dates·should·also·follow·these·rules.·If |
| Offset 126, 15 lines modified | Offset 126, 15 lines modified | ||
| 126 | contents·(see·_\x8F_\x8i_\x8l_\x8e_\x8s). | 126 | contents·(see·_\x8F_\x8i_\x8l_\x8e_\x8s). |
| 127 | The·reason·for·these·restrictions·is·as·follows.·Epochs·are·not·included·in·the | 127 | The·reason·for·these·restrictions·is·as·follows.·Epochs·are·not·included·in·the |
| 128 | names·of·the·files·that·compose·source·packages,·or·in·the·filenames·of·binary | 128 | names·of·the·files·that·compose·source·packages,·or·in·the·filenames·of·binary |
| 129 | packages,·so·reusing·a·version·number,·even·if·the·epoch·differs,·results·in | 129 | packages,·so·reusing·a·version·number,·even·if·the·epoch·differs,·results·in |
| 130 | identically·named·files·with·different·contents.·This·can·cause·various | 130 | identically·named·files·with·different·contents.·This·can·cause·various |
| 131 | problems. | 131 | problems. |
| 132 | If·you·find·yourself·wanting·to·reuse·the·part·of·a·version·number·after·the | 132 | If·you·find·yourself·wanting·to·reuse·the·part·of·a·version·number·after·the |
| 133 | epoch,·you·can·just·increment·the·Debian·revision,·which·doesn | 133 | epoch,·you·can·just·increment·the·Debian·revision,·which·doesn’t·need·to·start |
| 134 | at·1·or·be·consecutive. | 134 | at·1·or·be·consecutive. |
| 135 | *\x8**\x8**\x8**\x8**\x8*·3\x83.\x8.3\x83.\x8.·T\x8Th\x8he\x8e·m\x8ma\x8ai\x8in\x8nt\x8ta\x8ai\x8in\x8ne\x8er\x8r·o\x8of\x8f·a\x8a·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 135 | *\x8**\x8**\x8**\x8**\x8*·3\x83.\x8.3\x83.\x8.·T\x8Th\x8he\x8e·m\x8ma\x8ai\x8in\x8nt\x8ta\x8ai\x8in\x8ne\x8er\x8r·o\x8of\x8f·a\x8a·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 136 | Every·package·must·have·a·maintainer,·except·for·orphaned·packages·as·described | 136 | Every·package·must·have·a·maintainer,·except·for·orphaned·packages·as·described |
| 137 | below.·The·maintainer·may·be·one·person·or·a·group·of·people·reachable·from·a | 137 | below.·The·maintainer·may·be·one·person·or·a·group·of·people·reachable·from·a |
| 138 | common·email·address,·such·as·a·mailing·list.·The·maintainer·is·responsible·for | 138 | common·email·address,·such·as·a·mailing·list.·The·maintainer·is·responsible·for |
| 139 | maintaining·the·Debian·packaging·files,·evaluating·and·responding·appropriately | 139 | maintaining·the·Debian·packaging·files,·evaluating·and·responding·appropriately |
| 140 | to·reported·bugs,·uploading·new·versions·of·the·package·(either·directly·or | 140 | to·reported·bugs,·uploading·new·versions·of·the·package·(either·directly·or |
| Offset 164, 28 lines modified | Offset 164, 28 lines modified | ||
| 164 | *\x8**\x8**\x8**\x8**\x8*·3\x83.\x8.4\x84.\x8.·T\x8Th\x8he\x8e·d\x8de\x8es\x8sc\x8cr\x8ri\x8ip\x8pt\x8ti\x8io\x8on\x8n·o\x8of\x8f·a\x8a·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 164 | *\x8**\x8**\x8**\x8**\x8*·3\x83.\x8.4\x84.\x8.·T\x8Th\x8he\x8e·d\x8de\x8es\x8sc\x8cr\x8ri\x8ip\x8pt\x8ti\x8io\x8on\x8n·o\x8of\x8f·a\x8a·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 165 | Every·Debian·package·must·have·a·Description·control·field·which·contains·a | 165 | Every·Debian·package·must·have·a·Description·control·field·which·contains·a |
| 166 | synopsis·and·extended·description·of·the·package.·Technical·information·about | 166 | synopsis·and·extended·description·of·the·package.·Technical·information·about |
| 167 | the·format·of·the·Description·field·is·in·_\x8D_\x8e_\x8s_\x8c_\x8r_\x8i_\x8p_\x8t_\x8i_\x8o_\x8n. | 167 | the·format·of·the·Description·field·is·in·_\x8D_\x8e_\x8s_\x8c_\x8r_\x8i_\x8p_\x8t_\x8i_\x8o_\x8n. |
| 168 | The·description·should·describe·the·package·(the·program)·to·a·user·(system | 168 | The·description·should·describe·the·package·(the·program)·to·a·user·(system |
| 169 | administrator)·who·has·never·met·it·before·so·that·they·have·enough·information | 169 | administrator)·who·has·never·met·it·before·so·that·they·have·enough·information |
| 170 | to·decide·whether·they·want·to·install·it.·This·description·should·not·just·be | 170 | to·decide·whether·they·want·to·install·it.·This·description·should·not·just·be |
| 171 | copied·verbatim·from·the·program | 171 | copied·verbatim·from·the·program’s·documentation. |
| 172 | Put·important·information·first,·both·in·the·synopsis·and·extended·description. | 172 | Put·important·information·first,·both·in·the·synopsis·and·extended·description. |
| 173 | Sometimes·only·the·first·part·of·the·synopsis·or·of·the·description·will·be | 173 | Sometimes·only·the·first·part·of·the·synopsis·or·of·the·description·will·be |
| 174 | displayed.·You·can·assume·that·there·will·usually·be·a·way·to·see·the·whole | 174 | displayed.·You·can·assume·that·there·will·usually·be·a·way·to·see·the·whole |
| 175 | extended·description. | 175 | extended·description. |
| 176 | The·description·should·also·give·information·about·the·significant·dependencies | 176 | The·description·should·also·give·information·about·the·significant·dependencies |
| 177 | and·conflicts·between·this·package·and·others,·so·that·the·user·knows·why·these | 177 | and·conflicts·between·this·package·and·others,·so·that·the·user·knows·why·these |
| 178 | dependencies·and·conflicts·have·been·declared. | 178 | dependencies·and·conflicts·have·been·declared. |
| 179 | Instructions·for·configuring·or·using·the·package·should·not·be·included·(that | 179 | Instructions·for·configuring·or·using·the·package·should·not·be·included·(that |
| 180 | is·what·installation·scripts,·manual·pages,·info·files,·etc.,·are·for). | 180 | is·what·installation·scripts,·manual·pages,·info·files,·etc.,·are·for). |
| 181 | Copyright·statements·and·other·administrivia·should·not·be·included·either | 181 | Copyright·statements·and·other·administrivia·should·not·be·included·either |
| 182 | (that·is·what·the·copyright·file·is·for). | 182 | (that·is·what·the·copyright·file·is·for). |
| 183 | *\x8**\x8**\x8**\x8*·3\x83.\x8.4\x84.\x8.1\x81.\x8.·T\x8Th\x8he\x8e·s\x8si\x8in\x8ng\x8gl\x8le\x8e·l\x8li\x8in\x8ne\x8e·s\x8sy\x8yn\x8no\x8op\x8ps\x8si\x8is\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 183 | *\x8**\x8**\x8**\x8*·3\x83.\x8.4\x84.\x8.1\x81.\x8.·T\x8Th\x8he\x8e·s\x8si\x8in\x8ng\x8gl\x8le\x8e·l\x8li\x8in\x8ne\x8e·s\x8sy\x8yn\x8no\x8op\x8ps\x8si\x8is\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 184 | The·single·line·synopsis·should·be·kept·brief | 184 | The·single·line·synopsis·should·be·kept·brief—certainly·under·80·characters. |
| 185 | Do·not·include·the·package·name·in·the·synopsis·line.·The·display·software | 185 | Do·not·include·the·package·name·in·the·synopsis·line.·The·display·software |
| 186 | knows·how·to·display·this·already,·and·you·do·not·need·to·state·it.·Remember | 186 | knows·how·to·display·this·already,·and·you·do·not·need·to·state·it.·Remember |
| 187 | that·in·many·situations·the·user·may·only·see·the·synopsis·line·-·make·it·as | 187 | that·in·many·situations·the·user·may·only·see·the·synopsis·line·-·make·it·as |
| 188 | informative·as·you·can. | 188 | informative·as·you·can. |
| 189 | *\x8**\x8**\x8**\x8*·3\x83.\x8.4\x84.\x8.2\x82.\x8.·T\x8Th\x8he\x8e·e\x8ex\x8xt\x8te\x8en\x8nd\x8de\x8ed\x8d·d\x8de\x8es\x8sc\x8cr\x8ri\x8ip\x8pt\x8ti\x8io\x8on\x8n_\x8?\x8·*\x8**\x8**\x8**\x8* | 189 | *\x8**\x8**\x8**\x8*·3\x83.\x8.4\x84.\x8.2\x82.\x8.·T\x8Th\x8he\x8e·e\x8ex\x8xt\x8te\x8en\x8nd\x8de\x8ed\x8d·d\x8de\x8es\x8sc\x8cr\x8ri\x8ip\x8pt\x8ti\x8io\x8on\x8n_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 190 | Do·not·try·to·continue·the·single·line·synopsis·into·the·extended·description. | 190 | Do·not·try·to·continue·the·single·line·synopsis·into·the·extended·description. |
| 191 | This·will·not·work·correctly·when·the·full·description·is·displayed,·and·makes | 191 | This·will·not·work·correctly·when·the·full·description·is·displayed,·and·makes |
| Offset 209, 17 lines modified | Offset 209, 17 lines modified | ||
| 209 | You·should·not·specify·a·Pre-Depends·entry·for·a·package·before·this·has·been | 209 | You·should·not·specify·a·Pre-Depends·entry·for·a·package·before·this·has·been |
| 210 | discussed·on·the·debian-devel·mailing·list·and·a·consensus·about·doing·that·has | 210 | discussed·on·the·debian-devel·mailing·list·and·a·consensus·about·doing·that·has |
| 211 | been·reached. | 211 | been·reached. |
| 212 | The·format·of·the·package·interrelationship·control·fields·is·described·in | 212 | The·format·of·the·package·interrelationship·control·fields·is·described·in |
| 213 | _\x8D_\x8e_\x8c_\x8l_\x8a_\x8r_\x8i_\x8n_\x8g_\x8·_\x8r_\x8e_\x8l_\x8a_\x8t_\x8i_\x8o_\x8n_\x8s_\x8h_\x8i_\x8p_\x8s_\x8·_\x8b_\x8e_\x8t_\x8w_\x8e_\x8e_\x8n_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8s. | 213 | _\x8D_\x8e_\x8c_\x8l_\x8a_\x8r_\x8i_\x8n_\x8g_\x8·_\x8r_\x8e_\x8l_\x8a_\x8t_\x8i_\x8o_\x8n_\x8s_\x8h_\x8i_\x8p_\x8s_\x8·_\x8b_\x8e_\x8t_\x8w_\x8e_\x8e_\x8n_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8s. |
| 214 | *\x8**\x8**\x8**\x8**\x8*·3\x83.\x8.6\x86.\x8.·V\x8Vi\x8ir\x8rt\x8tu\x8ua\x8al\x8l·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 214 | *\x8**\x8**\x8**\x8**\x8*·3\x83.\x8.6\x86.\x8.·V\x8Vi\x8ir\x8rt\x8tu\x8ua\x8al\x8l·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 215 | Sometimes,·there·are·several·packages·which·offer·more-or-less·the·same | 215 | Sometimes,·there·are·several·packages·which·offer·more-or-less·the·same |
| 216 | functionality.·In·this·case,·it | 216 | functionality.·In·this·case,·it’s·useful·to·define·a·v\x8vi\x8ir\x8rt\x8tu\x8ua\x8al\x8l·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·whose·name |
| 217 | describes·that·common·functionality.·(The·virtual·packages·only·exist | 217 | describes·that·common·functionality.·(The·virtual·packages·only·exist |
| 218 | logically,·not·physically;·that | 218 | logically,·not·physically;·that’s·why·they·are·called·v\x8vi\x8ir\x8rt\x8tu\x8ua\x8al\x8l.)·The·packages |
| 219 | with·this·particular·function·will·then·p\x8pr\x8ro\x8ov\x8vi\x8id\x8de\x8e·the·virtual·package.·Thus,·any | 219 | with·this·particular·function·will·then·p\x8pr\x8ro\x8ov\x8vi\x8id\x8de\x8e·the·virtual·package.·Thus,·any |
| 220 | other·package·requiring·that·function·can·simply·depend·on·the·virtual·package | 220 | other·package·requiring·that·function·can·simply·depend·on·the·virtual·package |
| 221 | without·having·to·specify·all·possible·packages·individually. | 221 | without·having·to·specify·all·possible·packages·individually. |
| 222 | All·packages·should·use·virtual·package·names·where·appropriate,·and·arrange·to | 222 | All·packages·should·use·virtual·package·names·where·appropriate,·and·arrange·to |
| 223 | create·new·ones·if·necessary.·They·should·not·use·virtual·package·names·(except | 223 | create·new·ones·if·necessary.·They·should·not·use·virtual·package·names·(except |
| 224 | privately,·amongst·a·cooperating·group·of·packages)·unless·they·have·been | 224 | privately,·amongst·a·cooperating·group·of·packages)·unless·they·have·been |
| 225 | agreed·upon·and·appear·in·the·list·of·virtual·package·names.·(See·also·_\x8V_\x8i_\x8r_\x8t_\x8u_\x8a_\x8l | 225 | agreed·upon·and·appear·in·the·list·of·virtual·package·names.·(See·also·_\x8V_\x8i_\x8r_\x8t_\x8u_\x8a_\x8l |
| Offset 234, 15 lines modified | Offset 234, 15 lines modified | ||
| 234 | before·everything·else·on·a·new·system.·Only·very·few·packages·are·allowed·to | 234 | before·everything·else·on·a·new·system.·Only·very·few·packages·are·allowed·to |
| 235 | form·part·of·the·base·system,·in·order·to·keep·the·required·disk·usage·very | 235 | form·part·of·the·base·system,·in·order·to·keep·the·required·disk·usage·very |
| 236 | small. | 236 | small. |
| 237 | The·base·system·consists·of·all·those·packages·with·priority·required·or | 237 | The·base·system·consists·of·all·those·packages·with·priority·required·or |
| 238 | important.·Many·of·them·will·be·tagged·essential·(see·below). | 238 | important.·Many·of·them·will·be·tagged·essential·(see·below). |
| 239 | *\x8**\x8**\x8**\x8**\x8*·3\x83.\x8.8\x88.\x8.·E\x8Es\x8ss\x8se\x8en\x8nt\x8ti\x8ia\x8al\x8l·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 239 | *\x8**\x8**\x8**\x8**\x8*·3\x83.\x8.8\x88.\x8.·E\x8Es\x8ss\x8se\x8en\x8nt\x8ti\x8ia\x8al\x8l·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 240 | Essential·is·defined·as·the·minimal·set·of·functionality·that·must·be·available | 240 | Essential·is·defined·as·the·minimal·set·of·functionality·that·must·be·available |
| 241 | and·usable·on·the·system·at·all·times,·even·when·packages·are·in·the· | 241 | and·usable·on·the·system·at·all·times,·even·when·packages·are·in·the·“Unpacked” |
| 242 | state.·Packages·are·tagged·essential·for·a·system·using·the·Essential·control | 242 | state.·Packages·are·tagged·essential·for·a·system·using·the·Essential·control |
| 243 | field.·The·format·of·the·Essential·control·field·is·described·in·_\x8E_\x8s_\x8s_\x8e_\x8n_\x8t_\x8i_\x8a_\x8l. | 243 | field.·The·format·of·the·Essential·control·field·is·described·in·_\x8E_\x8s_\x8s_\x8e_\x8n_\x8t_\x8i_\x8a_\x8l. |
| Max diff block lines reached; 3144/13657 bytes (23.02%) of diff not shown. | |||
| Offset 225, 15 lines modified | Offset 225, 15 lines modified | ||
| 225 | <p>Lines·starting·with·U+0023·(<code·class="docutils·literal·notranslate"><span·class="pre">#</span></code>),·without·any·preceding·whitespace, | 225 | <p>Lines·starting·with·U+0023·(<code·class="docutils·literal·notranslate"><span·class="pre">#</span></code>),·without·any·preceding·whitespace, |
| 226 | are·comment·lines·that·are·only·permitted·in·source·package·control | 226 | are·comment·lines·that·are·only·permitted·in·source·package·control |
| 227 | files·(<code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code>).·These·comment·lines·are·ignored,·even | 227 | files·(<code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code>).·These·comment·lines·are·ignored,·even |
| 228 | between·two·continuation·lines.·They·do·not·end·logical·lines.</p> | 228 | between·two·continuation·lines.·They·do·not·end·logical·lines.</p> |
| 229 | <p>All·control·files·must·be·encoded·in·UTF-8.</p> | 229 | <p>All·control·files·must·be·encoded·in·UTF-8.</p> |
| 230 | </section> | 230 | </section> |
| 231 | <section·id="debian-source-package-template-control-files-debian-control"> | 231 | <section·id="debian-source-package-template-control-files-debian-control"> |
| 232 | <span·id="s-sourcecontrolfiles"></span><h2><span·class="section-number">5.2.·</span>Debian·source·package·template·control·files· | 232 | <span·id="s-sourcecontrolfiles"></span><h2><span·class="section-number">5.2.·</span>Debian·source·package·template·control·files·–·<code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code><a·class="headerlink"·href="#debian-source-package-template-control-files-debian-control"·title="Link·to·this·heading"></a></h2> |
| 233 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code>·file·contains·the·most·vital·(and | 233 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code>·file·contains·the·most·vital·(and |
| 234 | version-independent)·information·about·the·source·package·and·about·the | 234 | version-independent)·information·about·the·source·package·and·about·the |
| 235 | binary·packages·it·creates.</p> | 235 | binary·packages·it·creates.</p> |
| 236 | <p>The·first·stanza·of·the·control·file·contains·information·about·the | 236 | <p>The·first·stanza·of·the·control·file·contains·information·about·the |
| 237 | source·package·in·general.·The·subsequent·stanzas·each·describe·a | 237 | source·package·in·general.·The·subsequent·stanzas·each·describe·a |
| 238 | binary·package·that·the·source·tree·builds.·Each·binary·package·built | 238 | binary·package·that·the·source·tree·builds.·Each·binary·package·built |
| 239 | from·this·source·package·has·a·corresponding·stanza,·except·for·any | 239 | from·this·source·package·has·a·corresponding·stanza,·except·for·any |
| Offset 277, 15 lines modified | Offset 277, 15 lines modified | ||
| 277 | fields.</p> | 277 | fields.</p> |
| 278 | <p>The·fields·here·may·contain·variable·references·-·their·values·will·be | 278 | <p>The·fields·here·may·contain·variable·references·-·their·values·will·be |
| 279 | substituted·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-gencontrol</span></code>,·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-genchanges</span></code>·or | 279 | substituted·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-gencontrol</span></code>,·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-genchanges</span></code>·or |
| 280 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg-source</span></code>·when·they·generate·output·control·files.·See | 280 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg-source</span></code>·when·they·generate·output·control·files.·See |
| 281 | <a·class="reference·internal"·href="ch-source.html#s-substvars"><span·class="std·std-ref">Variable·substitutions:·debian/substvars</span></a>·for·details.</p> | 281 | <a·class="reference·internal"·href="ch-source.html#s-substvars"><span·class="std·std-ref">Variable·substitutions:·debian/substvars</span></a>·for·details.</p> |
| 282 | </section> | 282 | </section> |
| 283 | <section·id="debian-binary-package-control-files-debian-control"> | 283 | <section·id="debian-binary-package-control-files-debian-control"> |
| 284 | <span·id="s-binarycontrolfiles"></span><h2><span·class="section-number">5.3.·</span>Debian·binary·package·control·files· | 284 | <span·id="s-binarycontrolfiles"></span><h2><span·class="section-number">5.3.·</span>Debian·binary·package·control·files·–·<code·class="docutils·literal·notranslate"><span·class="pre">DEBIAN/control</span></code><a·class="headerlink"·href="#debian-binary-package-control-files-debian-control"·title="Link·to·this·heading"></a></h2> |
| 285 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">DEBIAN/control</span></code>·file·contains·the·most·vital·(and | 285 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">DEBIAN/control</span></code>·file·contains·the·most·vital·(and |
| 286 | version-dependent)·information·about·a·binary·package.·It·consists·of·a | 286 | version-dependent)·information·about·a·binary·package.·It·consists·of·a |
| 287 | single·stanza.</p> | 287 | single·stanza.</p> |
| 288 | <p>The·fields·in·this·file·are:</p> | 288 | <p>The·fields·in·this·file·are:</p> |
| 289 | <ul·class="simple"> | 289 | <ul·class="simple"> |
| 290 | <li><p><a·class="reference·internal"·href="#s-f-package"><span·class="std·std-ref">Package</span></a>·(mandatory)</p></li> | 290 | <li><p><a·class="reference·internal"·href="#s-f-package"><span·class="std·std-ref">Package</span></a>·(mandatory)</p></li> |
| 291 | <li><p><a·class="reference·internal"·href="#s-f-source"><span·class="std·std-ref">Source</span></a></p></li> | 291 | <li><p><a·class="reference·internal"·href="#s-f-source"><span·class="std·std-ref">Source</span></a></p></li> |
| Offset 299, 15 lines modified | Offset 299, 15 lines modified | ||
| 299 | <li><p><a·class="reference·internal"·href="#s-f-maintainer"><span·class="std·std-ref">Maintainer</span></a>·(mandatory)</p></li> | 299 | <li><p><a·class="reference·internal"·href="#s-f-maintainer"><span·class="std·std-ref">Maintainer</span></a>·(mandatory)</p></li> |
| 300 | <li><p><a·class="reference·internal"·href="#s-f-description"><span·class="std·std-ref">Description</span></a>·(mandatory)</p></li> | 300 | <li><p><a·class="reference·internal"·href="#s-f-description"><span·class="std·std-ref">Description</span></a>·(mandatory)</p></li> |
| 301 | <li><p><a·class="reference·internal"·href="#s-f-homepage"><span·class="std·std-ref">Homepage</span></a></p></li> | 301 | <li><p><a·class="reference·internal"·href="#s-f-homepage"><span·class="std·std-ref">Homepage</span></a></p></li> |
| 302 | <li><p><a·class="reference·internal"·href="ch-relationships.html#s-built-using"><span·class="std·std-ref">Built-Using</span></a></p></li> | 302 | <li><p><a·class="reference·internal"·href="ch-relationships.html#s-built-using"><span·class="std·std-ref">Built-Using</span></a></p></li> |
| 303 | </ul> | 303 | </ul> |
| 304 | </section> | 304 | </section> |
| 305 | <section·id="debian-source-package-control-files-dsc"> | 305 | <section·id="debian-source-package-control-files-dsc"> |
| 306 | <span·id="s-debiansourcecontrolfiles"></span><h2><span·class="section-number">5.4.·</span>Debian·source·package·control·files· | 306 | <span·id="s-debiansourcecontrolfiles"></span><h2><span·class="section-number">5.4.·</span>Debian·source·package·control·files·–·<code·class="docutils·literal·notranslate"><span·class="pre">.dsc</span></code><a·class="headerlink"·href="#debian-source-package-control-files-dsc"·title="Link·to·this·heading"></a></h2> |
| 307 | <p>This·file·consists·of·a·single·stanza,·possibly·surrounded·by·an·OpenPGP | 307 | <p>This·file·consists·of·a·single·stanza,·possibly·surrounded·by·an·OpenPGP |
| 308 | signature.·The·fields·of·that·stanza·are·listed·below.·Their·syntax | 308 | signature.·The·fields·of·that·stanza·are·listed·below.·Their·syntax |
| 309 | is·described·above,·in·<a·class="reference·internal"·href="#s-controlsyntax"><span·class="std·std-ref">Syntax·of·control·files</span></a>.</p> | 309 | is·described·above,·in·<a·class="reference·internal"·href="#s-controlsyntax"><span·class="std·std-ref">Syntax·of·control·files</span></a>.</p> |
| 310 | <ul·class="simple"> | 310 | <ul·class="simple"> |
| 311 | <li><p><a·class="reference·internal"·href="#s-f-format"><span·class="std·std-ref">Format</span></a>·(mandatory)</p></li> | 311 | <li><p><a·class="reference·internal"·href="#s-f-format"><span·class="std·std-ref">Format</span></a>·(mandatory)</p></li> |
| 312 | <li><p><a·class="reference·internal"·href="#s-f-source"><span·class="std·std-ref">Source</span></a>·(mandatory)</p></li> | 312 | <li><p><a·class="reference·internal"·href="#s-f-source"><span·class="std·std-ref">Source</span></a>·(mandatory)</p></li> |
| 313 | <li><p><a·class="reference·internal"·href="#s-f-binary"><span·class="std·std-ref">Binary</span></a></p></li> | 313 | <li><p><a·class="reference·internal"·href="#s-f-binary"><span·class="std·std-ref">Binary</span></a></p></li> |
| Offset 328, 15 lines modified | Offset 328, 15 lines modified | ||
| 328 | </ul> | 328 | </ul> |
| 329 | <p>The·Debian·source·package·control·file·is·generated·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-source</span></code>·when·it | 329 | <p>The·Debian·source·package·control·file·is·generated·by·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg-source</span></code>·when·it |
| 330 | builds·the·source·archive,·from·other·files·in·the·source·package, | 330 | builds·the·source·archive,·from·other·files·in·the·source·package, |
| 331 | described·above.·When·unpacking,·it·is·checked·against·the·files·and | 331 | described·above.·When·unpacking,·it·is·checked·against·the·files·and |
| 332 | directories·in·the·other·parts·of·the·source·package.</p> | 332 | directories·in·the·other·parts·of·the·source·package.</p> |
| 333 | </section> | 333 | </section> |
| 334 | <section·id="debian-upload-changes-control-files-changes"> | 334 | <section·id="debian-upload-changes-control-files-changes"> |
| 335 | <span·id="s-debianchangesfiles"></span><h2><span·class="section-number">5.5.·</span>Debian·upload·changes·control·files· | 335 | <span·id="s-debianchangesfiles"></span><h2><span·class="section-number">5.5.·</span>Debian·upload·changes·control·files·–·<code·class="docutils·literal·notranslate"><span·class="pre">.changes</span></code><a·class="headerlink"·href="#debian-upload-changes-control-files-changes"·title="Link·to·this·heading"></a></h2> |
| 336 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">.changes</span></code>·files·are·used·by·the·Debian·archive·maintenance | 336 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">.changes</span></code>·files·are·used·by·the·Debian·archive·maintenance |
| 337 | software·to·process·updates·to·packages.·They·consist·of·a·single | 337 | software·to·process·updates·to·packages.·They·consist·of·a·single |
| 338 | stanza,·possibly·surrounded·by·an·OpenPGP·signature.·That·stanza | 338 | stanza,·possibly·surrounded·by·an·OpenPGP·signature.·That·stanza |
| 339 | contains·information·from·the·<code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code>·file·and·other·data | 339 | contains·information·from·the·<code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code>·file·and·other·data |
| 340 | about·the·source·package·gathered·via·<code·class="docutils·literal·notranslate"><span·class="pre">debian/changelog</span></code>·and | 340 | about·the·source·package·gathered·via·<code·class="docutils·literal·notranslate"><span·class="pre">debian/changelog</span></code>·and |
| 341 | <code·class="docutils·literal·notranslate"><span·class="pre">debian/rules</span></code>.</p> | 341 | <code·class="docutils·literal·notranslate"><span·class="pre">debian/rules</span></code>.</p> |
| 342 | <p><code·class="docutils·literal·notranslate"><span·class="pre">.changes</span></code>·files·have·a·format·version·that·is·incremented·whenever | 342 | <p><code·class="docutils·literal·notranslate"><span·class="pre">.changes</span></code>·files·have·a·format·version·that·is·incremented·whenever |
| Offset 380, 18 lines modified | Offset 380, 18 lines modified | ||
| 380 | <a·class="reference·internal"·href="#s-f-package"><span·class="std·std-ref">Package</span></a>)·must·consist·only·of·lower·case | 380 | <a·class="reference·internal"·href="#s-f-package"><span·class="std·std-ref">Package</span></a>)·must·consist·only·of·lower·case |
| 381 | letters·(<code·class="docutils·literal·notranslate"><span·class="pre">a-z</span></code>),·digits·(<code·class="docutils·literal·notranslate"><span·class="pre">0-9</span></code>),·plus·(<code·class="docutils·literal·notranslate"><span·class="pre">+</span></code>)·and·minus·(<code·class="docutils·literal·notranslate"><span·class="pre">-</span></code>) | 381 | letters·(<code·class="docutils·literal·notranslate"><span·class="pre">a-z</span></code>),·digits·(<code·class="docutils·literal·notranslate"><span·class="pre">0-9</span></code>),·plus·(<code·class="docutils·literal·notranslate"><span·class="pre">+</span></code>)·and·minus·(<code·class="docutils·literal·notranslate"><span·class="pre">-</span></code>) |
| 382 | signs,·and·periods·(<code·class="docutils·literal·notranslate"><span·class="pre">.</span></code>).·They·must·be·at·least·two·characters·long | 382 | signs,·and·periods·(<code·class="docutils·literal·notranslate"><span·class="pre">.</span></code>).·They·must·be·at·least·two·characters·long |
| 383 | and·must·start·with·an·alphanumeric·character.</p> | 383 | and·must·start·with·an·alphanumeric·character.</p> |
| 384 | </section> | 384 | </section> |
| 385 | <section·id="maintainer"> | 385 | <section·id="maintainer"> |
| 386 | <span·id="s-f-maintainer"></span><h3><span·class="section-number">5.6.2.·</span><code·class="docutils·literal·notranslate"><span·class="pre">Maintainer</span></code><a·class="headerlink"·href="#maintainer"·title="Link·to·this·heading"></a></h3> | 386 | <span·id="s-f-maintainer"></span><h3><span·class="section-number">5.6.2.·</span><code·class="docutils·literal·notranslate"><span·class="pre">Maintainer</span></code><a·class="headerlink"·href="#maintainer"·title="Link·to·this·heading"></a></h3> |
| 387 | <p>The·package·maintainer | 387 | <p>The·package·maintainer’s·name·and·email·address.·The·name·must·come |
| 388 | first,·then·the·email·address·inside·angle·brackets·<code·class="docutils·literal·notranslate"><span·class="pre"><></span></code>·(in·RFC822 | 388 | first,·then·the·email·address·inside·angle·brackets·<code·class="docutils·literal·notranslate"><span·class="pre"><></span></code>·(in·RFC822 |
| 389 | format).</p> | 389 | format).</p> |
| 390 | <p>If·the·maintainer | 390 | <p>If·the·maintainer’s·name·contains·a·full·stop·then·the·whole·field·will |
| 391 | not·work·directly·as·an·email·address·due·to·a·misfeature·in·the·syntax | 391 | not·work·directly·as·an·email·address·due·to·a·misfeature·in·the·syntax |
| 392 | specified·in·RFC822;·a·program·using·this·field·as·an·address·must·check | 392 | specified·in·RFC822;·a·program·using·this·field·as·an·address·must·check |
| 393 | for·this·and·correct·the·problem·if·necessary·(for·example·by·putting | 393 | for·this·and·correct·the·problem·if·necessary·(for·example·by·putting |
| 394 | the·name·in·round·brackets·and·moving·it·to·the·end,·and·bringing·the | 394 | the·name·in·round·brackets·and·moving·it·to·the·end,·and·bringing·the |
| 395 | email·address·forward).</p> | 395 | email·address·forward).</p> |
| 396 | <p>See·<a·class="reference·internal"·href="ch-binary.html#s-maintainer"><span·class="std·std-ref">The·maintainer·of·a·package</span></a>·for·additional·requirements·and | 396 | <p>See·<a·class="reference·internal"·href="ch-binary.html#s-maintainer"><span·class="std·std-ref">The·maintainer·of·a·package</span></a>·for·additional·requirements·and |
| 397 | information·about·package·maintainers.</p> | 397 | information·about·package·maintainers.</p> |
| Offset 475, 21 lines modified | Offset 475, 21 lines modified | ||
| 475 | value·allowed·in·the·list·is·<code·class="docutils·literal·notranslate"><span·class="pre">all</span></code>.</p> | 475 | value·allowed·in·the·list·is·<code·class="docutils·literal·notranslate"><span·class="pre">all</span></code>.</p> |
| 476 | <p>The·list·may·include·(or·consist·solely·of)·the·special·value·<code·class="docutils·literal·notranslate"><span·class="pre">all</span></code>. | 476 | <p>The·list·may·include·(or·consist·solely·of)·the·special·value·<code·class="docutils·literal·notranslate"><span·class="pre">all</span></code>. |
| 477 | In·other·words,·in·<code·class="docutils·literal·notranslate"><span·class="pre">.dsc</span></code>·files·unlike·the·<code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code>,·<code·class="docutils·literal·notranslate"><span·class="pre">all</span></code> | 477 | In·other·words,·in·<code·class="docutils·literal·notranslate"><span·class="pre">.dsc</span></code>·files·unlike·the·<code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code>,·<code·class="docutils·literal·notranslate"><span·class="pre">all</span></code> |
| 478 | may·occur·in·combination·with·specific·architectures.·The | 478 | may·occur·in·combination·with·specific·architectures.·The |
| 479 | <code·class="docutils·literal·notranslate"><span·class="pre">Architecture</span></code>·field·in·the·Debian·source·package·control·file·<code·class="docutils·literal·notranslate"><span·class="pre">.dsc</span></code>·is | 479 | <code·class="docutils·literal·notranslate"><span·class="pre">Architecture</span></code>·field·in·the·Debian·source·package·control·file·<code·class="docutils·literal·notranslate"><span·class="pre">.dsc</span></code>·is |
| 480 | generally·constructed·from·the·<code·class="docutils·literal·notranslate"><span·class="pre">Architecture</span></code>·fields·in·the | 480 | generally·constructed·from·the·<code·class="docutils·literal·notranslate"><span·class="pre">Architecture</span></code>·fields·in·the |
| 481 | <code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code>·in·the·source·package.</p> | 481 | <code·class="docutils·literal·notranslate"><span·class="pre">debian/control</span></code>·in·the·source·package.</p> |
| 482 | <p>Specifying·only·<code·class="docutils·literal·notranslate"><span·class="pre">any</span></code>·indicates·that·the·source·package·isn | 482 | <p>Specifying·only·<code·class="docutils·literal·notranslate"><span·class="pre">any</span></code>·indicates·that·the·source·package·isn’t |
| 483 | dependent·on·any·particular·architecture·and·should·compile·fine·on·any | 483 | dependent·on·any·particular·architecture·and·should·compile·fine·on·any |
| 484 | one.·The·produced·binary·package(s)·will·be·specific·to·whatever·the | 484 | one.·The·produced·binary·package(s)·will·be·specific·to·whatever·the |
| 485 | current·build·architecture·is.</p> | 485 | current·build·architecture·is.</p> |
| 486 | <p>Specifying·only·<code·class="docutils·literal·notranslate"><span·class="pre">all</span></code>·indicates·that·the·source·package·will·only | 486 | <p>Specifying·only·<code·class="docutils·literal·notranslate"><span·class="pre">all</span></code>·indicates·that·the·source·package·will·only |
| 487 | build·architecture-independent·packages.</p> | 487 | build·architecture-independent·packages.</p> |
| 488 | <p>Specifying·<code·class="docutils·literal·notranslate"><span·class="pre">any</span>·<span·class="pre">all</span></code>·indicates·that·the·source·package·isn | 488 | <p>Specifying·<code·class="docutils·literal·notranslate"><span·class="pre">any</span>·<span·class="pre">all</span></code>·indicates·that·the·source·package·isn’t·dependent |
| 489 | on·any·particular·architecture.·The·set·of·produced·binary·packages·will | 489 | on·any·particular·architecture.·The·set·of·produced·binary·packages·will |
| 490 | include·at·least·one·architecture-dependent·package·and·one | 490 | include·at·least·one·architecture-dependent·package·and·one |
| 491 | architecture-independent·package.</p> | 491 | architecture-independent·package.</p> |
| 492 | <p>Specifying·a·list·of·architectures·or·architecture·wildcards·indicates | 492 | <p>Specifying·a·list·of·architectures·or·architecture·wildcards·indicates |
| 493 | that·the·source·will·build·an·architecture-dependent·package,·and·will | 493 | that·the·source·will·build·an·architecture-dependent·package,·and·will |
| 494 | only·work·correctly·on·the·listed·or·matching·architectures.·If·the | 494 | only·work·correctly·on·the·listed·or·matching·architectures.·If·the |
| 495 | source·package·also·builds·at·least·one·architecture-independent | 495 | source·package·also·builds·at·least·one·architecture-independent |
| Offset 512, 15 lines modified | Offset 512, 15 lines modified | ||
| 512 | <p>If·set·to·<code·class="docutils·literal·notranslate"><span·class="pre">yes</span></code>·then·the·package·management·system·will·refuse·to | 512 | <p>If·set·to·<code·class="docutils·literal·notranslate"><span·class="pre">yes</span></code>·then·the·package·management·system·will·refuse·to |
| 513 | remove·the·package·(upgrading·and·replacing·it·is·still·possible).·The | 513 | remove·the·package·(upgrading·and·replacing·it·is·still·possible).·The |
| 514 | other·possible·value·is·<code·class="docutils·literal·notranslate"><span·class="pre">no</span></code>,·which·is·the·same·as·not·having·the | 514 | other·possible·value·is·<code·class="docutils·literal·notranslate"><span·class="pre">no</span></code>,·which·is·the·same·as·not·having·the |
| 515 | field·at·all.</p> | 515 | field·at·all.</p> |
| 516 | </section> | 516 | </section> |
| 517 | <section·id="package-interrelationship-fields-depends-pre-depends-recommends-suggests-breaks-conflicts-provides-replaces-enhances"> | 517 | <section·id="package-interrelationship-fields-depends-pre-depends-recommends-suggests-breaks-conflicts-provides-replaces-enhances"> |
| 518 | <span·id="s5-6-10"></span><h3><span·class="section-number">5.6.10.·</span>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·class="headerlink"·href="#package-interrelationship-fields-depends-pre-depends-recommends-suggests-breaks-conflicts-provides-replaces-enhances"·title="Link·to·this·heading"></a></h3> | 518 | <span·id="s5-6-10"></span><h3><span·class="section-number">5.6.10.·</span>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·class="headerlink"·href="#package-interrelationship-fields-depends-pre-depends-recommends-suggests-breaks-conflicts-provides-replaces-enhances"·title="Link·to·this·heading"></a></h3> |
| 519 | <p>These·fields·describe·the·package | 519 | <p>These·fields·describe·the·package’s·relationships·with·other·packages. |
| 520 | Their·syntax·and·semantics·are·described·in | 520 | Their·syntax·and·semantics·are·described·in |
| 521 | <a·class="reference·internal"·href="ch-relationships.html"><span·class="doc">Declaring·relationships·between·packages</span></a>.</p> | 521 | <a·class="reference·internal"·href="ch-relationships.html"><span·class="doc">Declaring·relationships·between·packages</span></a>.</p> |
| 522 | </section> | 522 | </section> |
| 523 | <section·id="standards-version"> | 523 | <section·id="standards-version"> |
| 524 | <span·id="s-f-standards-version"></span><h3><span·class="section-number">5.6.11.·</span><code·class="docutils·literal·notranslate"><span·class="pre">Standards-Version</span></code><a·class="headerlink"·href="#standards-version"·title="Link·to·this·heading"></a></h3> | 524 | <span·id="s-f-standards-version"></span><h3><span·class="section-number">5.6.11.·</span><code·class="docutils·literal·notranslate"><span·class="pre">Standards-Version</span></code><a·class="headerlink"·href="#standards-version"·title="Link·to·this·heading"></a></h3> |
| 525 | <p>The·most·recent·version·of·the·standards·(the·policy·manual·and | 525 | <p>The·most·recent·version·of·the·standards·(the·policy·manual·and |
| 526 | associated·texts)·with·which·the·package·complies.··See | 526 | associated·texts)·with·which·the·package·complies.··See |
| Offset 550, 19 lines modified | Offset 550, 19 lines modified | ||
| 550 | omitted,·in·which·case·zero·is·assumed.</p> | 550 | omitted,·in·which·case·zero·is·assumed.</p> |
| 551 | <p>Epochs·can·help·when·the·upstream·version·numbering·scheme | 551 | <p>Epochs·can·help·when·the·upstream·version·numbering·scheme |
| 552 | changes,·but·they·must·be·used·with·care.··You·should·not·change | 552 | changes,·but·they·must·be·used·with·care.··You·should·not·change |
| 553 | the·epoch,·even·in·experimental,·without·getting·consensus·on | 553 | the·epoch,·even·in·experimental,·without·getting·consensus·on |
| 554 | debian-devel·first.</p> | 554 | debian-devel·first.</p> |
| 555 | </dd> | 555 | </dd> |
| Max diff block lines reached; 17622/32445 bytes (54.31%) of diff not shown. | |||
| Offset 138, 16 lines modified | Offset 138, 15 lines modified | ||
| 138 | in·field·values·are·usually·escaped·by·representing·them·by·a·U+0020·SPACE | 138 | in·field·values·are·usually·escaped·by·representing·them·by·a·U+0020·SPACE |
| 139 | followed·by·a·U+002E·(.). | 139 | followed·by·a·U+002E·(.). |
| 140 | Lines·starting·with·U+0023·(#),·without·any·preceding·whitespace,·are·comment | 140 | Lines·starting·with·U+0023·(#),·without·any·preceding·whitespace,·are·comment |
| 141 | lines·that·are·only·permitted·in·source·package·control·files·(debian/control). | 141 | lines·that·are·only·permitted·in·source·package·control·files·(debian/control). |
| 142 | These·comment·lines·are·ignored,·even·between·two·continuation·lines.·They·do | 142 | These·comment·lines·are·ignored,·even·between·two·continuation·lines.·They·do |
| 143 | not·end·logical·lines. | 143 | not·end·logical·lines. |
| 144 | All·control·files·must·be·encoded·in·UTF-8. | 144 | All·control·files·must·be·encoded·in·UTF-8. |
| 145 | *\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.2\x82.\x8.·D\x8De\x8eb\x8bi\x8ia\x8an\x8n·s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·t\x8te\x8em\x8mp\x8pl\x8la\x8at\x8te\x8e·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8es\x8s· | 145 | *\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.2\x82.\x8.·D\x8De\x8eb\x8bi\x8ia\x8an\x8n·s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·t\x8te\x8em\x8mp\x8pl\x8la\x8at\x8te\x8e·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8es\x8s·?.–·d.de.eb.bi.ia.an.n/./c.co.on.nt.tr.ro.ol.l_.?.·*.**.**.**.**.* |
| 146 | *\x8**\x8**\x8**\x8**\x8* | ||
| 147 | The·debian/control·file·contains·the·most·vital·(and·version-independent) | 146 | The·debian/control·file·contains·the·most·vital·(and·version-independent) |
| 148 | information·about·the·source·package·and·about·the·binary·packages·it·creates. | 147 | information·about·the·source·package·and·about·the·binary·packages·it·creates. |
| 149 | The·first·stanza·of·the·control·file·contains·information·about·the·source | 148 | The·first·stanza·of·the·control·file·contains·information·about·the·source |
| 150 | package·in·general.·The·subsequent·stanzas·each·describe·a·binary·package·that | 149 | package·in·general.·The·subsequent·stanzas·each·describe·a·binary·package·that |
| 151 | the·source·tree·builds.·Each·binary·package·built·from·this·source·package·has | 150 | the·source·tree·builds.·Each·binary·package·built·from·this·source·package·has |
| 152 | a·corresponding·stanza,·except·for·any·automatically-generated·debug·packages | 151 | a·corresponding·stanza,·except·for·any·automatically-generated·debug·packages |
| 153 | that·do·not·require·one. | 152 | that·do·not·require·one. |
| Offset 183, 15 lines modified | Offset 182, 15 lines modified | ||
| 183 | removing·the·line·breaks·from·such·fields·when·using·fields·from·debian/control | 182 | removing·the·line·breaks·from·such·fields·when·using·fields·from·debian/control |
| 184 | to·generate·other·control·files.·They·are·also·responsible·for·discarding·empty | 183 | to·generate·other·control·files.·They·are·also·responsible·for·discarding·empty |
| 185 | fields. | 184 | fields. |
| 186 | The·fields·here·may·contain·variable·references·-·their·values·will·be | 185 | The·fields·here·may·contain·variable·references·-·their·values·will·be |
| 187 | substituted·by·dpkg-gencontrol,·dpkg-genchanges·or·dpkg-source·when·they | 186 | substituted·by·dpkg-gencontrol,·dpkg-genchanges·or·dpkg-source·when·they |
| 188 | generate·output·control·files.·See·_\x8V_\x8a_\x8r_\x8i_\x8a_\x8b_\x8l_\x8e_\x8·_\x8s_\x8u_\x8b_\x8s_\x8t_\x8i_\x8t_\x8u_\x8t_\x8i_\x8o_\x8n_\x8s_\x8:_\x8·_\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8/_\x8s_\x8u_\x8b_\x8s_\x8t_\x8v_\x8a_\x8r_\x8s·for | 187 | generate·output·control·files.·See·_\x8V_\x8a_\x8r_\x8i_\x8a_\x8b_\x8l_\x8e_\x8·_\x8s_\x8u_\x8b_\x8s_\x8t_\x8i_\x8t_\x8u_\x8t_\x8i_\x8o_\x8n_\x8s_\x8:_\x8·_\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8/_\x8s_\x8u_\x8b_\x8s_\x8t_\x8v_\x8a_\x8r_\x8s·for |
| 189 | details. | 188 | details. |
| 190 | *\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.3\x83.\x8.·D\x8De\x8eb\x8bi\x8ia\x8an\x8n·b\x8bi\x8in\x8na\x8ar\x8ry\x8y·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8es\x8s· | 189 | *\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.3\x83.\x8.·D\x8De\x8eb\x8bi\x8ia\x8an\x8n·b\x8bi\x8in\x8na\x8ar\x8ry\x8y·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8es\x8s·?.–·D\x8DE\x8EB\x8BI\x8IA\x8AN\x8N/\x8/c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 191 | The·DEBIAN/control·file·contains·the·most·vital·(and·version-dependent) | 190 | The·DEBIAN/control·file·contains·the·most·vital·(and·version-dependent) |
| 192 | information·about·a·binary·package.·It·consists·of·a·single·stanza. | 191 | information·about·a·binary·package.·It·consists·of·a·single·stanza. |
| 193 | The·fields·in·this·file·are: | 192 | The·fields·in·this·file·are: |
| 194 | ····*·_\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e·(mandatory) | 193 | ····*·_\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e·(mandatory) |
| 195 | ····*·_\x8S_\x8o_\x8u_\x8r_\x8c_\x8e | 194 | ····*·_\x8S_\x8o_\x8u_\x8r_\x8c_\x8e |
| 196 | ····*·_\x8V_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n·(mandatory) | 195 | ····*·_\x8V_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n·(mandatory) |
| 197 | ····*·_\x8S_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n·(recommended) | 196 | ····*·_\x8S_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n·(recommended) |
| Offset 200, 15 lines modified | Offset 199, 15 lines modified | ||
| 200 | ····*·_\x8E_\x8s_\x8s_\x8e_\x8n_\x8t_\x8i_\x8a_\x8l | 199 | ····*·_\x8E_\x8s_\x8s_\x8e_\x8n_\x8t_\x8i_\x8a_\x8l |
| 201 | ····*·_\x8D_\x8e_\x8p_\x8e_\x8n_\x8d_\x8s_\x8·_\x8e_\x8t_\x8·_\x8a_\x8l | 200 | ····*·_\x8D_\x8e_\x8p_\x8e_\x8n_\x8d_\x8s_\x8·_\x8e_\x8t_\x8·_\x8a_\x8l |
| 202 | ····*·_\x8I_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8e_\x8d_\x8-_\x8S_\x8i_\x8z_\x8e | 201 | ····*·_\x8I_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8e_\x8d_\x8-_\x8S_\x8i_\x8z_\x8e |
| 203 | ····*·_\x8M_\x8a_\x8i_\x8n_\x8t_\x8a_\x8i_\x8n_\x8e_\x8r·(mandatory) | 202 | ····*·_\x8M_\x8a_\x8i_\x8n_\x8t_\x8a_\x8i_\x8n_\x8e_\x8r·(mandatory) |
| 204 | ····*·_\x8D_\x8e_\x8s_\x8c_\x8r_\x8i_\x8p_\x8t_\x8i_\x8o_\x8n·(mandatory) | 203 | ····*·_\x8D_\x8e_\x8s_\x8c_\x8r_\x8i_\x8p_\x8t_\x8i_\x8o_\x8n·(mandatory) |
| 205 | ····*·_\x8H_\x8o_\x8m_\x8e_\x8p_\x8a_\x8g_\x8e | 204 | ····*·_\x8H_\x8o_\x8m_\x8e_\x8p_\x8a_\x8g_\x8e |
| 206 | ····*·_\x8B_\x8u_\x8i_\x8l_\x8t_\x8-_\x8U_\x8s_\x8i_\x8n_\x8g | 205 | ····*·_\x8B_\x8u_\x8i_\x8l_\x8t_\x8-_\x8U_\x8s_\x8i_\x8n_\x8g |
| 207 | *\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.4\x84.\x8.·D\x8De\x8eb\x8bi\x8ia\x8an\x8n·s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8es\x8s· | 206 | *\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.4\x84.\x8.·D\x8De\x8eb\x8bi\x8ia\x8an\x8n·s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8es\x8s·?.–·.\x8.d\x8ds\x8sc\x8c_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 208 | This·file·consists·of·a·single·stanza,·possibly·surrounded·by·an·OpenPGP | 207 | This·file·consists·of·a·single·stanza,·possibly·surrounded·by·an·OpenPGP |
| 209 | signature.·The·fields·of·that·stanza·are·listed·below.·Their·syntax·is | 208 | signature.·The·fields·of·that·stanza·are·listed·below.·Their·syntax·is |
| 210 | described·above,·in·_\x8S_\x8y_\x8n_\x8t_\x8a_\x8x_\x8·_\x8o_\x8f_\x8·_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s. | 209 | described·above,·in·_\x8S_\x8y_\x8n_\x8t_\x8a_\x8x_\x8·_\x8o_\x8f_\x8·_\x8c_\x8o_\x8n_\x8t_\x8r_\x8o_\x8l_\x8·_\x8f_\x8i_\x8l_\x8e_\x8s. |
| 211 | ····*·_\x8F_\x8o_\x8r_\x8m_\x8a_\x8t·(mandatory) | 210 | ····*·_\x8F_\x8o_\x8r_\x8m_\x8a_\x8t·(mandatory) |
| 212 | ····*·_\x8S_\x8o_\x8u_\x8r_\x8c_\x8e·(mandatory) | 211 | ····*·_\x8S_\x8o_\x8u_\x8r_\x8c_\x8e·(mandatory) |
| 213 | ····*·_\x8B_\x8i_\x8n_\x8a_\x8r_\x8y | 212 | ····*·_\x8B_\x8i_\x8n_\x8a_\x8r_\x8y |
| 214 | ····*·_\x8A_\x8r_\x8c_\x8h_\x8i_\x8t_\x8e_\x8c_\x8t_\x8u_\x8r_\x8e | 213 | ····*·_\x8A_\x8r_\x8c_\x8h_\x8i_\x8t_\x8e_\x8c_\x8t_\x8u_\x8r_\x8e |
| Offset 224, 15 lines modified | Offset 223, 15 lines modified | ||
| 224 | ····*·_\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8-_\x8L_\x8i_\x8s_\x8t·(recommended) | 223 | ····*·_\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8-_\x8L_\x8i_\x8s_\x8t·(recommended) |
| 225 | ····*·_\x8C_\x8h_\x8e_\x8c_\x8k_\x8s_\x8u_\x8m_\x8s_\x8-_\x8S_\x8h_\x8a_\x81_\x8·_\x8a_\x8n_\x8d_\x8·_\x8C_\x8h_\x8e_\x8c_\x8k_\x8s_\x8u_\x8m_\x8s_\x8-_\x8S_\x8h_\x8a_\x82_\x85_\x86·(mandatory) | 224 | ····*·_\x8C_\x8h_\x8e_\x8c_\x8k_\x8s_\x8u_\x8m_\x8s_\x8-_\x8S_\x8h_\x8a_\x81_\x8·_\x8a_\x8n_\x8d_\x8·_\x8C_\x8h_\x8e_\x8c_\x8k_\x8s_\x8u_\x8m_\x8s_\x8-_\x8S_\x8h_\x8a_\x82_\x85_\x86·(mandatory) |
| 226 | ····*·_\x8F_\x8i_\x8l_\x8e_\x8s·(mandatory) | 225 | ····*·_\x8F_\x8i_\x8l_\x8e_\x8s·(mandatory) |
| 227 | The·Debian·source·package·control·file·is·generated·by·dpkg-source·when·it | 226 | The·Debian·source·package·control·file·is·generated·by·dpkg-source·when·it |
| 228 | builds·the·source·archive,·from·other·files·in·the·source·package,·described | 227 | builds·the·source·archive,·from·other·files·in·the·source·package,·described |
| 229 | above.·When·unpacking,·it·is·checked·against·the·files·and·directories·in·the | 228 | above.·When·unpacking,·it·is·checked·against·the·files·and·directories·in·the |
| 230 | other·parts·of·the·source·package. | 229 | other·parts·of·the·source·package. |
| 231 | *\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.5\x85.\x8.·D\x8De\x8eb\x8bi\x8ia\x8an\x8n·u\x8up\x8pl\x8lo\x8oa\x8ad\x8d·c\x8ch\x8ha\x8an\x8ng\x8ge\x8es\x8s·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8es\x8s· | 230 | *\x8**\x8**\x8**\x8**\x8*·5\x85.\x8.5\x85.\x8.·D\x8De\x8eb\x8bi\x8ia\x8an\x8n·u\x8up\x8pl\x8lo\x8oa\x8ad\x8d·c\x8ch\x8ha\x8an\x8ng\x8ge\x8es\x8s·c\x8co\x8on\x8nt\x8tr\x8ro\x8ol\x8l·f\x8fi\x8il\x8le\x8es\x8s·?.–·.\x8.c\x8ch\x8ha\x8an\x8ng\x8ge\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 232 | The·.changes·files·are·used·by·the·Debian·archive·maintenance·software·to | 231 | The·.changes·files·are·used·by·the·Debian·archive·maintenance·software·to |
| 233 | process·updates·to·packages.·They·consist·of·a·single·stanza,·possibly | 232 | process·updates·to·packages.·They·consist·of·a·single·stanza,·possibly |
| 234 | surrounded·by·an·OpenPGP·signature.·That·stanza·contains·information·from·the | 233 | surrounded·by·an·OpenPGP·signature.·That·stanza·contains·information·from·the |
| 235 | debian/control·file·and·other·data·about·the·source·package·gathered·via | 234 | debian/control·file·and·other·data·about·the·source·package·gathered·via |
| 236 | debian/changelog·and·debian/rules. | 235 | debian/changelog·and·debian/rules. |
| 237 | .changes·files·have·a·format·version·that·is·incremented·whenever·the | 236 | .changes·files·have·a·format·version·that·is·incremented·whenever·the |
| 238 | documented·fields·or·their·meaning·change.·This·document·describes·format·1.8. | 237 | documented·fields·or·their·meaning·change.·This·document·describes·format·1.8. |
| Offset 264, 17 lines modified | Offset 263, 17 lines modified | ||
| 264 | binary·package·control·file·when·the·source·package·has·the·same·name·and | 263 | binary·package·control·file·when·the·source·package·has·the·same·name·and |
| 265 | version·as·the·binary·package. | 264 | version·as·the·binary·package. |
| 266 | Package·names·(both·source·and·binary,·see·_\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e)·must·consist·only·of·lower | 265 | Package·names·(both·source·and·binary,·see·_\x8P_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e)·must·consist·only·of·lower |
| 267 | case·letters·(a-z),·digits·(0-9),·plus·(+)·and·minus·(-)·signs,·and·periods | 266 | case·letters·(a-z),·digits·(0-9),·plus·(+)·and·minus·(-)·signs,·and·periods |
| 268 | (.).·They·must·be·at·least·two·characters·long·and·must·start·with·an | 267 | (.).·They·must·be·at·least·two·characters·long·and·must·start·with·an |
| 269 | alphanumeric·character. | 268 | alphanumeric·character. |
| 270 | *\x8**\x8**\x8**\x8*·5\x85.\x8.6\x86.\x8.2\x82.\x8.·M\x8Ma\x8ai\x8in\x8nt\x8ta\x8ai\x8in\x8ne\x8er\x8r_\x8?\x8·*\x8**\x8**\x8**\x8* | 269 | *\x8**\x8**\x8**\x8*·5\x85.\x8.6\x86.\x8.2\x82.\x8.·M\x8Ma\x8ai\x8in\x8nt\x8ta\x8ai\x8in\x8ne\x8er\x8r_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 271 | The·package·maintainer | 270 | The·package·maintainer’s·name·and·email·address.·The·name·must·come·first,·then |
| 272 | the·email·address·inside·angle·brackets·<>·(in·RFC822·format). | 271 | the·email·address·inside·angle·brackets·<>·(in·RFC822·format). |
| 273 | If·the·maintainer | 272 | If·the·maintainer’s·name·contains·a·full·stop·then·the·whole·field·will·not |
| 274 | work·directly·as·an·email·address·due·to·a·misfeature·in·the·syntax·specified | 273 | work·directly·as·an·email·address·due·to·a·misfeature·in·the·syntax·specified |
| 275 | in·RFC822;·a·program·using·this·field·as·an·address·must·check·for·this·and | 274 | in·RFC822;·a·program·using·this·field·as·an·address·must·check·for·this·and |
| 276 | correct·the·problem·if·necessary·(for·example·by·putting·the·name·in·round | 275 | correct·the·problem·if·necessary·(for·example·by·putting·the·name·in·round |
| 277 | brackets·and·moving·it·to·the·end,·and·bringing·the·email·address·forward). | 276 | brackets·and·moving·it·to·the·end,·and·bringing·the·email·address·forward). |
| 278 | See·_\x8T_\x8h_\x8e_\x8·_\x8m_\x8a_\x8i_\x8n_\x8t_\x8a_\x8i_\x8n_\x8e_\x8r_\x8·_\x8o_\x8f_\x8·_\x8a_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e·for·additional·requirements·and·information | 277 | See·_\x8T_\x8h_\x8e_\x8·_\x8m_\x8a_\x8i_\x8n_\x8t_\x8a_\x8i_\x8n_\x8e_\x8r_\x8·_\x8o_\x8f_\x8·_\x8a_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e·for·additional·requirements·and·information |
| 279 | about·package·maintainers. | 278 | about·package·maintainers. |
| 280 | *\x8**\x8**\x8**\x8*·5\x85.\x8.6\x86.\x8.3\x83.\x8.·U\x8Up\x8pl\x8lo\x8oa\x8ad\x8de\x8er\x8rs\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 279 | *\x8**\x8**\x8**\x8*·5\x85.\x8.6\x86.\x8.3\x83.\x8.·U\x8Up\x8pl\x8lo\x8oa\x8ad\x8de\x8er\x8rs\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| Offset 335, 20 lines modified | Offset 334, 20 lines modified | ||
| 335 | contains·the·architecture·wildcard·any,·the·only·other·value·allowed·in·the | 334 | contains·the·architecture·wildcard·any,·the·only·other·value·allowed·in·the |
| 336 | list·is·all. | 335 | list·is·all. |
| 337 | The·list·may·include·(or·consist·solely·of)·the·special·value·all.·In·other | 336 | The·list·may·include·(or·consist·solely·of)·the·special·value·all.·In·other |
| 338 | words,·in·.dsc·files·unlike·the·debian/control,·all·may·occur·in·combination | 337 | words,·in·.dsc·files·unlike·the·debian/control,·all·may·occur·in·combination |
| 339 | with·specific·architectures.·The·Architecture·field·in·the·Debian·source | 338 | with·specific·architectures.·The·Architecture·field·in·the·Debian·source |
| 340 | package·control·file·.dsc·is·generally·constructed·from·the·Architecture·fields | 339 | package·control·file·.dsc·is·generally·constructed·from·the·Architecture·fields |
| 341 | in·the·debian/control·in·the·source·package. | 340 | in·the·debian/control·in·the·source·package. |
| 342 | Specifying·only·any·indicates·that·the·source·package·isn | 341 | Specifying·only·any·indicates·that·the·source·package·isn’t·dependent·on·any |
| 343 | particular·architecture·and·should·compile·fine·on·any·one.·The·produced·binary | 342 | particular·architecture·and·should·compile·fine·on·any·one.·The·produced·binary |
| 344 | package(s)·will·be·specific·to·whatever·the·current·build·architecture·is. | 343 | package(s)·will·be·specific·to·whatever·the·current·build·architecture·is. |
| 345 | Specifying·only·all·indicates·that·the·source·package·will·only·build | 344 | Specifying·only·all·indicates·that·the·source·package·will·only·build |
| 346 | architecture-independent·packages. | 345 | architecture-independent·packages. |
| 347 | Specifying·any·all·indicates·that·the·source·package·isn | 346 | Specifying·any·all·indicates·that·the·source·package·isn’t·dependent·on·any |
| 348 | particular·architecture.·The·set·of·produced·binary·packages·will·include·at | 347 | particular·architecture.·The·set·of·produced·binary·packages·will·include·at |
| 349 | least·one·architecture-dependent·package·and·one·architecture-independent | 348 | least·one·architecture-dependent·package·and·one·architecture-independent |
| 350 | package. | 349 | package. |
| 351 | Specifying·a·list·of·architectures·or·architecture·wildcards·indicates·that·the | 350 | Specifying·a·list·of·architectures·or·architecture·wildcards·indicates·that·the |
| 352 | source·will·build·an·architecture-dependent·package,·and·will·only·work | 351 | source·will·build·an·architecture-dependent·package,·and·will·only·work |
| 353 | correctly·on·the·listed·or·matching·architectures.·If·the·source·package·also | 352 | correctly·on·the·listed·or·matching·architectures.·If·the·source·package·also |
| 354 | builds·at·least·one·architecture-independent·package,·all·will·also·be·included | 353 | builds·at·least·one·architecture-independent·package,·all·will·also·be·included |
| Offset 366, 15 lines modified | Offset 365, 15 lines modified | ||
| 366 | package·or·in·a·binary·package·stanza·of·a·source·package·template·control | 365 | package·or·in·a·binary·package·stanza·of·a·source·package·template·control |
| 367 | file. | 366 | file. |
| 368 | If·set·to·yes·then·the·package·management·system·will·refuse·to·remove·the | 367 | If·set·to·yes·then·the·package·management·system·will·refuse·to·remove·the |
| 369 | package·(upgrading·and·replacing·it·is·still·possible).·The·other·possible | 368 | package·(upgrading·and·replacing·it·is·still·possible).·The·other·possible |
| 370 | value·is·no,·which·is·the·same·as·not·having·the·field·at·all. | 369 | value·is·no,·which·is·the·same·as·not·having·the·field·at·all. |
| 371 | *\x8**\x8**\x8**\x8*·5\x85.\x8.6\x86.\x8.1\x810\x80.\x8.·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·i\x8in\x8nt\x8te\x8er\x8rr\x8re\x8el\x8la\x8at\x8ti\x8io\x8on\x8ns\x8sh\x8hi\x8ip\x8p·f\x8fi\x8ie\x8el\x8ld\x8ds\x8s:\x8:·D\x8De\x8ep\x8pe\x8en\x8nd\x8ds\x8s,\x8,·P\x8Pr\x8re\x8e-\x8-D\x8De\x8ep\x8pe\x8en\x8nd\x8ds\x8s,\x8, | 370 | *\x8**\x8**\x8**\x8*·5\x85.\x8.6\x86.\x8.1\x810\x80.\x8.·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·i\x8in\x8nt\x8te\x8er\x8rr\x8re\x8el\x8la\x8at\x8ti\x8io\x8on\x8ns\x8sh\x8hi\x8ip\x8p·f\x8fi\x8ie\x8el\x8ld\x8ds\x8s:\x8:·D\x8De\x8ep\x8pe\x8en\x8nd\x8ds\x8s,\x8,·P\x8Pr\x8re\x8e-\x8-D\x8De\x8ep\x8pe\x8en\x8nd\x8ds\x8s,\x8, |
| 372 | R\x8Re\x8ec\x8co\x8om\x8mm\x8me\x8en\x8nd\x8ds\x8s,\x8,·S\x8Su\x8ug\x8gg\x8ge\x8es\x8st\x8ts\x8s,\x8,·B\x8Br\x8re\x8ea\x8ak\x8ks\x8s,\x8,·C\x8Co\x8on\x8nf\x8fl\x8li\x8ic\x8ct\x8ts\x8s,\x8,·P\x8Pr\x8ro\x8ov\x8vi\x8id\x8de\x8es\x8s,\x8,·R\x8Re\x8ep\x8pl\x8la\x8ac\x8ce\x8es\x8s,\x8,·E\x8En\x8nh\x8ha\x8an\x8nc\x8ce\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 371 | R\x8Re\x8ec\x8co\x8om\x8mm\x8me\x8en\x8nd\x8ds\x8s,\x8,·S\x8Su\x8ug\x8gg\x8ge\x8es\x8st\x8ts\x8s,\x8,·B\x8Br\x8re\x8ea\x8ak\x8ks\x8s,\x8,·C\x8Co\x8on\x8nf\x8fl\x8li\x8ic\x8ct\x8ts\x8s,\x8,·P\x8Pr\x8ro\x8ov\x8vi\x8id\x8de\x8es\x8s,\x8,·R\x8Re\x8ep\x8pl\x8la\x8ac\x8ce\x8es\x8s,\x8,·E\x8En\x8nh\x8ha\x8an\x8nc\x8ce\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 373 | These·fields·describe·the·package | 372 | These·fields·describe·the·package’s·relationships·with·other·packages.·Their |
| 374 | syntax·and·semantics·are·described·in·_\x8D_\x8e_\x8c_\x8l_\x8a_\x8r_\x8i_\x8n_\x8g_\x8·_\x8r_\x8e_\x8l_\x8a_\x8t_\x8i_\x8o_\x8n_\x8s_\x8h_\x8i_\x8p_\x8s_\x8·_\x8b_\x8e_\x8t_\x8w_\x8e_\x8e_\x8n_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8s. | 373 | syntax·and·semantics·are·described·in·_\x8D_\x8e_\x8c_\x8l_\x8a_\x8r_\x8i_\x8n_\x8g_\x8·_\x8r_\x8e_\x8l_\x8a_\x8t_\x8i_\x8o_\x8n_\x8s_\x8h_\x8i_\x8p_\x8s_\x8·_\x8b_\x8e_\x8t_\x8w_\x8e_\x8e_\x8n_\x8·_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8e_\x8s. |
| 375 | *\x8**\x8**\x8**\x8*·5\x85.\x8.6\x86.\x8.1\x811\x81.\x8.·S\x8St\x8ta\x8an\x8nd\x8da\x8ar\x8rd\x8ds\x8s-\x8-V\x8Ve\x8er\x8rs\x8si\x8io\x8on\x8n_\x8?\x8·*\x8**\x8**\x8**\x8* | 374 | *\x8**\x8**\x8**\x8*·5\x85.\x8.6\x86.\x8.1\x811\x81.\x8.·S\x8St\x8ta\x8an\x8nd\x8da\x8ar\x8rd\x8ds\x8s-\x8-V\x8Ve\x8er\x8rs\x8si\x8io\x8on\x8n_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 376 | The·most·recent·version·of·the·standards·(the·policy·manual·and·associated | 375 | The·most·recent·version·of·the·standards·(the·policy·manual·and·associated |
| 377 | texts)·with·which·the·package·complies.·See·_\x8S_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8s_\x8·_\x8c_\x8o_\x8n_\x8f_\x8o_\x8r_\x8m_\x8a_\x8n_\x8c_\x8e. | 376 | texts)·with·which·the·package·complies.·See·_\x8S_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8s_\x8·_\x8c_\x8o_\x8n_\x8f_\x8o_\x8r_\x8m_\x8a_\x8n_\x8c_\x8e. |
| 378 | The·version·number·has·four·components:·major·and·minor·version·number·and | 377 | The·version·number·has·four·components:·major·and·minor·version·number·and |
| 379 | major·and·minor·patch·level.·When·the·standards·change·in·a·way·that·requires | 378 | major·and·minor·patch·level.·When·the·standards·change·in·a·way·that·requires |
| 380 | every·package·to·change·the·major·number·will·be·changed.·Significant·changes | 379 | every·package·to·change·the·major·number·will·be·changed.·Significant·changes |
| Offset 395, 18 lines modified | Offset 394, 18 lines modified | ||
| 395 | ······This·is·a·single·(generally·small)·unsigned·integer.·It·may·be·omitted, | 394 | ······This·is·a·single·(generally·small)·unsigned·integer.·It·may·be·omitted, |
| 396 | ······in·which·case·zero·is·assumed. | 395 | ······in·which·case·zero·is·assumed. |
| 397 | ······Epochs·can·help·when·the·upstream·version·numbering·scheme·changes,·but | 396 | ······Epochs·can·help·when·the·upstream·version·numbering·scheme·changes,·but |
| 398 | ······they·must·be·used·with·care.·You·should·not·change·the·epoch,·even·in | 397 | ······they·must·be·used·with·care.·You·should·not·change·the·epoch,·even·in |
| 399 | ······experimental,·without·getting·consensus·on·debian-devel·first. | 398 | ······experimental,·without·getting·consensus·on·debian-devel·first. |
| 400 | ··upstream_version | 399 | ··upstream_version |
| 401 | ······This·is·the·main·part·of·the·version·number.·It·is·usually·the·version | 400 | ······This·is·the·main·part·of·the·version·number.·It·is·usually·the·version |
| Max diff block lines reached; 12918/23127 bytes (55.86%) of diff not shown. | |||
| Offset 128, 17 lines modified | Offset 128, 17 lines modified | ||
| 128 | <h1><span·class="section-number">11.·</span>Customized·programs<a·class="headerlink"·href="#customized-programs"·title="Link·to·this·heading"></a></h1> | 128 | <h1><span·class="section-number">11.·</span>Customized·programs<a·class="headerlink"·href="#customized-programs"·title="Link·to·this·heading"></a></h1> |
| 129 | <section·id="architecture-specification-strings"> | 129 | <section·id="architecture-specification-strings"> |
| 130 | <span·id="s-arch-spec"></span><h2><span·class="section-number">11.1.·</span>Architecture·specification·strings<a·class="headerlink"·href="#architecture-specification-strings"·title="Link·to·this·heading"></a></h2> | 130 | <span·id="s-arch-spec"></span><h2><span·class="section-number">11.1.·</span>Architecture·specification·strings<a·class="headerlink"·href="#architecture-specification-strings"·title="Link·to·this·heading"></a></h2> |
| 131 | <p>If·a·program·needs·to·specify·an·<em>architecture·specification·string</em>·in | 131 | <p>If·a·program·needs·to·specify·an·<em>architecture·specification·string</em>·in |
| 132 | some·place,·it·should·select·one·of·the·strings·provided·by | 132 | some·place,·it·should·select·one·of·the·strings·provided·by |
| 133 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg-architecture</span>·<span·class="pre">-L</span></code>.·The·strings·are·in·the·format·<code·class="docutils·literal·notranslate"><span·class="pre">os-arch</span></code>,·though·the·OS | 133 | <code·class="docutils·literal·notranslate"><span·class="pre">dpkg-architecture</span>·<span·class="pre">-L</span></code>.·The·strings·are·in·the·format·<code·class="docutils·literal·notranslate"><span·class="pre">os-arch</span></code>,·though·the·OS |
| 134 | part·is·sometimes·elided,·as·when·the·OS·is·Linux.</p> | 134 | part·is·sometimes·elided,·as·when·the·OS·is·Linux.</p> |
| 135 | <p>Note·that·we·don | 135 | <p>Note·that·we·don’t·want·to·use·<code·class="docutils·literal·notranslate"><span·class="pre">arch-debian-linux</span></code>·to·apply·to·the |
| 136 | rule·<code·class="docutils·literal·notranslate"><span·class="pre">architecture-vendor-os</span></code>·since·this·would·make·our·programs | 136 | rule·<code·class="docutils·literal·notranslate"><span·class="pre">architecture-vendor-os</span></code>·since·this·would·make·our·programs |
| 137 | incompatible·with·other·Linux·distributions.·We·also·don | 137 | incompatible·with·other·Linux·distributions.·We·also·don’t·use·something |
| 138 | like·<code·class="docutils·literal·notranslate"><span·class="pre">arch-unknown-linux</span></code>,·since·the·<code·class="docutils·literal·notranslate"><span·class="pre">unknown</span></code>·does·not·look·very | 138 | like·<code·class="docutils·literal·notranslate"><span·class="pre">arch-unknown-linux</span></code>,·since·the·<code·class="docutils·literal·notranslate"><span·class="pre">unknown</span></code>·does·not·look·very |
| 139 | good.</p> | 139 | good.</p> |
| 140 | <section·id="architecture-wildcards"> | 140 | <section·id="architecture-wildcards"> |
| 141 | <span·id="s-arch-wildcard-spec"></span><h3><span·class="section-number">11.1.1.·</span>Architecture·wildcards<a·class="headerlink"·href="#architecture-wildcards"·title="Link·to·this·heading"></a></h3> | 141 | <span·id="s-arch-wildcard-spec"></span><h3><span·class="section-number">11.1.1.·</span>Architecture·wildcards<a·class="headerlink"·href="#architecture-wildcards"·title="Link·to·this·heading"></a></h3> |
| 142 | <p>A·package·may·specify·an·architecture·wildcard.·Architecture·wildcards | 142 | <p>A·package·may·specify·an·architecture·wildcard.·Architecture·wildcards |
| 143 | are·in·the·format·<code·class="docutils·literal·notranslate"><span·class="pre">any</span></code>·(which·matches·every·architecture), | 143 | are·in·the·format·<code·class="docutils·literal·notranslate"><span·class="pre">any</span></code>·(which·matches·every·architecture), |
| 144 | <code·class="docutils·literal·notranslate"><span·class="pre">os</span></code>-any,·or·any-<code·class="docutils·literal·notranslate"><span·class="pre">cpu</span></code>.··<a·class="footnote-reference·brackets"·href="#id10"·id="id1"·role="doc-noteref"><span·class="fn-bracket">[</span>1<span·class="fn-bracket">]</span></a></p> | 144 | <code·class="docutils·literal·notranslate"><span·class="pre">os</span></code>-any,·or·any-<code·class="docutils·literal·notranslate"><span·class="pre">cpu</span></code>.··<a·class="footnote-reference·brackets"·href="#id10"·id="id1"·role="doc-noteref"><span·class="fn-bracket">[</span>1<span·class="fn-bracket">]</span></a></p> |
| Offset 149, 20 lines modified | Offset 149, 20 lines modified | ||
| 149 | <p>The·configuration·files·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/services</span></code>,·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/protocols</span></code>,·and | 149 | <p>The·configuration·files·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/services</span></code>,·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/protocols</span></code>,·and |
| 150 | <code·class="docutils·literal·notranslate"><span·class="pre">/etc/rpc</span></code>·are·managed·by·the·<code·class="docutils·literal·notranslate"><span·class="pre">netbase</span></code>·package·and·must·not·be | 150 | <code·class="docutils·literal·notranslate"><span·class="pre">/etc/rpc</span></code>·are·managed·by·the·<code·class="docutils·literal·notranslate"><span·class="pre">netbase</span></code>·package·and·must·not·be |
| 151 | modified·by·other·packages.</p> | 151 | modified·by·other·packages.</p> |
| 152 | <p>If·a·package·requires·a·new·entry·in·one·of·these·files,·the·maintainer | 152 | <p>If·a·package·requires·a·new·entry·in·one·of·these·files,·the·maintainer |
| 153 | should·get·in·contact·with·the·<code·class="docutils·literal·notranslate"><span·class="pre">netbase</span></code>·maintainer,·who·will·add·the | 153 | should·get·in·contact·with·the·<code·class="docutils·literal·notranslate"><span·class="pre">netbase</span></code>·maintainer,·who·will·add·the |
| 154 | entries·and·release·a·new·version·of·the·<code·class="docutils·literal·notranslate"><span·class="pre">netbase</span></code>·package.</p> | 154 | entries·and·release·a·new·version·of·the·<code·class="docutils·literal·notranslate"><span·class="pre">netbase</span></code>·package.</p> |
| 155 | <p>The·configuration·file·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/inetd.conf</span></code>·must·not·be·modified·by·the | 155 | <p>The·configuration·file·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/inetd.conf</span></code>·must·not·be·modified·by·the |
| 156 | package | 156 | package’s·scripts·except·via·the·<code·class="docutils·literal·notranslate"><span·class="pre">update-inetd</span></code>·script·or·the |
| 157 | <code·class="docutils·literal·notranslate"><span·class="pre">DebianNet.pm</span></code>·Perl·module.·See·their·documentation·for·details·on·how | 157 | <code·class="docutils·literal·notranslate"><span·class="pre">DebianNet.pm</span></code>·Perl·module.·See·their·documentation·for·details·on·how |
| 158 | to·add·entries.</p> | 158 | to·add·entries.</p> |
| 159 | <p>If·a·package·wants·to·install·an·example·entry·into·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/inetd.conf</span></code>, | 159 | <p>If·a·package·wants·to·install·an·example·entry·into·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/inetd.conf</span></code>, |
| 160 | the·entry·must·be·preceded·with·exactly·one·hash·character·(<code·class="docutils·literal·notranslate"><span·class="pre">#</span></code>).·Such | 160 | the·entry·must·be·preceded·with·exactly·one·hash·character·(<code·class="docutils·literal·notranslate"><span·class="pre">#</span></code>).·Such |
| 161 | lines·are·treated·as· | 161 | lines·are·treated·as·“commented·out·by·user”·by·the·<code·class="docutils·literal·notranslate"><span·class="pre">update-inetd</span></code> |
| 162 | script·and·are·not·changed·or·activated·during·package·updates.</p> | 162 | script·and·are·not·changed·or·activated·during·package·updates.</p> |
| 163 | </section> | 163 | </section> |
| 164 | <section·id="using-pseudo-ttys-and-modifying-wtmp-utmp-and-lastlog"> | 164 | <section·id="using-pseudo-ttys-and-modifying-wtmp-utmp-and-lastlog"> |
| 165 | <span·id="s11-3"></span><h2><span·class="section-number">11.3.·</span>Using·pseudo-ttys·and·modifying·wtmp,·utmp·and·lastlog<a·class="headerlink"·href="#using-pseudo-ttys-and-modifying-wtmp-utmp-and-lastlog"·title="Link·to·this·heading"></a></h2> | 165 | <span·id="s11-3"></span><h2><span·class="section-number">11.3.·</span>Using·pseudo-ttys·and·modifying·wtmp,·utmp·and·lastlog<a·class="headerlink"·href="#using-pseudo-ttys-and-modifying-wtmp-utmp-and-lastlog"·title="Link·to·this·heading"></a></h2> |
| 166 | <p>Some·programs·need·to·create·pseudo-ttys.·This·should·be·done·using | 166 | <p>Some·programs·need·to·create·pseudo-ttys.·This·should·be·done·using |
| 167 | Unix98·ptys·if·the·C·library·supports·it.·The·resulting·program·must·not | 167 | Unix98·ptys·if·the·C·library·supports·it.·The·resulting·program·must·not |
| 168 | be·installed·setuid·root,·unless·that·is·required·for·other | 168 | be·installed·setuid·root,·unless·that·is·required·for·other |
| Offset 182, 15 lines modified | Offset 182, 15 lines modified | ||
| 182 | none·is·selected·by·the·user·or·system·administrator.</p> | 182 | none·is·selected·by·the·user·or·system·administrator.</p> |
| 183 | <p>Thus,·every·program·that·launches·an·editor·or·pager·must·use·the·EDITOR | 183 | <p>Thus,·every·program·that·launches·an·editor·or·pager·must·use·the·EDITOR |
| 184 | or·PAGER·environment·variable·to·determine·the·editor·or·pager·the·user | 184 | or·PAGER·environment·variable·to·determine·the·editor·or·pager·the·user |
| 185 | wishes·to·use.·If·these·variables·are·not·set,·the·programs | 185 | wishes·to·use.·If·these·variables·are·not·set,·the·programs |
| 186 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/editor</span></code>·and·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/pager</span></code>·should·be·used,·respectively. | 186 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/editor</span></code>·and·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/pager</span></code>·should·be·used,·respectively. |
| 187 | These·commands·may·be·invoked·explicitly·(e.g.,·as·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/editor</span></code>)·or | 187 | These·commands·may·be·invoked·explicitly·(e.g.,·as·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/editor</span></code>)·or |
| 188 | via·a·PATH·search·(e.g.,·as·<code·class="docutils·literal·notranslate"><span·class="pre">editor</span></code>).</p> | 188 | via·a·PATH·search·(e.g.,·as·<code·class="docutils·literal·notranslate"><span·class="pre">editor</span></code>).</p> |
| 189 | <p>These·two·files·are·managed·through·the·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>· | 189 | <p>These·two·files·are·managed·through·the·<code·class="docutils·literal·notranslate"><span·class="pre">dpkg</span></code>·“alternatives” |
| 190 | mechanism.·Every·package·providing·an·editor·or·pager·must·call·the | 190 | mechanism.·Every·package·providing·an·editor·or·pager·must·call·the |
| 191 | <code·class="docutils·literal·notranslate"><span·class="pre">update-alternatives</span></code>·script·to·register·as·an·alternative·for | 191 | <code·class="docutils·literal·notranslate"><span·class="pre">update-alternatives</span></code>·script·to·register·as·an·alternative·for |
| 192 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/editor</span></code>·or·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/pager</span></code>·as·appropriate.·The | 192 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/editor</span></code>·or·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/pager</span></code>·as·appropriate.·The |
| 193 | alternative·should·have·a·slave·alternative·for | 193 | alternative·should·have·a·slave·alternative·for |
| 194 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man/man1/editor.1.gz</span></code>·or | 194 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man/man1/editor.1.gz</span></code>·or |
| 195 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man/man1/pager.1.gz</span></code>·pointing·to·the·corresponding·manual | 195 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man/man1/pager.1.gz</span></code>·pointing·to·the·corresponding·manual |
| 196 | page.</p> | 196 | page.</p> |
| Offset 198, 15 lines modified | Offset 198, 15 lines modified | ||
| 198 | variables,·that·program·may·be·configured·to·use | 198 | variables,·that·program·may·be·configured·to·use |
| 199 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/sensible-editor</span></code>·and·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/sensible-pager</span></code>·as·the | 199 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/sensible-editor</span></code>·and·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/sensible-pager</span></code>·as·the |
| 200 | editor·or·pager·program·respectively.·These·are·two·scripts·provided·in | 200 | editor·or·pager·program·respectively.·These·are·two·scripts·provided·in |
| 201 | the·sensible-utils·package·that·check·the·EDITOR·and·PAGER·variables·and | 201 | the·sensible-utils·package·that·check·the·EDITOR·and·PAGER·variables·and |
| 202 | launch·the·appropriate·program,·and·fall·back·to·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/editor</span></code>·and | 202 | launch·the·appropriate·program,·and·fall·back·to·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/editor</span></code>·and |
| 203 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/pager</span></code>·if·the·variable·is·not·set.</p> | 203 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/pager</span></code>·if·the·variable·is·not·set.</p> |
| 204 | <p>A·program·may·also·use·the·VISUAL·environment·variable·to·determine·the | 204 | <p>A·program·may·also·use·the·VISUAL·environment·variable·to·determine·the |
| 205 | user | 205 | user’s·choice·of·editor.·If·it·exists,·it·should·take·precedence·over |
| 206 | EDITOR.·This·is·in·fact·what·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/sensible-editor</span></code>·does.</p> | 206 | EDITOR.·This·is·in·fact·what·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/bin/sensible-editor</span></code>·does.</p> |
| 207 | <p>It·is·not·required·for·a·package·to·depend·on·<code·class="docutils·literal·notranslate"><span·class="pre">editor</span></code>·and·<code·class="docutils·literal·notranslate"><span·class="pre">pager</span></code>, | 207 | <p>It·is·not·required·for·a·package·to·depend·on·<code·class="docutils·literal·notranslate"><span·class="pre">editor</span></code>·and·<code·class="docutils·literal·notranslate"><span·class="pre">pager</span></code>, |
| 208 | nor·is·it·required·for·a·package·to·provide·such·virtual | 208 | nor·is·it·required·for·a·package·to·provide·such·virtual |
| 209 | packages.·<a·class="footnote-reference·brackets"·href="#id11"·id="id2"·role="doc-noteref"><span·class="fn-bracket">[</span>2<span·class="fn-bracket">]</span></a></p> | 209 | packages.·<a·class="footnote-reference·brackets"·href="#id11"·id="id2"·role="doc-noteref"><span·class="fn-bracket">[</span>2<span·class="fn-bracket">]</span></a></p> |
| 210 | </section> | 210 | </section> |
| 211 | <section·id="web-servers-and-applications"> | 211 | <section·id="web-servers-and-applications"> |
| 212 | <span·id="s-web-appl"></span><h2><span·class="section-number">11.5.·</span>Web·servers·and·applications<a·class="headerlink"·href="#web-servers-and-applications"·title="Link·to·this·heading"></a></h2> | 212 | <span·id="s-web-appl"></span><h2><span·class="section-number">11.5.·</span>Web·servers·and·applications<a·class="headerlink"·href="#web-servers-and-applications"·title="Link·to·this·heading"></a></h2> |
| Offset 281, 15 lines modified | Offset 281, 15 lines modified | ||
| 281 | choose·a·different·permission·scheme;·packages·should·not·make | 281 | choose·a·different·permission·scheme;·packages·should·not·make |
| 282 | assumptions·about·the·permission·and·ownership·of·mailboxes·unless | 282 | assumptions·about·the·permission·and·ownership·of·mailboxes·unless |
| 283 | required·(such·as·when·creating·a·new·mailbox).·A·MUA·may·remove·a | 283 | required·(such·as·when·creating·a·new·mailbox).·A·MUA·may·remove·a |
| 284 | mailbox·(unless·it·has·nonstandard·permissions)·in·which·case·the·MTA·or | 284 | mailbox·(unless·it·has·nonstandard·permissions)·in·which·case·the·MTA·or |
| 285 | another·MUA·must·recreate·it·if·needed.</p> | 285 | another·MUA·must·recreate·it·if·needed.</p> |
| 286 | <p>The·mail·spool·is·2775·<code·class="docutils·literal·notranslate"><span·class="pre">root:mail</span></code>,·and·MUAs·should·be·setgid·mail·to | 286 | <p>The·mail·spool·is·2775·<code·class="docutils·literal·notranslate"><span·class="pre">root:mail</span></code>,·and·MUAs·should·be·setgid·mail·to |
| 287 | do·the·locking·mentioned·above·(and·must·obviously·avoid·accessing·other | 287 | do·the·locking·mentioned·above·(and·must·obviously·avoid·accessing·other |
| 288 | users | 288 | users’·mailboxes·using·this·privilege).</p> |
| 289 | <p><code·class="docutils·literal·notranslate"><span·class="pre">/etc/aliases</span></code>·is·the·source·file·for·the·system·mail·aliases·(e.g., | 289 | <p><code·class="docutils·literal·notranslate"><span·class="pre">/etc/aliases</span></code>·is·the·source·file·for·the·system·mail·aliases·(e.g., |
| 290 | postmaster,·usenet,·etc.),·it·is·the·one·which·the·sysadmin·and | 290 | postmaster,·usenet,·etc.),·it·is·the·one·which·the·sysadmin·and |
| 291 | <code·class="docutils·literal·notranslate"><span·class="pre">postinst</span></code>·scripts·may·edit.·After·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/aliases</span></code>·is·edited·the | 291 | <code·class="docutils·literal·notranslate"><span·class="pre">postinst</span></code>·scripts·may·edit.·After·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/aliases</span></code>·is·edited·the |
| 292 | program·or·human·editing·it·must·call·<code·class="docutils·literal·notranslate"><span·class="pre">newaliases</span></code>.·All·MTA·packages | 292 | program·or·human·editing·it·must·call·<code·class="docutils·literal·notranslate"><span·class="pre">newaliases</span></code>.·All·MTA·packages |
| 293 | must·come·with·a·<code·class="docutils·literal·notranslate"><span·class="pre">newaliases</span></code>·program,·even·if·it·does·nothing,·but | 293 | must·come·with·a·<code·class="docutils·literal·notranslate"><span·class="pre">newaliases</span></code>·program,·even·if·it·does·nothing,·but |
| 294 | older·MTA·packages·did·not·do·this·so·programs·should·not·fail·if | 294 | older·MTA·packages·did·not·do·this·so·programs·should·not·fail·if |
| 295 | <code·class="docutils·literal·notranslate"><span·class="pre">newaliases</span></code>·cannot·be·found.·Note·that·because·of·this,·all·MTA | 295 | <code·class="docutils·literal·notranslate"><span·class="pre">newaliases</span></code>·cannot·be·found.·Note·that·because·of·this,·all·MTA |
| Offset 303, 19 lines modified | Offset 303, 19 lines modified | ||
| 303 | <p>If·your·package·needs·to·know·what·hostname·to·use·on·(for·example) | 303 | <p>If·your·package·needs·to·know·what·hostname·to·use·on·(for·example) |
| 304 | outgoing·news·and·mail·messages·which·are·generated·locally,·you·should | 304 | outgoing·news·and·mail·messages·which·are·generated·locally,·you·should |
| 305 | use·the·file·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/mailname</span></code>.·It·will·contain·the·portion·after·the | 305 | use·the·file·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/mailname</span></code>.·It·will·contain·the·portion·after·the |
| 306 | username·and·<code·class="docutils·literal·notranslate"><span·class="pre">@</span></code>·(at)·sign·for·email·addresses·of·users·on·the·machine | 306 | username·and·<code·class="docutils·literal·notranslate"><span·class="pre">@</span></code>·(at)·sign·for·email·addresses·of·users·on·the·machine |
| 307 | (followed·by·a·newline).</p> | 307 | (followed·by·a·newline).</p> |
| 308 | <p>Such·a·package·should·check·for·the·existence·of·this·file·when·it·is | 308 | <p>Such·a·package·should·check·for·the·existence·of·this·file·when·it·is |
| 309 | being·configured.·If·it·exists,·it·should·be·used·without·comment, | 309 | being·configured.·If·it·exists,·it·should·be·used·without·comment, |
| 310 | although·an·MTA | 310 | although·an·MTA’s·configuration·script·may·wish·to·prompt·the·user·even |
| 311 | if·it·finds·that·this·file·exists.·If·the·file·does·not·exist,·the | 311 | if·it·finds·that·this·file·exists.·If·the·file·does·not·exist,·the |
| 312 | package·should·prompt·the·user·for·the·value·(preferably·using | 312 | package·should·prompt·the·user·for·the·value·(preferably·using |
| 313 | <code·class="docutils·literal·notranslate"><span·class="pre">debconf</span></code>)·and·store·it·in·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/mailname</span></code>·as·well·as·using·it·in | 313 | <code·class="docutils·literal·notranslate"><span·class="pre">debconf</span></code>)·and·store·it·in·<code·class="docutils·literal·notranslate"><span·class="pre">/etc/mailname</span></code>·as·well·as·using·it·in |
| 314 | the·package | 314 | the·package’s·configuration.·The·prompt·should·make·it·clear·that·the |
| 315 | name·will·not·just·be·used·by·that·package.·For·example,·in·this | 315 | name·will·not·just·be·used·by·that·package.·For·example,·in·this |
| 316 | situation·the·<code·class="docutils·literal·notranslate"><span·class="pre">inn</span></code>·package·could·say·something·like:</p> | 316 | situation·the·<code·class="docutils·literal·notranslate"><span·class="pre">inn</span></code>·package·could·say·something·like:</p> |
| 317 | <div·class="highlight-default·notranslate"><div·class="highlight"><pre><span></span><span·class="n">Please</span>·<span·class="n">enter</span>·<span·class="n">the</span>·<span·class="s2">"mail·name"</span>·<span·class="n">of</span>·<span·class="n">your</span>·<span·class="n">system</span><span·class="o">.</span>··<span·class="n">This</span>·<span·class="ow">is</span>·<span·class="n">the</span>·<span·class="n">hostname</span>·<span·class="n">portion</span> | 317 | <div·class="highlight-default·notranslate"><div·class="highlight"><pre><span></span><span·class="n">Please</span>·<span·class="n">enter</span>·<span·class="n">the</span>·<span·class="s2">"mail·name"</span>·<span·class="n">of</span>·<span·class="n">your</span>·<span·class="n">system</span><span·class="o">.</span>··<span·class="n">This</span>·<span·class="ow">is</span>·<span·class="n">the</span>·<span·class="n">hostname</span>·<span·class="n">portion</span> |
| 318 | <span·class="n">of</span>·<span·class="n">the</span>·<span·class="n">address</span>·<span·class="n">to</span>·<span·class="n">be</span>·<span·class="n">shown</span>·<span·class="n">on</span>·<span·class="n">outgoing</span>·<span·class="n">news</span>·<span·class="ow">and</span>·<span·class="n">mail</span>·<span·class="n">messages</span><span·class="o">.</span>··<span·class="n">The</span> | 318 | <span·class="n">of</span>·<span·class="n">the</span>·<span·class="n">address</span>·<span·class="n">to</span>·<span·class="n">be</span>·<span·class="n">shown</span>·<span·class="n">on</span>·<span·class="n">outgoing</span>·<span·class="n">news</span>·<span·class="ow">and</span>·<span·class="n">mail</span>·<span·class="n">messages</span><span·class="o">.</span>··<span·class="n">The</span> |
| 319 | <span·class="n">default</span>·<span·class="ow">is</span>·<span·class="n">syshostname</span><span·class="p">,</span>·<span·class="n">your</span>·<span·class="n">system</span><span·class="s1">'s·host·name.</span> | 319 | <span·class="n">default</span>·<span·class="ow">is</span>·<span·class="n">syshostname</span><span·class="p">,</span>·<span·class="n">your</span>·<span·class="n">system</span><span·class="s1">'s·host·name.</span> |
| 320 | <span·class="n">Mail</span>·<span·class="n">name</span>·<span·class="p">[</span><span·class="s2">"syshostname"</span><span·class="p">]:</span> | 320 | <span·class="n">Mail</span>·<span·class="n">name</span>·<span·class="p">[</span><span·class="s2">"syshostname"</span><span·class="p">]:</span> |
| Offset 346, 15 lines modified | Offset 346, 15 lines modified | ||
| 346 | <span·id="s11-8-1"></span><h3><span·class="section-number">11.8.1.·</span>Providing·X·support·and·package·priorities<a·class="headerlink"·href="#providing-x-support-and-package-priorities"·title="Link·to·this·heading"></a></h3> | 346 | <span·id="s11-8-1"></span><h3><span·class="section-number">11.8.1.·</span>Providing·X·support·and·package·priorities<a·class="headerlink"·href="#providing-x-support-and-package-priorities"·title="Link·to·this·heading"></a></h3> |
| 347 | <p>Programs·that·can·be·configured·with·support·for·the·X·Window·System | 347 | <p>Programs·that·can·be·configured·with·support·for·the·X·Window·System |
| 348 | must·be·configured·to·do·so·and·must·declare·any·package·dependencies | 348 | must·be·configured·to·do·so·and·must·declare·any·package·dependencies |
| 349 | necessary·to·satisfy·their·runtime·requirements·when·using·the·X·Window | 349 | necessary·to·satisfy·their·runtime·requirements·when·using·the·X·Window |
| 350 | System.·If·such·a·package·is·of·higher·priority·than·the·X·packages·on | 350 | System.·If·such·a·package·is·of·higher·priority·than·the·X·packages·on |
| 351 | which·it·depends,·it·is·required·that·either·the·X-specific·components | 351 | which·it·depends,·it·is·required·that·either·the·X-specific·components |
| 352 | be·split·into·a·separate·package,·or·that·an·alternative·version·of·the | 352 | be·split·into·a·separate·package,·or·that·an·alternative·version·of·the |
| 353 | package,·which·includes·X·support,·be·provided,·or·that·the·package | 353 | package,·which·includes·X·support,·be·provided,·or·that·the·package’s |
| 354 | priority·be·lowered.</p> | 354 | priority·be·lowered.</p> |
| 355 | </section> | 355 | </section> |
| 356 | <section·id="packages-providing-an-x-server"> | 356 | <section·id="packages-providing-an-x-server"> |
| 357 | <span·id="s11-8-2"></span><h3><span·class="section-number">11.8.2.·</span>Packages·providing·an·X·server<a·class="headerlink"·href="#packages-providing-an-x-server"·title="Link·to·this·heading"></a></h3> | 357 | <span·id="s11-8-2"></span><h3><span·class="section-number">11.8.2.·</span>Packages·providing·an·X·server<a·class="headerlink"·href="#packages-providing-an-x-server"·title="Link·to·this·heading"></a></h3> |
| 358 | <p>Packages·that·provide·an·X·server·that,·directly·or·indirectly, | 358 | <p>Packages·that·provide·an·X·server·that,·directly·or·indirectly, |
| 359 | communicates·with·real·input·and·display·hardware·should·declare·in | 359 | communicates·with·real·input·and·display·hardware·should·declare·in |
| 360 | their·<code·class="docutils·literal·notranslate"><span·class="pre">Provides</span></code>·control·field·that·they·provide·the·virtual·package | 360 | their·<code·class="docutils·literal·notranslate"><span·class="pre">Provides</span></code>·control·field·that·they·provide·the·virtual·package |
| Offset 374, 15 lines modified | Offset 374, 15 lines modified | ||
| 374 | <ul·class="simple"> | 374 | <ul·class="simple"> |
| 375 | <li><p>Be·able·to·emulate·a·DEC·VT100·terminal,·or·a·compatible·terminal.</p></li> | 375 | <li><p>Be·able·to·emulate·a·DEC·VT100·terminal,·or·a·compatible·terminal.</p></li> |
| 376 | <li><p>Support·the·command-line·option·<code·class="docutils·literal·notranslate"><span·class="pre">-e</span>·<span·class="pre">command</span></code>,·which·creates·a·new | 376 | <li><p>Support·the·command-line·option·<code·class="docutils·literal·notranslate"><span·class="pre">-e</span>·<span·class="pre">command</span></code>,·which·creates·a·new |
| 377 | terminal·window·<a·class="footnote-reference·brackets"·href="#id15"·id="id6"·role="doc-noteref"><span·class="fn-bracket">[</span>6<span·class="fn-bracket">]</span></a>·and·runs·the·specified·command.··<command>·may | 377 | terminal·window·<a·class="footnote-reference·brackets"·href="#id15"·id="id6"·role="doc-noteref"><span·class="fn-bracket">[</span>6<span·class="fn-bracket">]</span></a>·and·runs·the·specified·command.··<command>·may |
| Max diff block lines reached; 14113/28994 bytes (48.68%) of diff not shown. | |||
| Offset 52, 33 lines modified | Offset 52, 33 lines modified | ||
| 52 | =============================================================================== | 52 | =============================================================================== |
| 53 | *\x8**\x8**\x8**\x8**\x8**\x8*·1\x811\x81.\x8.·C\x8Cu\x8us\x8st\x8to\x8om\x8mi\x8iz\x8ze\x8ed\x8d·p\x8pr\x8ro\x8og\x8gr\x8ra\x8am\x8ms\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8**\x8* | 53 | *\x8**\x8**\x8**\x8**\x8**\x8*·1\x811\x81.\x8.·C\x8Cu\x8us\x8st\x8to\x8om\x8mi\x8iz\x8ze\x8ed\x8d·p\x8pr\x8ro\x8og\x8gr\x8ra\x8am\x8ms\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8**\x8* |
| 54 | *\x8**\x8**\x8**\x8**\x8*·1\x811\x81.\x8.1\x81.\x8.·A\x8Ar\x8rc\x8ch\x8hi\x8it\x8te\x8ec\x8ct\x8tu\x8ur\x8re\x8e·s\x8sp\x8pe\x8ec\x8ci\x8if\x8fi\x8ic\x8ca\x8at\x8ti\x8io\x8on\x8n·s\x8st\x8tr\x8ri\x8in\x8ng\x8gs\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 54 | *\x8**\x8**\x8**\x8**\x8*·1\x811\x81.\x8.1\x81.\x8.·A\x8Ar\x8rc\x8ch\x8hi\x8it\x8te\x8ec\x8ct\x8tu\x8ur\x8re\x8e·s\x8sp\x8pe\x8ec\x8ci\x8if\x8fi\x8ic\x8ca\x8at\x8ti\x8io\x8on\x8n·s\x8st\x8tr\x8ri\x8in\x8ng\x8gs\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 55 | If·a·program·needs·to·specify·an·a\x8ar\x8rc\x8ch\x8hi\x8it\x8te\x8ec\x8ct\x8tu\x8ur\x8re\x8e·s\x8sp\x8pe\x8ec\x8ci\x8if\x8fi\x8ic\x8ca\x8at\x8ti\x8io\x8on\x8n·s\x8st\x8tr\x8ri\x8in\x8ng\x8g·in·some | 55 | If·a·program·needs·to·specify·an·a\x8ar\x8rc\x8ch\x8hi\x8it\x8te\x8ec\x8ct\x8tu\x8ur\x8re\x8e·s\x8sp\x8pe\x8ec\x8ci\x8if\x8fi\x8ic\x8ca\x8at\x8ti\x8io\x8on\x8n·s\x8st\x8tr\x8ri\x8in\x8ng\x8g·in·some |
| 56 | place,·it·should·select·one·of·the·strings·provided·by·dpkg-architecture·-L. | 56 | place,·it·should·select·one·of·the·strings·provided·by·dpkg-architecture·-L. |
| 57 | The·strings·are·in·the·format·os-arch,·though·the·OS·part·is·sometimes·elided, | 57 | The·strings·are·in·the·format·os-arch,·though·the·OS·part·is·sometimes·elided, |
| 58 | as·when·the·OS·is·Linux. | 58 | as·when·the·OS·is·Linux. |
| 59 | Note·that·we·don | 59 | Note·that·we·don’t·want·to·use·arch-debian-linux·to·apply·to·the·rule |
| 60 | architecture-vendor-os·since·this·would·make·our·programs·incompatible·with | 60 | architecture-vendor-os·since·this·would·make·our·programs·incompatible·with |
| 61 | other·Linux·distributions.·We·also·don | 61 | other·Linux·distributions.·We·also·don’t·use·something·like·arch-unknown-linux, |
| 62 | since·the·unknown·does·not·look·very·good. | 62 | since·the·unknown·does·not·look·very·good. |
| 63 | *\x8**\x8**\x8**\x8*·1\x811\x81.\x8.1\x81.\x8.1\x81.\x8.·A\x8Ar\x8rc\x8ch\x8hi\x8it\x8te\x8ec\x8ct\x8tu\x8ur\x8re\x8e·w\x8wi\x8il\x8ld\x8dc\x8ca\x8ar\x8rd\x8ds\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 63 | *\x8**\x8**\x8**\x8*·1\x811\x81.\x8.1\x81.\x8.1\x81.\x8.·A\x8Ar\x8rc\x8ch\x8hi\x8it\x8te\x8ec\x8ct\x8tu\x8ur\x8re\x8e·w\x8wi\x8il\x8ld\x8dc\x8ca\x8ar\x8rd\x8ds\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 64 | A·package·may·specify·an·architecture·wildcard.·Architecture·wildcards·are·in | 64 | A·package·may·specify·an·architecture·wildcard.·Architecture·wildcards·are·in |
| 65 | the·format·any·(which·matches·every·architecture),·os-any,·or·any-cpu.·_\x8[_\x81_\x8] | 65 | the·format·any·(which·matches·every·architecture),·os-any,·or·any-cpu.·_\x8[_\x81_\x8] |
| 66 | *\x8**\x8**\x8**\x8**\x8*·1\x811\x81.\x8.2\x82.\x8.·D\x8Da\x8ae\x8em\x8mo\x8on\x8ns\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 66 | *\x8**\x8**\x8**\x8**\x8*·1\x811\x81.\x8.2\x82.\x8.·D\x8Da\x8ae\x8em\x8mo\x8on\x8ns\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 67 | The·configuration·files·/etc/services,·/etc/protocols,·and·/etc/rpc·are·managed | 67 | The·configuration·files·/etc/services,·/etc/protocols,·and·/etc/rpc·are·managed |
| 68 | by·the·netbase·package·and·must·not·be·modified·by·other·packages. | 68 | by·the·netbase·package·and·must·not·be·modified·by·other·packages. |
| 69 | If·a·package·requires·a·new·entry·in·one·of·these·files,·the·maintainer·should | 69 | If·a·package·requires·a·new·entry·in·one·of·these·files,·the·maintainer·should |
| 70 | get·in·contact·with·the·netbase·maintainer,·who·will·add·the·entries·and | 70 | get·in·contact·with·the·netbase·maintainer,·who·will·add·the·entries·and |
| 71 | release·a·new·version·of·the·netbase·package. | 71 | release·a·new·version·of·the·netbase·package. |
| 72 | The·configuration·file·/etc/inetd.conf·must·not·be·modified·by·the·package | 72 | The·configuration·file·/etc/inetd.conf·must·not·be·modified·by·the·package’s |
| 73 | scripts·except·via·the·update-inetd·script·or·the·DebianNet.pm·Perl·module.·See | 73 | scripts·except·via·the·update-inetd·script·or·the·DebianNet.pm·Perl·module.·See |
| 74 | their·documentation·for·details·on·how·to·add·entries. | 74 | their·documentation·for·details·on·how·to·add·entries. |
| 75 | If·a·package·wants·to·install·an·example·entry·into·/etc/inetd.conf,·the·entry | 75 | If·a·package·wants·to·install·an·example·entry·into·/etc/inetd.conf,·the·entry |
| 76 | must·be·preceded·with·exactly·one·hash·character·(#).·Such·lines·are·treated·as | 76 | must·be·preceded·with·exactly·one·hash·character·(#).·Such·lines·are·treated·as |
| 77 | 77 | “commented·out·by·user”·by·the·update-inetd·script·and·are·not·changed·or | |
| 78 | activated·during·package·updates. | 78 | activated·during·package·updates. |
| 79 | *\x8**\x8**\x8**\x8**\x8*·1\x811\x81.\x8.3\x83.\x8.·U\x8Us\x8si\x8in\x8ng\x8g·p\x8ps\x8se\x8eu\x8ud\x8do\x8o-\x8-t\x8tt\x8ty\x8ys\x8s·a\x8an\x8nd\x8d·m\x8mo\x8od\x8di\x8if\x8fy\x8yi\x8in\x8ng\x8g·w\x8wt\x8tm\x8mp\x8p,\x8,·u\x8ut\x8tm\x8mp\x8p·a\x8an\x8nd\x8d·l\x8la\x8as\x8st\x8tl\x8lo\x8og\x8g_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 79 | *\x8**\x8**\x8**\x8**\x8*·1\x811\x81.\x8.3\x83.\x8.·U\x8Us\x8si\x8in\x8ng\x8g·p\x8ps\x8se\x8eu\x8ud\x8do\x8o-\x8-t\x8tt\x8ty\x8ys\x8s·a\x8an\x8nd\x8d·m\x8mo\x8od\x8di\x8if\x8fy\x8yi\x8in\x8ng\x8g·w\x8wt\x8tm\x8mp\x8p,\x8,·u\x8ut\x8tm\x8mp\x8p·a\x8an\x8nd\x8d·l\x8la\x8as\x8st\x8tl\x8lo\x8og\x8g_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 80 | Some·programs·need·to·create·pseudo-ttys.·This·should·be·done·using·Unix98·ptys | 80 | Some·programs·need·to·create·pseudo-ttys.·This·should·be·done·using·Unix98·ptys |
| 81 | if·the·C·library·supports·it.·The·resulting·program·must·not·be·installed | 81 | if·the·C·library·supports·it.·The·resulting·program·must·not·be·installed |
| 82 | setuid·root,·unless·that·is·required·for·other·functionality. | 82 | setuid·root,·unless·that·is·required·for·other·functionality. |
| 83 | The·files·/var/run/utmp,·/var/log/wtmp·and·/var/log/lastlog·must·be·installed | 83 | The·files·/var/run/utmp,·/var/log/wtmp·and·/var/log/lastlog·must·be·installed |
| 84 | writable·by·group·utmp.·Programs·which·need·to·modify·those·files·must·be | 84 | writable·by·group·utmp.·Programs·which·need·to·modify·those·files·must·be |
| Offset 91, 27 lines modified | Offset 91, 27 lines modified | ||
| 91 | In·addition,·every·program·should·choose·a·good·default·editor/pager·if·none·is | 91 | In·addition,·every·program·should·choose·a·good·default·editor/pager·if·none·is |
| 92 | selected·by·the·user·or·system·administrator. | 92 | selected·by·the·user·or·system·administrator. |
| 93 | Thus,·every·program·that·launches·an·editor·or·pager·must·use·the·EDITOR·or | 93 | Thus,·every·program·that·launches·an·editor·or·pager·must·use·the·EDITOR·or |
| 94 | PAGER·environment·variable·to·determine·the·editor·or·pager·the·user·wishes·to | 94 | PAGER·environment·variable·to·determine·the·editor·or·pager·the·user·wishes·to |
| 95 | use.·If·these·variables·are·not·set,·the·programs·/usr/bin/editor·and·/usr/bin/ | 95 | use.·If·these·variables·are·not·set,·the·programs·/usr/bin/editor·and·/usr/bin/ |
| 96 | pager·should·be·used,·respectively.·These·commands·may·be·invoked·explicitly | 96 | pager·should·be·used,·respectively.·These·commands·may·be·invoked·explicitly |
| 97 | (e.g.,·as·/usr/bin/editor)·or·via·a·PATH·search·(e.g.,·as·editor). | 97 | (e.g.,·as·/usr/bin/editor)·or·via·a·PATH·search·(e.g.,·as·editor). |
| 98 | These·two·files·are·managed·through·the·dpkg· | 98 | These·two·files·are·managed·through·the·dpkg·“alternatives”·mechanism.·Every |
| 99 | package·providing·an·editor·or·pager·must·call·the·update-alternatives·script | 99 | package·providing·an·editor·or·pager·must·call·the·update-alternatives·script |
| 100 | to·register·as·an·alternative·for·/usr/bin/editor·or·/usr/bin/pager·as | 100 | to·register·as·an·alternative·for·/usr/bin/editor·or·/usr/bin/pager·as |
| 101 | appropriate.·The·alternative·should·have·a·slave·alternative·for·/usr/share/ | 101 | appropriate.·The·alternative·should·have·a·slave·alternative·for·/usr/share/ |
| 102 | man/man1/editor.1.gz·or·/usr/share/man/man1/pager.1.gz·pointing·to·the | 102 | man/man1/editor.1.gz·or·/usr/share/man/man1/pager.1.gz·pointing·to·the |
| 103 | corresponding·manual·page. | 103 | corresponding·manual·page. |
| 104 | If·it·is·very·hard·to·adapt·a·program·to·make·use·of·the·EDITOR·or·PAGER | 104 | If·it·is·very·hard·to·adapt·a·program·to·make·use·of·the·EDITOR·or·PAGER |
| 105 | variables,·that·program·may·be·configured·to·use·/usr/bin/sensible-editor·and·/ | 105 | variables,·that·program·may·be·configured·to·use·/usr/bin/sensible-editor·and·/ |
| 106 | usr/bin/sensible-pager·as·the·editor·or·pager·program·respectively.·These·are | 106 | usr/bin/sensible-pager·as·the·editor·or·pager·program·respectively.·These·are |
| 107 | two·scripts·provided·in·the·sensible-utils·package·that·check·the·EDITOR·and | 107 | two·scripts·provided·in·the·sensible-utils·package·that·check·the·EDITOR·and |
| 108 | PAGER·variables·and·launch·the·appropriate·program,·and·fall·back·to·/usr/bin/ | 108 | PAGER·variables·and·launch·the·appropriate·program,·and·fall·back·to·/usr/bin/ |
| 109 | editor·and·/usr/bin/pager·if·the·variable·is·not·set. | 109 | editor·and·/usr/bin/pager·if·the·variable·is·not·set. |
| 110 | A·program·may·also·use·the·VISUAL·environment·variable·to·determine·the·user | 110 | A·program·may·also·use·the·VISUAL·environment·variable·to·determine·the·user’s |
| 111 | choice·of·editor.·If·it·exists,·it·should·take·precedence·over·EDITOR.·This·is | 111 | choice·of·editor.·If·it·exists,·it·should·take·precedence·over·EDITOR.·This·is |
| 112 | in·fact·what·/usr/bin/sensible-editor·does. | 112 | in·fact·what·/usr/bin/sensible-editor·does. |
| 113 | It·is·not·required·for·a·package·to·depend·on·editor·and·pager,·nor·is·it | 113 | It·is·not·required·for·a·package·to·depend·on·editor·and·pager,·nor·is·it |
| 114 | required·for·a·package·to·provide·such·virtual·packages.·_\x8[_\x82_\x8] | 114 | required·for·a·package·to·provide·such·virtual·packages.·_\x8[_\x82_\x8] |
| 115 | *\x8**\x8**\x8**\x8**\x8*·1\x811\x81.\x8.5\x85.\x8.·W\x8We\x8eb\x8b·s\x8se\x8er\x8rv\x8ve\x8er\x8rs\x8s·a\x8an\x8nd\x8d·a\x8ap\x8pp\x8pl\x8li\x8ic\x8ca\x8at\x8ti\x8io\x8on\x8ns\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 115 | *\x8**\x8**\x8**\x8**\x8*·1\x811\x81.\x8.5\x85.\x8.·W\x8We\x8eb\x8b·s\x8se\x8er\x8rv\x8ve\x8er\x8rs\x8s·a\x8an\x8nd\x8d·a\x8ap\x8pp\x8pl\x8li\x8ic\x8ca\x8at\x8ti\x8io\x8on\x8ns\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 116 | This·section·describes·the·locations·and·URLs·that·should·be·used·by·all·web | 116 | This·section·describes·the·locations·and·URLs·that·should·be·used·by·all·web |
| 117 | servers·and·web·applications·in·the·Debian·system. | 117 | servers·and·web·applications·in·the·Debian·system. |
| Offset 159, 15 lines modified | Offset 159, 15 lines modified | ||
| 159 | Mailboxes·are·generally·either·mode·600·and·owned·by·user·or·mode·660·and·owned | 159 | Mailboxes·are·generally·either·mode·600·and·owned·by·user·or·mode·660·and·owned |
| 160 | by·user:mail.·_\x8[_\x84_\x8]·The·local·system·administrator·may·choose·a·different | 160 | by·user:mail.·_\x8[_\x84_\x8]·The·local·system·administrator·may·choose·a·different |
| 161 | permission·scheme;·packages·should·not·make·assumptions·about·the·permission | 161 | permission·scheme;·packages·should·not·make·assumptions·about·the·permission |
| 162 | and·ownership·of·mailboxes·unless·required·(such·as·when·creating·a·new | 162 | and·ownership·of·mailboxes·unless·required·(such·as·when·creating·a·new |
| 163 | mailbox).·A·MUA·may·remove·a·mailbox·(unless·it·has·nonstandard·permissions)·in | 163 | mailbox).·A·MUA·may·remove·a·mailbox·(unless·it·has·nonstandard·permissions)·in |
| 164 | which·case·the·MTA·or·another·MUA·must·recreate·it·if·needed. | 164 | which·case·the·MTA·or·another·MUA·must·recreate·it·if·needed. |
| 165 | The·mail·spool·is·2775·root:mail,·and·MUAs·should·be·setgid·mail·to·do·the | 165 | The·mail·spool·is·2775·root:mail,·and·MUAs·should·be·setgid·mail·to·do·the |
| 166 | locking·mentioned·above·(and·must·obviously·avoid·accessing·other·users | 166 | locking·mentioned·above·(and·must·obviously·avoid·accessing·other·users’ |
| 167 | mailboxes·using·this·privilege). | 167 | mailboxes·using·this·privilege). |
| 168 | /etc/aliases·is·the·source·file·for·the·system·mail·aliases·(e.g.,·postmaster, | 168 | /etc/aliases·is·the·source·file·for·the·system·mail·aliases·(e.g.,·postmaster, |
| 169 | usenet,·etc.),·it·is·the·one·which·the·sysadmin·and·postinst·scripts·may·edit. | 169 | usenet,·etc.),·it·is·the·one·which·the·sysadmin·and·postinst·scripts·may·edit. |
| 170 | After·/etc/aliases·is·edited·the·program·or·human·editing·it·must·call | 170 | After·/etc/aliases·is·edited·the·program·or·human·editing·it·must·call |
| 171 | newaliases.·All·MTA·packages·must·come·with·a·newaliases·program,·even·if·it | 171 | newaliases.·All·MTA·packages·must·come·with·a·newaliases·program,·even·if·it |
| 172 | does·nothing,·but·older·MTA·packages·did·not·do·this·so·programs·should·not | 172 | does·nothing,·but·older·MTA·packages·did·not·do·this·so·programs·should·not |
| 173 | fail·if·newaliases·cannot·be·found.·Note·that·because·of·this,·all·MTA·packages | 173 | fail·if·newaliases·cannot·be·found.·Note·that·because·of·this,·all·MTA·packages |
| Offset 179, 19 lines modified | Offset 179, 19 lines modified | ||
| 179 | Likewise,·rsmtp,·for·receiving·batch-SMTP-over-UUCP,·should·be·/usr/sbin/rsmtp | 179 | Likewise,·rsmtp,·for·receiving·batch-SMTP-over-UUCP,·should·be·/usr/sbin/rsmtp |
| 180 | if·it·is·supported. | 180 | if·it·is·supported. |
| 181 | If·your·package·needs·to·know·what·hostname·to·use·on·(for·example)·outgoing | 181 | If·your·package·needs·to·know·what·hostname·to·use·on·(for·example)·outgoing |
| 182 | news·and·mail·messages·which·are·generated·locally,·you·should·use·the·file·/ | 182 | news·and·mail·messages·which·are·generated·locally,·you·should·use·the·file·/ |
| 183 | etc/mailname.·It·will·contain·the·portion·after·the·username·and·@·(at)·sign | 183 | etc/mailname.·It·will·contain·the·portion·after·the·username·and·@·(at)·sign |
| 184 | for·email·addresses·of·users·on·the·machine·(followed·by·a·newline). | 184 | for·email·addresses·of·users·on·the·machine·(followed·by·a·newline). |
| 185 | Such·a·package·should·check·for·the·existence·of·this·file·when·it·is·being | 185 | Such·a·package·should·check·for·the·existence·of·this·file·when·it·is·being |
| 186 | configured.·If·it·exists,·it·should·be·used·without·comment,·although·an·MTA | 186 | configured.·If·it·exists,·it·should·be·used·without·comment,·although·an·MTA’s |
| 187 | configuration·script·may·wish·to·prompt·the·user·even·if·it·finds·that·this | 187 | configuration·script·may·wish·to·prompt·the·user·even·if·it·finds·that·this |
| 188 | file·exists.·If·the·file·does·not·exist,·the·package·should·prompt·the·user·for | 188 | file·exists.·If·the·file·does·not·exist,·the·package·should·prompt·the·user·for |
| 189 | the·value·(preferably·using·debconf)·and·store·it·in·/etc/mailname·as·well·as | 189 | the·value·(preferably·using·debconf)·and·store·it·in·/etc/mailname·as·well·as |
| 190 | using·it·in·the·package | 190 | using·it·in·the·package’s·configuration.·The·prompt·should·make·it·clear·that |
| 191 | the·name·will·not·just·be·used·by·that·package.·For·example,·in·this·situation | 191 | the·name·will·not·just·be·used·by·that·package.·For·example,·in·this·situation |
| 192 | the·inn·package·could·say·something·like: | 192 | the·inn·package·could·say·something·like: |
| 193 | Please·enter·the·"mail·name"·of·your·system.··This·is·the·hostname·portion | 193 | Please·enter·the·"mail·name"·of·your·system.··This·is·the·hostname·portion |
| 194 | of·the·address·to·be·shown·on·outgoing·news·and·mail·messages.··The | 194 | of·the·address·to·be·shown·on·outgoing·news·and·mail·messages.··The |
| 195 | default·is·syshostname,·your·system's·host·name. | 195 | default·is·syshostname,·your·system's·host·name. |
| 196 | Mail·name·["syshostname"]: | 196 | Mail·name·["syshostname"]: |
| Offset 213, 15 lines modified | Offset 213, 15 lines modified | ||
| 213 | *\x8**\x8**\x8**\x8*·1\x811\x81.\x8.8\x88.\x8.1\x81.\x8.·P\x8Pr\x8ro\x8ov\x8vi\x8id\x8di\x8in\x8ng\x8g·X\x8X·s\x8su\x8up\x8pp\x8po\x8or\x8rt\x8t·a\x8an\x8nd\x8d·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·p\x8pr\x8ri\x8io\x8or\x8ri\x8it\x8ti\x8ie\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* | 213 | *\x8**\x8**\x8**\x8*·1\x811\x81.\x8.8\x88.\x8.1\x81.\x8.·P\x8Pr\x8ro\x8ov\x8vi\x8id\x8di\x8in\x8ng\x8g·X\x8X·s\x8su\x8up\x8pp\x8po\x8or\x8rt\x8t·a\x8an\x8nd\x8d·p\x8pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8e·p\x8pr\x8ri\x8io\x8or\x8ri\x8it\x8ti\x8ie\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 214 | Programs·that·can·be·configured·with·support·for·the·X·Window·System·must·be | 214 | Programs·that·can·be·configured·with·support·for·the·X·Window·System·must·be |
| 215 | configured·to·do·so·and·must·declare·any·package·dependencies·necessary·to | 215 | configured·to·do·so·and·must·declare·any·package·dependencies·necessary·to |
| 216 | satisfy·their·runtime·requirements·when·using·the·X·Window·System.·If·such·a | 216 | satisfy·their·runtime·requirements·when·using·the·X·Window·System.·If·such·a |
| 217 | package·is·of·higher·priority·than·the·X·packages·on·which·it·depends,·it·is | 217 | package·is·of·higher·priority·than·the·X·packages·on·which·it·depends,·it·is |
| 218 | required·that·either·the·X-specific·components·be·split·into·a·separate | 218 | required·that·either·the·X-specific·components·be·split·into·a·separate |
| 219 | package,·or·that·an·alternative·version·of·the·package,·which·includes·X | 219 | package,·or·that·an·alternative·version·of·the·package,·which·includes·X |
| 220 | support,·be·provided,·or·that·the·package | 220 | support,·be·provided,·or·that·the·package’s·priority·be·lowered. |
| 221 | *\x8**\x8**\x8**\x8*·1\x811\x81.\x8.8\x88.\x8.2\x82.\x8.·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s·p\x8pr\x8ro\x8ov\x8vi\x8id\x8di\x8in\x8ng\x8g·a\x8an\x8n·X\x8X·s\x8se\x8er\x8rv\x8ve\x8er\x8r_\x8?\x8·*\x8**\x8**\x8**\x8* | 221 | *\x8**\x8**\x8**\x8*·1\x811\x81.\x8.8\x88.\x8.2\x82.\x8.·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s·p\x8pr\x8ro\x8ov\x8vi\x8id\x8di\x8in\x8ng\x8g·a\x8an\x8n·X\x8X·s\x8se\x8er\x8rv\x8ve\x8er\x8r_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 222 | Packages·that·provide·an·X·server·that,·directly·or·indirectly,·communicates | 222 | Packages·that·provide·an·X·server·that,·directly·or·indirectly,·communicates |
| 223 | with·real·input·and·display·hardware·should·declare·in·their·Provides·control | 223 | with·real·input·and·display·hardware·should·declare·in·their·Provides·control |
| 224 | field·that·they·provide·the·virtual·package·xserver.·_\x8[_\x85_\x8] | 224 | field·that·they·provide·the·virtual·package·xserver.·_\x8[_\x85_\x8] |
| 225 | *\x8**\x8**\x8**\x8*·1\x811\x81.\x8.8\x88.\x8.3\x83.\x8.·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s·p\x8pr\x8ro\x8ov\x8vi\x8id\x8di\x8in\x8ng\x8g·a\x8a·t\x8te\x8er\x8rm\x8mi\x8in\x8na\x8al\x8l·e\x8em\x8mu\x8ul\x8la\x8at\x8to\x8or\x8r_\x8?\x8·*\x8**\x8**\x8**\x8* | 225 | *\x8**\x8**\x8**\x8*·1\x811\x81.\x8.8\x88.\x8.3\x83.\x8.·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s·p\x8pr\x8ro\x8ov\x8vi\x8id\x8di\x8in\x8ng\x8g·a\x8a·t\x8te\x8er\x8rm\x8mi\x8in\x8na\x8al\x8l·e\x8em\x8mu\x8ul\x8la\x8at\x8to\x8or\x8r_\x8?\x8·*\x8**\x8**\x8**\x8* |
| 226 | Packages·that·provide·a·terminal·emulator·for·the·X·Window·System·which·meet | 226 | Packages·that·provide·a·terminal·emulator·for·the·X·Window·System·which·meet |
| 227 | the·criteria·listed·below·should·declare·in·their·Provides·control·field·that | 227 | the·criteria·listed·below·should·declare·in·their·Provides·control·field·that |
| Offset 231, 15 lines modified | Offset 231, 15 lines modified | ||
| 231 | man1/x-terminal-emulator.1.gz·pointing·to·the·corresponding·manual·page. | 231 | man1/x-terminal-emulator.1.gz·pointing·to·the·corresponding·manual·page. |
| 232 | To·be·an·x-terminal-emulator,·a·program·must: | 232 | To·be·an·x-terminal-emulator,·a·program·must: |
| 233 | ····*·Be·able·to·emulate·a·DEC·VT100·terminal,·or·a·compatible·terminal. | 233 | ····*·Be·able·to·emulate·a·DEC·VT100·terminal,·or·a·compatible·terminal. |
| 234 | ····*·Support·the·command-line·option·-e·command,·which·creates·a·new·terminal | 234 | ····*·Support·the·command-line·option·-e·command,·which·creates·a·new·terminal |
| 235 | ······window·_\x8[_\x86_\x8]·and·runs·the·specified·command.·<command>·may·be·multiple | 235 | ······window·_\x8[_\x86_\x8]·and·runs·the·specified·command.·<command>·may·be·multiple |
| 236 | ······arguments,·which·form·the·argument·list·to·the·executed·program.·In·other | 236 | ······arguments,·which·form·the·argument·list·to·the·executed·program.·In·other |
| 237 | ······words,·the·behavior·is·as·though·the·arguments·were·passed·directly·to | 237 | ······words,·the·behavior·is·as·though·the·arguments·were·passed·directly·to |
| 238 | ······execvp,·bypassing·the·shell.·(xterm | 238 | ······execvp,·bypassing·the·shell.·(xterm’s·behavior·of·falling·back·on·using |
| 239 | ······the·shell·if·-e·had·a·single·argument·and·exec·failed·is·permissible·but | 239 | ······the·shell·if·-e·had·a·single·argument·and·exec·failed·is·permissible·but |
| 240 | ······not·required.) | 240 | ······not·required.) |
| 241 | ····*·Support·the·command-line·option·-T·title,·which·creates·a·new·terminal | 241 | ····*·Support·the·command-line·option·-T·title,·which·creates·a·new·terminal |
| 242 | ······window·with·the·window·title·title. | 242 | ······window·with·the·window·title·title. |
| 243 | *\x8**\x8**\x8**\x8*·1\x811\x81.\x8.8\x88.\x8.4\x84.\x8.·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s·p\x8pr\x8ro\x8ov\x8vi\x8id\x8di\x8in\x8ng\x8g·a\x8a·w\x8wi\x8in\x8nd\x8do\x8ow\x8w·m\x8ma\x8an\x8na\x8ag\x8ge\x8er\x8r_\x8?\x8·*\x8**\x8**\x8**\x8* | 243 | *\x8**\x8**\x8**\x8*·1\x811\x81.\x8.8\x88.\x8.4\x84.\x8.·P\x8Pa\x8ac\x8ck\x8ka\x8ag\x8ge\x8es\x8s·p\x8pr\x8ro\x8ov\x8vi\x8id\x8di\x8in\x8ng\x8g·a\x8a·w\x8wi\x8in\x8nd\x8do\x8ow\x8w·m\x8ma\x8an\x8na\x8ag\x8ge\x8er\x8r_\x8?\x8·*\x8**\x8**\x8**\x8* |
| Max diff block lines reached; 9658/20066 bytes (48.13%) of diff not shown. | |||
| Offset 114, 42 lines modified | Offset 114, 42 lines modified | ||
| 114 | ··<section·id="documentation"> | 114 | ··<section·id="documentation"> |
| 115 | <h1><span·class="section-number">12.·</span>Documentation<a·class="headerlink"·href="#documentation"·title="Link·to·this·heading"></a></h1> | 115 | <h1><span·class="section-number">12.·</span>Documentation<a·class="headerlink"·href="#documentation"·title="Link·to·this·heading"></a></h1> |
| 116 | <section·id="manual-pages"> | 116 | <section·id="manual-pages"> |
| 117 | <span·id="s12-1"></span><h2><span·class="section-number">12.1.·</span>Manual·pages<a·class="headerlink"·href="#manual-pages"·title="Link·to·this·heading"></a></h2> | 117 | <span·id="s12-1"></span><h2><span·class="section-number">12.1.·</span>Manual·pages<a·class="headerlink"·href="#manual-pages"·title="Link·to·this·heading"></a></h2> |
| 118 | <p>You·should·install·manual·pages·in·<code·class="docutils·literal·notranslate"><span·class="pre">nroff</span></code>·source·form,·in·appropriate | 118 | <p>You·should·install·manual·pages·in·<code·class="docutils·literal·notranslate"><span·class="pre">nroff</span></code>·source·form,·in·appropriate |
| 119 | places·under·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man</span></code>.·You·should·only·use·sections·1·to·9 | 119 | places·under·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man</span></code>.·You·should·only·use·sections·1·to·9 |
| 120 | (see·the·FHS·for·more·details).·You·must·not·install·a·pre-formatted | 120 | (see·the·FHS·for·more·details).·You·must·not·install·a·pre-formatted |
| 121 | 121 | “cat·page”.</p> | |
| 122 | <p>Each·program,·utility,·and·function·should·have·an·associated·manual | 122 | <p>Each·program,·utility,·and·function·should·have·an·associated·manual |
| 123 | page·included·in·the·same·package·or·a·dependency.·It·is·suggested·that | 123 | page·included·in·the·same·package·or·a·dependency.·It·is·suggested·that |
| 124 | all·configuration·files·also·have·a·manual·page·included·as·well. | 124 | all·configuration·files·also·have·a·manual·page·included·as·well. |
| 125 | Manual·pages·for·protocols·and·other·auxiliary·things·are·optional.</p> | 125 | Manual·pages·for·protocols·and·other·auxiliary·things·are·optional.</p> |
| 126 | <p>If·no·manual·page·is·available,·this·is·considered·as·a·bug·and·should | 126 | <p>If·no·manual·page·is·available,·this·is·considered·as·a·bug·and·should |
| 127 | be·reported·to·the·Debian·Bug·Tracking·System·(the·maintainer·of·the | 127 | be·reported·to·the·Debian·Bug·Tracking·System·(the·maintainer·of·the |
| 128 | package·is·allowed·to·write·this·bug·report·themselves,·if·they·so | 128 | package·is·allowed·to·write·this·bug·report·themselves,·if·they·so |
| 129 | desire).·Do·not·close·the·bug·report·until·a·proper·man·page·is | 129 | desire).·Do·not·close·the·bug·report·until·a·proper·man·page·is |
| 130 | available.··<a·class="footnote-reference·brackets"·href="#id11"·id="id1"·role="doc-noteref"><span·class="fn-bracket">[</span>1<span·class="fn-bracket">]</span></a></p> | 130 | available.··<a·class="footnote-reference·brackets"·href="#id11"·id="id1"·role="doc-noteref"><span·class="fn-bracket">[</span>1<span·class="fn-bracket">]</span></a></p> |
| 131 | <p>You·may·forward·a·complaint·about·a·missing·man·page·to·the·upstream | 131 | <p>You·may·forward·a·complaint·about·a·missing·man·page·to·the·upstream |
| 132 | authors,·and·mark·the·bug·as·forwarded·in·the·Debian·bug·tracking | 132 | authors,·and·mark·the·bug·as·forwarded·in·the·Debian·bug·tracking |
| 133 | system.·Even·though·the·GNU·Project·do·not·in·general·consider·the·lack | 133 | system.·Even·though·the·GNU·Project·do·not·in·general·consider·the·lack |
| 134 | of·a·man·page·to·be·a·bug,·we·do;·if·they·tell·you·that·they·don | 134 | of·a·man·page·to·be·a·bug,·we·do;·if·they·tell·you·that·they·don’t |
| 135 | consider·it·a·bug·you·should·leave·the·bug·in·our·bug·tracking·system | 135 | consider·it·a·bug·you·should·leave·the·bug·in·our·bug·tracking·system |
| 136 | open·anyway.</p> | 136 | open·anyway.</p> |
| 137 | <p>Manual·pages·should·be·installed·compressed·using·<code·class="docutils·literal·notranslate"><span·class="pre">gzip</span>·<span·class="pre">-9</span></code>.</p> | 137 | <p>Manual·pages·should·be·installed·compressed·using·<code·class="docutils·literal·notranslate"><span·class="pre">gzip</span>·<span·class="pre">-9</span></code>.</p> |
| 138 | <p>If·one·man·page·needs·to·be·accessible·via·several·names·it·is·better·to | 138 | <p>If·one·man·page·needs·to·be·accessible·via·several·names·it·is·better·to |
| 139 | use·a·symbolic·link·than·the·<code·class="docutils·literal·notranslate"><span·class="pre">.so</span></code>·feature,·but·there·is·no·need·to | 139 | use·a·symbolic·link·than·the·<code·class="docutils·literal·notranslate"><span·class="pre">.so</span></code>·feature,·but·there·is·no·need·to |
| 140 | fiddle·with·the·relevant·parts·of·the·upstream·source·to·change·from | 140 | fiddle·with·the·relevant·parts·of·the·upstream·source·to·change·from |
| 141 | <code·class="docutils·literal·notranslate"><span·class="pre">.so</span></code>·to·symlinks:·don | 141 | <code·class="docutils·literal·notranslate"><span·class="pre">.so</span></code>·to·symlinks:·don’t·do·it·unless·it’s·easy.·You·should·not·create |
| 142 | hard·links·in·the·manual·page·directories,·nor·put·absolute·filenames·in | 142 | hard·links·in·the·manual·page·directories,·nor·put·absolute·filenames·in |
| 143 | <code·class="docutils·literal·notranslate"><span·class="pre">.so</span></code>·directives.·The·filename·in·a·<code·class="docutils·literal·notranslate"><span·class="pre">.so</span></code>·in·a·man·page·should·be | 143 | <code·class="docutils·literal·notranslate"><span·class="pre">.so</span></code>·directives.·The·filename·in·a·<code·class="docutils·literal·notranslate"><span·class="pre">.so</span></code>·in·a·man·page·should·be |
| 144 | relative·to·the·base·of·the·man·page·tree·(usually·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man</span></code>). | 144 | relative·to·the·base·of·the·man·page·tree·(usually·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man</span></code>). |
| 145 | If·you·do·not·create·any·links·(whether·symlinks,·hard·links,·or·<code·class="docutils·literal·notranslate"><span·class="pre">.so</span></code> | 145 | If·you·do·not·create·any·links·(whether·symlinks,·hard·links,·or·<code·class="docutils·literal·notranslate"><span·class="pre">.so</span></code> |
| 146 | directives)·in·the·file·system·to·the·alternate·names·of·the·man·page, | 146 | directives)·in·the·file·system·to·the·alternate·names·of·the·man·page, |
| 147 | then·you·should·not·rely·on·<code·class="docutils·literal·notranslate"><span·class="pre">man</span></code>·finding·your·man·page·under·those | 147 | then·you·should·not·rely·on·<code·class="docutils·literal·notranslate"><span·class="pre">man</span></code>·finding·your·man·page·under·those |
| 148 | names·based·solely·on·the·information·in·the·man·page | 148 | names·based·solely·on·the·information·in·the·man·page’s·header.··<a·class="footnote-reference·brackets"·href="#id12"·id="id2"·role="doc-noteref"><span·class="fn-bracket">[</span>2<span·class="fn-bracket">]</span></a></p> |
| 149 | <p>Manual·pages·in·locale-specific·subdirectories·of·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man</span></code> | 149 | <p>Manual·pages·in·locale-specific·subdirectories·of·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man</span></code> |
| 150 | should·use·either·UTF-8·or·the·usual·legacy·encoding·for·that·language | 150 | should·use·either·UTF-8·or·the·usual·legacy·encoding·for·that·language |
| 151 | (normally·the·one·corresponding·to·the·shortest·relevant·locale·name·in | 151 | (normally·the·one·corresponding·to·the·shortest·relevant·locale·name·in |
| 152 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/i18n/SUPPORTED</span></code>).·For·example,·pages·under | 152 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/i18n/SUPPORTED</span></code>).·For·example,·pages·under |
| 153 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man/fr</span></code>·should·use·either·UTF-8·or·ISO-8859-1.··<a·class="footnote-reference·brackets"·href="#id13"·id="id3"·role="doc-noteref"><span·class="fn-bracket">[</span>3<span·class="fn-bracket">]</span></a></p> | 153 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man/fr</span></code>·should·use·either·UTF-8·or·ISO-8859-1.··<a·class="footnote-reference·brackets"·href="#id13"·id="id3"·role="doc-noteref"><span·class="fn-bracket">[</span>3<span·class="fn-bracket">]</span></a></p> |
| 154 | <p>A·country·name·(the·<code·class="docutils·literal·notranslate"><span·class="pre">DE</span></code>·in·<code·class="docutils·literal·notranslate"><span·class="pre">de_DE</span></code>)·should·not·be·included·in·the | 154 | <p>A·country·name·(the·<code·class="docutils·literal·notranslate"><span·class="pre">DE</span></code>·in·<code·class="docutils·literal·notranslate"><span·class="pre">de_DE</span></code>)·should·not·be·included·in·the |
| 155 | subdirectory·name·unless·it·indicates·a·significant·difference·in·the | 155 | subdirectory·name·unless·it·indicates·a·significant·difference·in·the |
| Offset 160, 15 lines modified | Offset 160, 15 lines modified | ||
| 160 | the·original·manual·page·should·be·used·instead.·This·can·be·done·either | 160 | the·original·manual·page·should·be·used·instead.·This·can·be·done·either |
| 161 | by·a·note·at·the·beginning·of·the·manual·page·or·by·showing·the·missing | 161 | by·a·note·at·the·beginning·of·the·manual·page·or·by·showing·the·missing |
| 162 | or·changed·portions·in·the·original·language·instead·of·the·target | 162 | or·changed·portions·in·the·original·language·instead·of·the·target |
| 163 | language.</p> | 163 | language.</p> |
| 164 | <p>Packages·(other·than·manual·page·readers)·must·not·require·the·existence | 164 | <p>Packages·(other·than·manual·page·readers)·must·not·require·the·existence |
| 165 | of·any·files·in·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man/</span></code>·in·order·to·function.·A·package·that | 165 | of·any·files·in·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/man/</span></code>·in·order·to·function.·A·package·that |
| 166 | optionally·displays·its·own·manual·pages,·such·as·to·provide·user·help, | 166 | optionally·displays·its·own·manual·pages,·such·as·to·provide·user·help, |
| 167 | must·fail·gracefully·if·the·manual·pages·aren | 167 | must·fail·gracefully·if·the·manual·pages·aren’t·installed.</p> |
| 168 | </section> | 168 | </section> |
| 169 | <section·id="info-documents"> | 169 | <section·id="info-documents"> |
| 170 | <span·id="s12-2"></span><h2><span·class="section-number">12.2.·</span>Info·documents<a·class="headerlink"·href="#info-documents"·title="Link·to·this·heading"></a></h2> | 170 | <span·id="s12-2"></span><h2><span·class="section-number">12.2.·</span>Info·documents<a·class="headerlink"·href="#info-documents"·title="Link·to·this·heading"></a></h2> |
| 171 | <p>Info·documents·should·be·installed·in·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/info</span></code>.·They·should | 171 | <p>Info·documents·should·be·installed·in·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/info</span></code>.·They·should |
| 172 | be·compressed·with·<code·class="docutils·literal·notranslate"><span·class="pre">gzip</span>·<span·class="pre">-9</span></code>.</p> | 172 | be·compressed·with·<code·class="docutils·literal·notranslate"><span·class="pre">gzip</span>·<span·class="pre">-9</span></code>.</p> |
| 173 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">install-info</span></code>·program·maintains·a·directory·of·installed·info | 173 | <p>The·<code·class="docutils·literal·notranslate"><span·class="pre">install-info</span></code>·program·maintains·a·directory·of·installed·info |
| 174 | documents·in·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/info/dir</span></code>·for·the·use·of·info·readers.·This | 174 | documents·in·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/info/dir</span></code>·for·the·use·of·info·readers.·This |
| Offset 200, 15 lines modified | Offset 200, 15 lines modified | ||
| 200 | </section> | 200 | </section> |
| 201 | <section·id="additional-documentation"> | 201 | <section·id="additional-documentation"> |
| 202 | <span·id="s-docs-additional"></span><h2><span·class="section-number">12.3.·</span>Additional·documentation<a·class="headerlink"·href="#additional-documentation"·title="Link·to·this·heading"></a></h2> | 202 | <span·id="s-docs-additional"></span><h2><span·class="section-number">12.3.·</span>Additional·documentation<a·class="headerlink"·href="#additional-documentation"·title="Link·to·this·heading"></a></h2> |
| 203 | <p>Any·additional·documentation·that·comes·with·the·package·may·be | 203 | <p>Any·additional·documentation·that·comes·with·the·package·may·be |
| 204 | installed·at·the·discretion·of·the·package·maintainer.·It·is·often·a | 204 | installed·at·the·discretion·of·the·package·maintainer.·It·is·often·a |
| 205 | good·idea·to·include·text·information·files·(<code·class="docutils·literal·notranslate"><span·class="pre">README</span></code>s,·FAQs,·and·so | 205 | good·idea·to·include·text·information·files·(<code·class="docutils·literal·notranslate"><span·class="pre">README</span></code>s,·FAQs,·and·so |
| 206 | forth)·that·come·with·the·source·package·in·the·binary·package.·However, | 206 | forth)·that·come·with·the·source·package·in·the·binary·package.·However, |
| 207 | you·don | 207 | you·don’t·need·to·install·the·instructions·for·building·and·installing |
| 208 | the·package,·of·course!</p> | 208 | the·package,·of·course!</p> |
| 209 | <p>Plain·text·documentation·should·be·compressed·with·<code·class="docutils·literal·notranslate"><span·class="pre">gzip</span>·<span·class="pre">-9</span></code>·unless·it·is·small.</p> | 209 | <p>Plain·text·documentation·should·be·compressed·with·<code·class="docutils·literal·notranslate"><span·class="pre">gzip</span>·<span·class="pre">-9</span></code>·unless·it·is·small.</p> |
| 210 | <p>If·a·package·comes·with·large·amounts·of·documentation·that·many·users | 210 | <p>If·a·package·comes·with·large·amounts·of·documentation·that·many·users |
| 211 | of·the·package·will·not·require,·you·should·create·a·separate·binary | 211 | of·the·package·will·not·require,·you·should·create·a·separate·binary |
| 212 | package·to·contain·it·so·that·it·does·not·take·up·disk·space·on·the | 212 | package·to·contain·it·so·that·it·does·not·take·up·disk·space·on·the |
| 213 | machines·of·users·who·do·not·need·or·want·it·installed.·As·a·special | 213 | machines·of·users·who·do·not·need·or·want·it·installed.·As·a·special |
| 214 | case·of·this·rule,·shared·library·documentation·of·any·appreciable·size | 214 | case·of·this·rule,·shared·library·documentation·of·any·appreciable·size |
| Offset 254, 22 lines modified | Offset 254, 22 lines modified | ||
| 254 | <span·id="s12-4"></span><h2><span·class="section-number">12.4.·</span>Preferred·documentation·formats<a·class="headerlink"·href="#preferred-documentation-formats"·title="Link·to·this·heading"></a></h2> | 254 | <span·id="s12-4"></span><h2><span·class="section-number">12.4.·</span>Preferred·documentation·formats<a·class="headerlink"·href="#preferred-documentation-formats"·title="Link·to·this·heading"></a></h2> |
| 255 | <p>The·unification·of·Debian·documentation·is·being·carried·out·via·HTML.</p> | 255 | <p>The·unification·of·Debian·documentation·is·being·carried·out·via·HTML.</p> |
| 256 | <p>If·the·package·comes·with·extensive·documentation·in·a·markup·format | 256 | <p>If·the·package·comes·with·extensive·documentation·in·a·markup·format |
| 257 | that·can·be·converted·to·various·other·formats·you·should·if·possible | 257 | that·can·be·converted·to·various·other·formats·you·should·if·possible |
| 258 | ship·HTML·versions·in·a·binary·package.··<a·class="footnote-reference·brackets"·href="#id18"·id="id8"·role="doc-noteref"><span·class="fn-bracket">[</span>8<span·class="fn-bracket">]</span></a>·The·documentation·must | 258 | ship·HTML·versions·in·a·binary·package.··<a·class="footnote-reference·brackets"·href="#id18"·id="id8"·role="doc-noteref"><span·class="fn-bracket">[</span>8<span·class="fn-bracket">]</span></a>·The·documentation·must |
| 259 | be·installed·as·specified·in·<a·class="reference·internal"·href="#s-docs-additional"><span·class="std·std-ref">Additional·documentation</span></a>.</p> | 259 | be·installed·as·specified·in·<a·class="reference·internal"·href="#s-docs-additional"><span·class="std·std-ref">Additional·documentation</span></a>.</p> |
| 260 | <p>Other·formats·such·as·PostScript·may·be·provided·at·the·package | 260 | <p>Other·formats·such·as·PostScript·may·be·provided·at·the·package |
| 261 | maintainer | 261 | maintainer’s·discretion.</p> |
| 262 | </section> | 262 | </section> |
| 263 | <section·id="copyright-information"> | 263 | <section·id="copyright-information"> |
| 264 | <span·id="s-copyrightfile"></span><h2><span·class="section-number">12.5.·</span>Copyright·information<a·class="headerlink"·href="#copyright-information"·title="Link·to·this·heading"></a></h2> | 264 | <span·id="s-copyrightfile"></span><h2><span·class="section-number">12.5.·</span>Copyright·information<a·class="headerlink"·href="#copyright-information"·title="Link·to·this·heading"></a></h2> |
| 265 | <p>Every·package·must·be·accompanied·by·a·verbatim·copy·of·its | 265 | <p>Every·package·must·be·accompanied·by·a·verbatim·copy·of·its |
| 266 | distribution·license(s)·in·the·file·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/PACKAGE/copyright</span></code>. | 266 | distribution·license(s)·in·the·file·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/PACKAGE/copyright</span></code>. |
| 267 | This·file·must·neither·be·compressed·nor·be·a·symbolic·link.</p> | 267 | This·file·must·neither·be·compressed·nor·be·a·symbolic·link.</p> |
| 268 | <p>A·verbatim·copy·of·the·package | 268 | <p>A·verbatim·copy·of·the·package’s·copyright·information·is·often |
| 269 | required·to·be·present·in·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/PACKAGE/copyright</span></code>,·too; | 269 | required·to·be·present·in·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/PACKAGE/copyright</span></code>,·too; |
| 270 | see·<a·class="reference·internal"·href="ch-archive.html#s-pkgcopyright"><span·class="std·std-ref">Copyright·considerations</span></a>.</p> | 270 | see·<a·class="reference·internal"·href="ch-archive.html#s-pkgcopyright"><span·class="std·std-ref">Copyright·considerations</span></a>.</p> |
| 271 | <p>In·addition,·the·copyright·file·must·say·where·the·upstream·sources·(if | 271 | <p>In·addition,·the·copyright·file·must·say·where·the·upstream·sources·(if |
| 272 | any)·were·obtained,·and·should·include·a·name·or·contact·address·for·the | 272 | any)·were·obtained,·and·should·include·a·name·or·contact·address·for·the |
| 273 | upstream·authors.·This·can·be·the·name·of·an·individual·or·an | 273 | upstream·authors.·This·can·be·the·name·of·an·individual·or·an |
| 274 | organization,·an·email·address,·a·web·forum·or·bugtracker,·or·any·other | 274 | organization,·an·email·address,·a·web·forum·or·bugtracker,·or·any·other |
| 275 | means·to·unambiguously·identify·who·to·contact·to·participate·in·the | 275 | means·to·unambiguously·identify·who·to·contact·to·participate·in·the |
| Offset 308, 15 lines modified | Offset 308, 15 lines modified | ||
| 308 | <p>Use·of·this·format·is·optional.</p> | 308 | <p>Use·of·this·format·is·optional.</p> |
| 309 | </section> | 309 | </section> |
| 310 | </section> | 310 | </section> |
| 311 | <section·id="examples"> | 311 | <section·id="examples"> |
| 312 | <span·id="s12-6"></span><h2><span·class="section-number">12.6.·</span>Examples<a·class="headerlink"·href="#examples"·title="Link·to·this·heading"></a></h2> | 312 | <span·id="s12-6"></span><h2><span·class="section-number">12.6.·</span>Examples<a·class="headerlink"·href="#examples"·title="Link·to·this·heading"></a></h2> |
| 313 | <p>Any·examples·(configurations,·source·files,·whatever),·should·be | 313 | <p>Any·examples·(configurations,·source·files,·whatever),·should·be |
| 314 | installed·in·a·directory·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/package/examples</span></code>.·These | 314 | installed·in·a·directory·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/package/examples</span></code>.·These |
| 315 | files·should·not·be·referenced·by·any·program:·they | 315 | files·should·not·be·referenced·by·any·program:·they’re·there·for·the |
| 316 | benefit·of·the·system·administrator·and·users·as·documentation·only. | 316 | benefit·of·the·system·administrator·and·users·as·documentation·only. |
| 317 | Architecture-specific·example·files·should·be·installed·in·a·directory | 317 | Architecture-specific·example·files·should·be·installed·in·a·directory |
| 318 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/lib/package/examples</span></code>·with·symbolic·links·to·them·from | 318 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/lib/package/examples</span></code>·with·symbolic·links·to·them·from |
| 319 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/package/examples</span></code>,·or·the·latter·directory·itself·may | 319 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/package/examples</span></code>,·or·the·latter·directory·itself·may |
| 320 | be·a·symbolic·link·to·the·former.</p> | 320 | be·a·symbolic·link·to·the·former.</p> |
| 321 | <p>If·the·purpose·of·a·package·is·to·provide·examples,·then·the·example | 321 | <p>If·the·purpose·of·a·package·is·to·provide·examples,·then·the·example |
| 322 | files·may·be·installed·into·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/package</span></code>.</p> | 322 | files·may·be·installed·into·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/package</span></code>.</p> |
| Offset 337, 15 lines modified | Offset 337, 15 lines modified | ||
| 337 | <p>If·either·of·these·files·are·distributed·in·HTML,·they·should·be·made | 337 | <p>If·either·of·these·files·are·distributed·in·HTML,·they·should·be·made |
| 338 | available·at·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/package/NEWS.html.gz</span></code>·and | 338 | available·at·<code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/package/NEWS.html.gz</span></code>·and |
| 339 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/package/changelog.html.gz</span></code>·respectively,·and·plain | 339 | <code·class="docutils·literal·notranslate"><span·class="pre">/usr/share/doc/package/changelog.html.gz</span></code>·respectively,·and·plain |
| 340 | text·versions·<code·class="docutils·literal·notranslate"><span·class="pre">NEWS.gz</span></code>·and·<code·class="docutils·literal·notranslate"><span·class="pre">changelog.gz</span></code>·should·be·generated | 340 | text·versions·<code·class="docutils·literal·notranslate"><span·class="pre">NEWS.gz</span></code>·and·<code·class="docutils·literal·notranslate"><span·class="pre">changelog.gz</span></code>·should·be·generated |
| 341 | from·them,·using,·for·example,·<code·class="docutils·literal·notranslate"><span·class="pre">lynx</span>·<span·class="pre">-dump</span>·<span·class="pre">-nolist</span></code>.</p> | 341 | from·them,·using,·for·example,·<code·class="docutils·literal·notranslate"><span·class="pre">lynx</span>·<span·class="pre">-dump</span>·<span·class="pre">-nolist</span></code>.</p> |
| 342 | <p>If·the·upstream·release·notes·or·changelog·do·not·already·conform·to | 342 | <p>If·the·upstream·release·notes·or·changelog·do·not·already·conform·to |
| 343 | this·naming·convention,·then·this·may·be·achieved·either·by·renaming | 343 | this·naming·convention,·then·this·may·be·achieved·either·by·renaming |
| 344 | the·files,·or·by·adding·a·symbolic·link,·at·the·maintainer | 344 | the·files,·or·by·adding·a·symbolic·link,·at·the·maintainer’s |
| 345 | discretion.··<a·class="footnote-reference·brackets"·href="#id20"·id="id10"·role="doc-noteref"><span·class="fn-bracket">[</span>10<span·class="fn-bracket">]</span></a></p> | 345 | discretion.··<a·class="footnote-reference·brackets"·href="#id20"·id="id10"·role="doc-noteref"><span·class="fn-bracket">[</span>10<span·class="fn-bracket">]</span></a></p> |
| 346 | <p>All·of·these·files·should·be·installed·compressed·using·<code·class="docutils·literal·notranslate"><span·class="pre">gzip</span>·<span·class="pre">-9</span></code>,·as | 346 | <p>All·of·these·files·should·be·installed·compressed·using·<code·class="docutils·literal·notranslate"><span·class="pre">gzip</span>·<span·class="pre">-9</span></code>,·as |
| 347 | they·will·become·large·with·time·even·if·they·start·out·small.</p> | 347 | they·will·become·large·with·time·even·if·they·start·out·small.</p> |
| 348 | <p>If·the·package·has·only·one·file·which·is·used·both·as·the·Debian | 348 | <p>If·the·package·has·only·one·file·which·is·used·both·as·the·Debian |
| 349 | changelog·and·the·upstream·release·notes·or·changelog,·because·there | 349 | changelog·and·the·upstream·release·notes·or·changelog,·because·there |
| Max diff block lines reached; 1548/14461 bytes (10.70%) of diff not shown. | |||
| Offset 39, 39 lines modified | Offset 39, 39 lines modified | ||
| 39 | ····*·_\x8V_\x8i_\x8e_\x8w_\x8·_\x8p_\x8a_\x8g_\x8e_\x8·_\x8s_\x8o_\x8u_\x8r_\x8c_\x8e | 39 | ····*·_\x8V_\x8i_\x8e_\x8w_\x8·_\x8p_\x8a_\x8g_\x8e_\x8·_\x8s_\x8o_\x8u_\x8r_\x8c_\x8e |
| 40 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t | 40 | _\x8P_\x8r_\x8e_\x8v_\x8i_\x8o_\x8u_\x8s·_\x8N_\x8e_\x8x_\x8t |
| 41 | =============================================================================== | 41 | =============================================================================== |
| 42 | *\x8**\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.·D\x8Do\x8oc\x8cu\x8um\x8me\x8en\x8nt\x8ta\x8at\x8ti\x8io\x8on\x8n_\x8?\x8·*\x8**\x8**\x8**\x8**\x8**\x8* | 42 | *\x8**\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.·D\x8Do\x8oc\x8cu\x8um\x8me\x8en\x8nt\x8ta\x8at\x8ti\x8io\x8on\x8n_\x8?\x8·*\x8**\x8**\x8**\x8**\x8**\x8* |
| 43 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.1\x81.\x8.·M\x8Ma\x8an\x8nu\x8ua\x8al\x8l·p\x8pa\x8ag\x8ge\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 43 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.1\x81.\x8.·M\x8Ma\x8an\x8nu\x8ua\x8al\x8l·p\x8pa\x8ag\x8ge\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 44 | You·should·install·manual·pages·in·nroff·source·form,·in·appropriate·places | 44 | You·should·install·manual·pages·in·nroff·source·form,·in·appropriate·places |
| 45 | under·/usr/share/man.·You·should·only·use·sections·1·to·9·(see·the·FHS·for·more | 45 | under·/usr/share/man.·You·should·only·use·sections·1·to·9·(see·the·FHS·for·more |
| 46 | details).·You·must·not·install·a·pre-formatted· | 46 | details).·You·must·not·install·a·pre-formatted·“cat·page”. |
| 47 | Each·program,·utility,·and·function·should·have·an·associated·manual·page | 47 | Each·program,·utility,·and·function·should·have·an·associated·manual·page |
| 48 | included·in·the·same·package·or·a·dependency.·It·is·suggested·that·all | 48 | included·in·the·same·package·or·a·dependency.·It·is·suggested·that·all |
| 49 | configuration·files·also·have·a·manual·page·included·as·well.·Manual·pages·for | 49 | configuration·files·also·have·a·manual·page·included·as·well.·Manual·pages·for |
| 50 | protocols·and·other·auxiliary·things·are·optional. | 50 | protocols·and·other·auxiliary·things·are·optional. |
| 51 | If·no·manual·page·is·available,·this·is·considered·as·a·bug·and·should·be | 51 | If·no·manual·page·is·available,·this·is·considered·as·a·bug·and·should·be |
| 52 | reported·to·the·Debian·Bug·Tracking·System·(the·maintainer·of·the·package·is | 52 | reported·to·the·Debian·Bug·Tracking·System·(the·maintainer·of·the·package·is |
| 53 | allowed·to·write·this·bug·report·themselves,·if·they·so·desire).·Do·not·close | 53 | allowed·to·write·this·bug·report·themselves,·if·they·so·desire).·Do·not·close |
| 54 | the·bug·report·until·a·proper·man·page·is·available.·_\x8[_\x81_\x8] | 54 | the·bug·report·until·a·proper·man·page·is·available.·_\x8[_\x81_\x8] |
| 55 | You·may·forward·a·complaint·about·a·missing·man·page·to·the·upstream·authors, | 55 | You·may·forward·a·complaint·about·a·missing·man·page·to·the·upstream·authors, |
| 56 | and·mark·the·bug·as·forwarded·in·the·Debian·bug·tracking·system.·Even·though | 56 | and·mark·the·bug·as·forwarded·in·the·Debian·bug·tracking·system.·Even·though |
| 57 | the·GNU·Project·do·not·in·general·consider·the·lack·of·a·man·page·to·be·a·bug, | 57 | the·GNU·Project·do·not·in·general·consider·the·lack·of·a·man·page·to·be·a·bug, |
| 58 | we·do;·if·they·tell·you·that·they·don | 58 | we·do;·if·they·tell·you·that·they·don’t·consider·it·a·bug·you·should·leave·the |
| 59 | bug·in·our·bug·tracking·system·open·anyway. | 59 | bug·in·our·bug·tracking·system·open·anyway. |
| 60 | Manual·pages·should·be·installed·compressed·using·gzip·-9. | 60 | Manual·pages·should·be·installed·compressed·using·gzip·-9. |
| 61 | If·one·man·page·needs·to·be·accessible·via·several·names·it·is·better·to·use·a | 61 | If·one·man·page·needs·to·be·accessible·via·several·names·it·is·better·to·use·a |
| 62 | symbolic·link·than·the·.so·feature,·but·there·is·no·need·to·fiddle·with·the | 62 | symbolic·link·than·the·.so·feature,·but·there·is·no·need·to·fiddle·with·the |
| 63 | relevant·parts·of·the·upstream·source·to·change·from·.so·to·symlinks:·don | 63 | relevant·parts·of·the·upstream·source·to·change·from·.so·to·symlinks:·don’t·do |
| 64 | it·unless·it | 64 | it·unless·it’s·easy.·You·should·not·create·hard·links·in·the·manual·page |
| 65 | directories,·nor·put·absolute·filenames·in·.so·directives.·The·filename·in·a | 65 | directories,·nor·put·absolute·filenames·in·.so·directives.·The·filename·in·a |
| 66 | .so·in·a·man·page·should·be·relative·to·the·base·of·the·man·page·tree·(usually | 66 | .so·in·a·man·page·should·be·relative·to·the·base·of·the·man·page·tree·(usually |
| 67 | /usr/share/man).·If·you·do·not·create·any·links·(whether·symlinks,·hard·links, | 67 | /usr/share/man).·If·you·do·not·create·any·links·(whether·symlinks,·hard·links, |
| 68 | or·.so·directives)·in·the·file·system·to·the·alternate·names·of·the·man·page, | 68 | or·.so·directives)·in·the·file·system·to·the·alternate·names·of·the·man·page, |
| 69 | then·you·should·not·rely·on·man·finding·your·man·page·under·those·names·based | 69 | then·you·should·not·rely·on·man·finding·your·man·page·under·those·names·based |
| 70 | solely·on·the·information·in·the·man·page | 70 | solely·on·the·information·in·the·man·page’s·header.·_\x8[_\x82_\x8] |
| 71 | Manual·pages·in·locale-specific·subdirectories·of·/usr/share/man·should·use | 71 | Manual·pages·in·locale-specific·subdirectories·of·/usr/share/man·should·use |
| 72 | either·UTF-8·or·the·usual·legacy·encoding·for·that·language·(normally·the·one | 72 | either·UTF-8·or·the·usual·legacy·encoding·for·that·language·(normally·the·one |
| 73 | corresponding·to·the·shortest·relevant·locale·name·in·/usr/share/i18n/ | 73 | corresponding·to·the·shortest·relevant·locale·name·in·/usr/share/i18n/ |
| 74 | SUPPORTED).·For·example,·pages·under·/usr/share/man/fr·should·use·either·UTF- | 74 | SUPPORTED).·For·example,·pages·under·/usr/share/man/fr·should·use·either·UTF- |
| 75 | 8·or·ISO-8859-1.·_\x8[_\x83_\x8] | 75 | 8·or·ISO-8859-1.·_\x8[_\x83_\x8] |
| 76 | A·country·name·(the·DE·in·de_DE)·should·not·be·included·in·the·subdirectory | 76 | A·country·name·(the·DE·in·de_DE)·should·not·be·included·in·the·subdirectory |
| 77 | name·unless·it·indicates·a·significant·difference·in·the·language,·as·this | 77 | name·unless·it·indicates·a·significant·difference·in·the·language,·as·this |
| Offset 80, 15 lines modified | Offset 80, 15 lines modified | ||
| 80 | date·or·it·should·be·obvious·to·the·reader·that·it·is·outdated·and·the·original | 80 | date·or·it·should·be·obvious·to·the·reader·that·it·is·outdated·and·the·original |
| 81 | manual·page·should·be·used·instead.·This·can·be·done·either·by·a·note·at·the | 81 | manual·page·should·be·used·instead.·This·can·be·done·either·by·a·note·at·the |
| 82 | beginning·of·the·manual·page·or·by·showing·the·missing·or·changed·portions·in | 82 | beginning·of·the·manual·page·or·by·showing·the·missing·or·changed·portions·in |
| 83 | the·original·language·instead·of·the·target·language. | 83 | the·original·language·instead·of·the·target·language. |
| 84 | Packages·(other·than·manual·page·readers)·must·not·require·the·existence·of·any | 84 | Packages·(other·than·manual·page·readers)·must·not·require·the·existence·of·any |
| 85 | files·in·/usr/share/man/·in·order·to·function.·A·package·that·optionally | 85 | files·in·/usr/share/man/·in·order·to·function.·A·package·that·optionally |
| 86 | displays·its·own·manual·pages,·such·as·to·provide·user·help,·must·fail | 86 | displays·its·own·manual·pages,·such·as·to·provide·user·help,·must·fail |
| 87 | gracefully·if·the·manual·pages·aren | 87 | gracefully·if·the·manual·pages·aren’t·installed. |
| 88 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.2\x82.\x8.·I\x8In\x8nf\x8fo\x8o·d\x8do\x8oc\x8cu\x8um\x8me\x8en\x8nt\x8ts\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 88 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.2\x82.\x8.·I\x8In\x8nf\x8fo\x8o·d\x8do\x8oc\x8cu\x8um\x8me\x8en\x8nt\x8ts\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 89 | Info·documents·should·be·installed·in·/usr/share/info.·They·should·be | 89 | Info·documents·should·be·installed·in·/usr/share/info.·They·should·be |
| 90 | compressed·with·gzip·-9. | 90 | compressed·with·gzip·-9. |
| 91 | The·install-info·program·maintains·a·directory·of·installed·info·documents·in·/ | 91 | The·install-info·program·maintains·a·directory·of·installed·info·documents·in·/ |
| 92 | usr/share/info/dir·for·the·use·of·info·readers.·This·file·must·not·be·included | 92 | usr/share/info/dir·for·the·use·of·info·readers.·This·file·must·not·be·included |
| 93 | in·packages·other·than·install-info. | 93 | in·packages·other·than·install-info. |
| 94 | install-info·is·automatically·invoked·when·appropriate·using·dpkg·triggers. | 94 | install-info·is·automatically·invoked·when·appropriate·using·dpkg·triggers. |
| Offset 110, 15 lines modified | Offset 110, 15 lines modified | ||
| 110 | the·current·sections·are·relevant).·_\x8[_\x85_\x8] | 110 | the·current·sections·are·relevant).·_\x8[_\x85_\x8] |
| 111 | Packages·(other·than·info·readers)·must·not·require·the·existence·of·any·files | 111 | Packages·(other·than·info·readers)·must·not·require·the·existence·of·any·files |
| 112 | in·/usr/share/info/·in·order·to·function. | 112 | in·/usr/share/info/·in·order·to·function. |
| 113 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.3\x83.\x8.·A\x8Ad\x8dd\x8di\x8it\x8ti\x8io\x8on\x8na\x8al\x8l·d\x8do\x8oc\x8cu\x8um\x8me\x8en\x8nt\x8ta\x8at\x8ti\x8io\x8on\x8n_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 113 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.3\x83.\x8.·A\x8Ad\x8dd\x8di\x8it\x8ti\x8io\x8on\x8na\x8al\x8l·d\x8do\x8oc\x8cu\x8um\x8me\x8en\x8nt\x8ta\x8at\x8ti\x8io\x8on\x8n_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 114 | Any·additional·documentation·that·comes·with·the·package·may·be·installed·at | 114 | Any·additional·documentation·that·comes·with·the·package·may·be·installed·at |
| 115 | the·discretion·of·the·package·maintainer.·It·is·often·a·good·idea·to·include | 115 | the·discretion·of·the·package·maintainer.·It·is·often·a·good·idea·to·include |
| 116 | text·information·files·(READMEs,·FAQs,·and·so·forth)·that·come·with·the·source | 116 | text·information·files·(READMEs,·FAQs,·and·so·forth)·that·come·with·the·source |
| 117 | package·in·the·binary·package.·However,·you·don | 117 | package·in·the·binary·package.·However,·you·don’t·need·to·install·the |
| 118 | instructions·for·building·and·installing·the·package,·of·course! | 118 | instructions·for·building·and·installing·the·package,·of·course! |
| 119 | Plain·text·documentation·should·be·compressed·with·gzip·-9·unless·it·is·small. | 119 | Plain·text·documentation·should·be·compressed·with·gzip·-9·unless·it·is·small. |
| 120 | If·a·package·comes·with·large·amounts·of·documentation·that·many·users·of·the | 120 | If·a·package·comes·with·large·amounts·of·documentation·that·many·users·of·the |
| 121 | package·will·not·require,·you·should·create·a·separate·binary·package·to | 121 | package·will·not·require,·you·should·create·a·separate·binary·package·to |
| 122 | contain·it·so·that·it·does·not·take·up·disk·space·on·the·machines·of·users·who | 122 | contain·it·so·that·it·does·not·take·up·disk·space·on·the·machines·of·users·who |
| 123 | do·not·need·or·want·it·installed.·As·a·special·case·of·this·rule,·shared | 123 | do·not·need·or·want·it·installed.·As·a·special·case·of·this·rule,·shared |
| 124 | library·documentation·of·any·appreciable·size·should·always·be·packaged·with | 124 | library·documentation·of·any·appreciable·size·should·always·be·packaged·with |
| Offset 156, 21 lines modified | Offset 156, 21 lines modified | ||
| 156 | not·be·a·symbolic·link.·_\x8[_\x87_\x8] | 156 | not·be·a·symbolic·link.·_\x8[_\x87_\x8] |
| 157 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.4\x84.\x8.·P\x8Pr\x8re\x8ef\x8fe\x8er\x8rr\x8re\x8ed\x8d·d\x8do\x8oc\x8cu\x8um\x8me\x8en\x8nt\x8ta\x8at\x8ti\x8io\x8on\x8n·f\x8fo\x8or\x8rm\x8ma\x8at\x8ts\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 157 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.4\x84.\x8.·P\x8Pr\x8re\x8ef\x8fe\x8er\x8rr\x8re\x8ed\x8d·d\x8do\x8oc\x8cu\x8um\x8me\x8en\x8nt\x8ta\x8at\x8ti\x8io\x8on\x8n·f\x8fo\x8or\x8rm\x8ma\x8at\x8ts\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 158 | The·unification·of·Debian·documentation·is·being·carried·out·via·HTML. | 158 | The·unification·of·Debian·documentation·is·being·carried·out·via·HTML. |
| 159 | If·the·package·comes·with·extensive·documentation·in·a·markup·format·that·can | 159 | If·the·package·comes·with·extensive·documentation·in·a·markup·format·that·can |
| 160 | be·converted·to·various·other·formats·you·should·if·possible·ship·HTML·versions | 160 | be·converted·to·various·other·formats·you·should·if·possible·ship·HTML·versions |
| 161 | in·a·binary·package.·_\x8[_\x88_\x8]·The·documentation·must·be·installed·as·specified·in | 161 | in·a·binary·package.·_\x8[_\x88_\x8]·The·documentation·must·be·installed·as·specified·in |
| 162 | _\x8A_\x8d_\x8d_\x8i_\x8t_\x8i_\x8o_\x8n_\x8a_\x8l_\x8·_\x8d_\x8o_\x8c_\x8u_\x8m_\x8e_\x8n_\x8t_\x8a_\x8t_\x8i_\x8o_\x8n. | 162 | _\x8A_\x8d_\x8d_\x8i_\x8t_\x8i_\x8o_\x8n_\x8a_\x8l_\x8·_\x8d_\x8o_\x8c_\x8u_\x8m_\x8e_\x8n_\x8t_\x8a_\x8t_\x8i_\x8o_\x8n. |
| 163 | Other·formats·such·as·PostScript·may·be·provided·at·the·package·maintainer | 163 | Other·formats·such·as·PostScript·may·be·provided·at·the·package·maintainer’s |
| 164 | discretion. | 164 | discretion. |
| 165 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.5\x85.\x8.·C\x8Co\x8op\x8py\x8yr\x8ri\x8ig\x8gh\x8ht\x8t·i\x8in\x8nf\x8fo\x8or\x8rm\x8ma\x8at\x8ti\x8io\x8on\x8n_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 165 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.5\x85.\x8.·C\x8Co\x8op\x8py\x8yr\x8ri\x8ig\x8gh\x8ht\x8t·i\x8in\x8nf\x8fo\x8or\x8rm\x8ma\x8at\x8ti\x8io\x8on\x8n_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 166 | Every·package·must·be·accompanied·by·a·verbatim·copy·of·its·distribution | 166 | Every·package·must·be·accompanied·by·a·verbatim·copy·of·its·distribution |
| 167 | license(s)·in·the·file·/usr/share/doc/PACKAGE/copyright.·This·file·must·neither | 167 | license(s)·in·the·file·/usr/share/doc/PACKAGE/copyright.·This·file·must·neither |
| 168 | be·compressed·nor·be·a·symbolic·link. | 168 | be·compressed·nor·be·a·symbolic·link. |
| 169 | A·verbatim·copy·of·the·package | 169 | A·verbatim·copy·of·the·package’s·copyright·information·is·often·required·to·be |
| 170 | present·in·/usr/share/doc/PACKAGE/copyright,·too;·see·_\x8C_\x8o_\x8p_\x8y_\x8r_\x8i_\x8g_\x8h_\x8t_\x8·_\x8c_\x8o_\x8n_\x8s_\x8i_\x8d_\x8e_\x8r_\x8a_\x8t_\x8i_\x8o_\x8n_\x8s. | 170 | present·in·/usr/share/doc/PACKAGE/copyright,·too;·see·_\x8C_\x8o_\x8p_\x8y_\x8r_\x8i_\x8g_\x8h_\x8t_\x8·_\x8c_\x8o_\x8n_\x8s_\x8i_\x8d_\x8e_\x8r_\x8a_\x8t_\x8i_\x8o_\x8n_\x8s. |
| 171 | In·addition,·the·copyright·file·must·say·where·the·upstream·sources·(if·any) | 171 | In·addition,·the·copyright·file·must·say·where·the·upstream·sources·(if·any) |
| 172 | were·obtained,·and·should·include·a·name·or·contact·address·for·the·upstream | 172 | were·obtained,·and·should·include·a·name·or·contact·address·for·the·upstream |
| 173 | authors.·This·can·be·the·name·of·an·individual·or·an·organization,·an·email | 173 | authors.·This·can·be·the·name·of·an·individual·or·an·organization,·an·email |
| 174 | address,·a·web·forum·or·bugtracker,·or·any·other·means·to·unambiguously | 174 | address,·a·web·forum·or·bugtracker,·or·any·other·means·to·unambiguously |
| 175 | identify·who·to·contact·to·participate·in·the·development·of·the·upstream | 175 | identify·who·to·contact·to·participate·in·the·development·of·the·upstream |
| 176 | source·code. | 176 | source·code. |
| Offset 200, 15 lines modified | Offset 200, 15 lines modified | ||
| 200 | the·copyright-format·files·in·the·debian-policy·package.·It·is·also·available | 200 | the·copyright-format·files·in·the·debian-policy·package.·It·is·also·available |
| 201 | from·the·Debian·web·mirrors·at·_\x8h_\x8t_\x8t_\x8p_\x8s_\x8:_\x8/_\x8/_\x8w_\x8w_\x8w_\x8._\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8._\x8o_\x8r_\x8g_\x8/_\x8d_\x8o_\x8c_\x8/_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8i_\x8n_\x8g_\x8-_\x8m_\x8a_\x8n_\x8u_\x8a_\x8l_\x8s_\x8/ | 201 | from·the·Debian·web·mirrors·at·_\x8h_\x8t_\x8t_\x8p_\x8s_\x8:_\x8/_\x8/_\x8w_\x8w_\x8w_\x8._\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8._\x8o_\x8r_\x8g_\x8/_\x8d_\x8o_\x8c_\x8/_\x8p_\x8a_\x8c_\x8k_\x8a_\x8g_\x8i_\x8n_\x8g_\x8-_\x8m_\x8a_\x8n_\x8u_\x8a_\x8l_\x8s_\x8/ |
| 202 | _\x8c_\x8o_\x8p_\x8y_\x8r_\x8i_\x8g_\x8h_\x8t_\x8-_\x8f_\x8o_\x8r_\x8m_\x8a_\x8t_\x8/_\x81_\x8._\x80_\x8/. | 202 | _\x8c_\x8o_\x8p_\x8y_\x8r_\x8i_\x8g_\x8h_\x8t_\x8-_\x8f_\x8o_\x8r_\x8m_\x8a_\x8t_\x8/_\x81_\x8._\x80_\x8/. |
| 203 | Use·of·this·format·is·optional. | 203 | Use·of·this·format·is·optional. |
| 204 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.6\x86.\x8.·E\x8Ex\x8xa\x8am\x8mp\x8pl\x8le\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 204 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.6\x86.\x8.·E\x8Ex\x8xa\x8am\x8mp\x8pl\x8le\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| 205 | Any·examples·(configurations,·source·files,·whatever),·should·be·installed·in·a | 205 | Any·examples·(configurations,·source·files,·whatever),·should·be·installed·in·a |
| 206 | directory·/usr/share/doc/package/examples.·These·files·should·not·be·referenced | 206 | directory·/usr/share/doc/package/examples.·These·files·should·not·be·referenced |
| 207 | by·any·program:·they | 207 | by·any·program:·they’re·there·for·the·benefit·of·the·system·administrator·and |
| 208 | users·as·documentation·only.·Architecture-specific·example·files·should·be | 208 | users·as·documentation·only.·Architecture-specific·example·files·should·be |
| 209 | installed·in·a·directory·/usr/lib/package/examples·with·symbolic·links·to·them | 209 | installed·in·a·directory·/usr/lib/package/examples·with·symbolic·links·to·them |
| 210 | from·/usr/share/doc/package/examples,·or·the·latter·directory·itself·may·be·a | 210 | from·/usr/share/doc/package/examples,·or·the·latter·directory·itself·may·be·a |
| 211 | symbolic·link·to·the·former. | 211 | symbolic·link·to·the·former. |
| 212 | If·the·purpose·of·a·package·is·to·provide·examples,·then·the·example·files·may | 212 | If·the·purpose·of·a·package·is·to·provide·examples,·then·the·example·files·may |
| 213 | be·installed·into·/usr/share/doc/package. | 213 | be·installed·into·/usr/share/doc/package. |
| 214 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.7\x87.\x8.·C\x8Ch\x8ha\x8an\x8ng\x8ge\x8el\x8lo\x8og\x8g·f\x8fi\x8il\x8le\x8es\x8s·a\x8an\x8nd\x8d·r\x8re\x8el\x8le\x8ea\x8as\x8se\x8e·n\x8no\x8ot\x8te\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* | 214 | *\x8**\x8**\x8**\x8**\x8*·1\x812\x82.\x8.7\x87.\x8.·C\x8Ch\x8ha\x8an\x8ng\x8ge\x8el\x8lo\x8og\x8g·f\x8fi\x8il\x8le\x8es\x8s·a\x8an\x8nd\x8d·r\x8re\x8el\x8le\x8ea\x8as\x8se\x8e·n\x8no\x8ot\x8te\x8es\x8s_\x8?\x8·*\x8**\x8**\x8**\x8**\x8* |
| Offset 225, 15 lines modified | Offset 225, 15 lines modified | ||
| 225 | If·either·of·these·files·are·distributed·in·HTML,·they·should·be·made·available | 225 | If·either·of·these·files·are·distributed·in·HTML,·they·should·be·made·available |
| 226 | at·/usr/share/doc/package/NEWS.html.gz·and·/usr/share/doc/package/ | 226 | at·/usr/share/doc/package/NEWS.html.gz·and·/usr/share/doc/package/ |
| 227 | changelog.html.gz·respectively,·and·plain·text·versions·NEWS.gz·and | 227 | changelog.html.gz·respectively,·and·plain·text·versions·NEWS.gz·and |
| 228 | changelog.gz·should·be·generated·from·them,·using,·for·example,·lynx·-dump·- | 228 | changelog.gz·should·be·generated·from·them,·using,·for·example,·lynx·-dump·- |
| 229 | nolist. | 229 | nolist. |
| 230 | If·the·upstream·release·notes·or·changelog·do·not·already·conform·to·this | 230 | If·the·upstream·release·notes·or·changelog·do·not·already·conform·to·this |
| 231 | naming·convention,·then·this·may·be·achieved·either·by·renaming·the·files,·or | 231 | naming·convention,·then·this·may·be·achieved·either·by·renaming·the·files,·or |
| 232 | by·adding·a·symbolic·link,·at·the·maintainer | 232 | by·adding·a·symbolic·link,·at·the·maintainer’s·discretion.·_\x8[_\x81_\x80_\x8] |
| 233 | All·of·these·files·should·be·installed·compressed·using·gzip·-9,·as·they·will | 233 | All·of·these·files·should·be·installed·compressed·using·gzip·-9,·as·they·will |
| 234 | become·large·with·time·even·if·they·start·out·small. | 234 | become·large·with·time·even·if·they·start·out·small. |
| 235 | If·the·package·has·only·one·file·which·is·used·both·as·the·Debian·changelog·and | 235 | If·the·package·has·only·one·file·which·is·used·both·as·the·Debian·changelog·and |
| 236 | the·upstream·release·notes·or·changelog,·because·there·is·no·separate·upstream | 236 | the·upstream·release·notes·or·changelog,·because·there·is·no·separate·upstream |
| 237 | maintainer,·then·that·file·should·usually·be·installed·as·/usr/share/doc/ | 237 | maintainer,·then·that·file·should·usually·be·installed·as·/usr/share/doc/ |
| 238 | package/NEWS.gz·or·/usr/share/doc/package/changelog.gz·(depending·on·whether | 238 | package/NEWS.gz·or·/usr/share/doc/package/changelog.gz·(depending·on·whether |
| 239 | the·file·is·release·notes·or·a·changelog);·if·there·is·a·separate·upstream | 239 | the·file·is·release·notes·or·a·changelog);·if·there·is·a·separate·upstream |
| Offset 243, 15 lines modified | Offset 243, 15 lines modified | ||
| 243 | see·_\x8D_\x8e_\x8b_\x8i_\x8a_\x8n_\x8·_\x8c_\x8h_\x8a_\x8n_\x8g_\x8e_\x8l_\x8o_\x8g_\x8:_\x8·_\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8/_\x8c_\x8h_\x8a_\x8n_\x8g_\x8e_\x8l_\x8o_\x8g. | 243 | see·_\x8D_\x8e_\x8b_\x8i_\x8a_\x8n_\x8·_\x8c_\x8h_\x8a_\x8n_\x8g_\x8e_\x8l_\x8o_\x8g_\x8:_\x8·_\x8d_\x8e_\x8b_\x8i_\x8a_\x8n_\x8/_\x8c_\x8h_\x8a_\x8n_\x8g_\x8e_\x8l_\x8o_\x8g. |
| Max diff block lines reached; 812/10699 bytes (7.59%) of diff not shown. | |||
| Offset 159, 27 lines modified | Offset 159, 27 lines modified | ||
| 159 | ········], | 159 | ········], |
| 160 | ········"Debian·Policy·Manual":·[ | 160 | ········"Debian·Policy·Manual":·[ |
| 161 | ············[22,·null] | 161 | ············[22,·null] |
| 162 | ········], | 162 | ········], |
| 163 | ········"Debian·Policy·changes·process":·[ | 163 | ········"Debian·Policy·changes·process":·[ |
| 164 | ············[9,·null] | 164 | ············[9,·null] |
| 165 | ········], | 165 | ········], |
| 166 | ········"Debian·binary·package·control·files· | 166 | ········"Debian·binary·package·control·files·\u2013·DEBIAN/control":·[ |
| 167 | ············[12,·"debian-binary-package-control-files-debian-control"] | 167 | ············[12,·"debian-binary-package-control-files-debian-control"] |
| 168 | ········], | 168 | ········], |
| 169 | ········"Debian·changelog:·debian/changelog":·[ | 169 | ········"Debian·changelog:·debian/changelog":·[ |
| 170 | ············[21,·"debian-changelog-debian-changelog"] | 170 | ············[21,·"debian-changelog-debian-changelog"] |
| 171 | ········], | 171 | ········], |
| 172 | ········"Debian·source·package·control·files· | 172 | ········"Debian·source·package·control·files·\u2013·.dsc":·[ |
| 173 | ············[12,·"debian-source-package-control-files-dsc"] | 173 | ············[12,·"debian-source-package-control-files-dsc"] |
| 174 | ········], | 174 | ········], |
| 175 | ········"Debian·source·package·template·control·files· | 175 | ········"Debian·source·package·template·control·files·\u2013·debian/control":·[ |
| 176 | ············[12,·"debian-source-package-template-control-files-debian-control"] | 176 | ············[12,·"debian-source-package-template-control-files-debian-control"] |
| 177 | ········], | 177 | ········], |
| 178 | ········"Debian·upload·changes·control·files· | 178 | ········"Debian·upload·changes·control·files·\u2013·.changes":·[ |
| 179 | ············[12,·"debian-upload-changes-control-files-changes"] | 179 | ············[12,·"debian-upload-changes-control-files-changes"] |
| 180 | ········], | 180 | ········], |
| 181 | ········"Declaring·relationships·between·packages":·[ | 181 | ········"Declaring·relationships·between·packages":·[ |
| 182 | ············[18,·null] | 182 | ············[18,·null] |
| 183 | ········], | 183 | ········], |
| 184 | ········"Definition·of·the·keywords":·[ | 184 | ········"Definition·of·the·keywords":·[ |
| 185 | ············[12,·"definition-of-the-keywords"] | 185 | ············[12,·"definition-of-the-keywords"] |
| Offset 217, 15 lines modified | Offset 217, 15 lines modified | ||
| 217 | ········], | 217 | ········], |
| 218 | ········"Dgit":·[ | 218 | ········"Dgit":·[ |
| 219 | ············[12,·"dgit"] | 219 | ············[12,·"dgit"] |
| 220 | ········], | 220 | ········], |
| 221 | ········"Distribution":·[ | 221 | ········"Distribution":·[ |
| 222 | ············[12,·"distribution"] | 222 | ············[12,·"distribution"] |
| 223 | ········], | 223 | ········], |
| 224 | ········"Diversions·-·overriding·a·package | 224 | ········"Diversions·-·overriding·a·package\u2019s·version·of·a·file·(from·old·Packaging·Manual)":·[ |
| 225 | ············[6,·null] | 225 | ············[6,·null] |
| 226 | ········], | 226 | ········], |
| 227 | ········"Documentation":·[ | 227 | ········"Documentation":·[ |
| 228 | ············[14,·null] | 228 | ············[14,·null] |
| 229 | ········], | 229 | ········], |
| 230 | ········"Early·history":·[ | 230 | ········"Early·history":·[ |
| 231 | ············[19,·"early-history"] | 231 | ············[19,·"early-history"] |
| Offset 139, 18 lines modified | Offset 139, 18 lines modified | ||
| 139 | 29 | 139 | 29 |
| 140 | 29 | 140 | 29 |
| 141 | 30 | 141 | 30 |
| 142 | 30 | 142 | 30 |
| 143 | 5·Control·files·and·their·fields | 143 | 5·Control·files·and·their·fields |
| 144 | 5.1·Syntax·of·control·files·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. | 144 | 5.1·Syntax·of·control·files·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 145 | 5.2·Debian·source·package·template·control·files· | 145 | 5.2·Debian·source·package·template·control·files·–·debian/control·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 146 | 5.3·Debian·binary·package·control·files· | 146 | 5.3·Debian·binary·package·control·files·–·DEBIAN/control·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 147 | 5.4·Debian·source·package·control·files· | 147 | 5.4·Debian·source·package·control·files·–·.dsc·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 148 | 5.5·Debian·upload·changes·control·files· | 148 | 5.5·Debian·upload·changes·control·files·–·.changes·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 149 | 5.6·List·of·fields·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. | 149 | 5.6·List·of·fields·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 150 | 5.6.1·Source·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. | 150 | 5.6.1·Source·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 151 | 5.6.2·Maintainer·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. | 151 | 5.6.2·Maintainer·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 152 | 5.6.3·Uploaders·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. | 152 | 5.6.3·Uploaders·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 153 | 5.6.4·Changed-By·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. | 153 | 5.6.4·Changed-By·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 154 | 5.6.5·Section·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. | 154 | 5.6.5·Section·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 155 | 5.6.6·Priority·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. | 155 | 5.6.6·Priority·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| Offset 583, 15 lines modified | Offset 583, 15 lines modified | ||
| 583 | 125 | 583 | 125 |
| 584 | 17.1·Automatic·handling·of·configuration·files·by·dpkg·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·125 | 584 | 17.1·Automatic·handling·of·configuration·files·by·dpkg·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·125 |
| 585 | 17.2·Fully-featured·maintainer·script·configuration·handling·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·126 | 585 | 17.2·Fully-featured·maintainer·script·configuration·handling·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·126 |
| 586 | 18·Alternative·versions·of·an·interface·-·update-alternatives·(from·old·Packaging·Manual) | 586 | 18·Alternative·versions·of·an·interface·-·update-alternatives·(from·old·Packaging·Manual) |
| 587 | 127 | 587 | 127 |
| 588 | 19·Diversions·-·overriding·a·package | 588 | 19·Diversions·-·overriding·a·package’s·version·of·a·file·(from·old·Packaging·Manual) |
| 589 | 129 | 589 | 129 |
| 590 | 20·Debian·Policy·changes·process | 590 | 20·Debian·Policy·changes·process |
| 591 | 20.1·Introduction·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. | 591 | 20.1·Introduction·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 592 | 20.2·Change·Goals·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. | 592 | 20.2·Change·Goals·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| 593 | 20.3·Current·Process·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. | 593 | 20.3·Current·Process·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·. |
| Offset 969, 31 lines modified | Offset 969, 31 lines modified | ||
| 969 | •·to·allow·us·to·make·it·easy·for·people·to·produce·CD-ROMs·of·our·system·without·violating·any·licenses,·import/export·restrictions,·or·any·other·laws. | 969 | •·to·allow·us·to·make·it·easy·for·people·to·produce·CD-ROMs·of·our·system·without·violating·any·licenses,·import/export·restrictions,·or·any·other·laws. |
| 970 | The·main·archive·area·forms·the·Debian·distribution. | 970 | The·main·archive·area·forms·the·Debian·distribution. |
| 971 | Packages·in·the·other·archive·areas·(non-free-firmware,·contrib,·non-free)·are·not·considered·to·be·part·of·the | 971 | Packages·in·the·other·archive·areas·(non-free-firmware,·contrib,·non-free)·are·not·considered·to·be·part·of·the |
| 972 | Debian·distribution,·although·we·support·their·use·and·provide·infrastructure·for·them·(such·as·our·bug-tracking·system | 972 | Debian·distribution,·although·we·support·their·use·and·provide·infrastructure·for·them·(such·as·our·bug-tracking·system |
| 973 | and·mailing·lists).·This·Debian·Policy·Manual·applies·to·these·packages·as·well. | 973 | and·mailing·lists).·This·Debian·Policy·Manual·applies·to·these·packages·as·well. |
| 974 | 2.1·The·Debian·Free·Software·Guidelines | 974 | 2.1·The·Debian·Free·Software·Guidelines |
| 975 | The·Debian·Free·Software·Guidelines·(DFSG)·form·our·definition·of· | 975 | The·Debian·Free·Software·Guidelines·(DFSG)·form·our·definition·of·“free·software”.·These·are: |
| 976 | 1.·Free·Redistribution | 976 | 1.·Free·Redistribution |
| 977 | The·license·of·a·Debian·component·may·not·restrict·any·party·from·selling·or·giving·away·the·software·as | 977 | The·license·of·a·Debian·component·may·not·restrict·any·party·from·selling·or·giving·away·the·software·as |
| 978 | a·component·of·an·aggregate·software·distribution·containing·programs·from·several·different·sources.·The | 978 | a·component·of·an·aggregate·software·distribution·containing·programs·from·several·different·sources.·The |
| 979 | license·may·not·require·a·royalty·or·other·fee·for·such·sale. | 979 | license·may·not·require·a·royalty·or·other·fee·for·such·sale. |
| 980 | 2.·Source·Code | 980 | 2.·Source·Code |
| 981 | The·program·must·include·source·code,·and·must·allow·distribution·in·source·code·as·well·as·compiled·form. | 981 | The·program·must·include·source·code,·and·must·allow·distribution·in·source·code·as·well·as·compiled·form. |
| 982 | 3.·Derived·Works | 982 | 3.·Derived·Works |
| 983 | The·license·must·allow·modifications·and·derived·works,·and·must·allow·them·to·be·distributed·under·the | 983 | The·license·must·allow·modifications·and·derived·works,·and·must·allow·them·to·be·distributed·under·the |
| 984 | same·terms·as·the·license·of·the·original·software. | 984 | same·terms·as·the·license·of·the·original·software. |
| 985 | 4.·Integrity·of·The·Author | 985 | 4.·Integrity·of·The·Author’s·Source·Code |
| 986 | The·license·may·restrict·source-code·from·being·distributed·in·modified·form·only·if·the·license·allows·the | 986 | The·license·may·restrict·source-code·from·being·distributed·in·modified·form·only·if·the·license·allows·the |
| 987 | distribution·of· | 987 | distribution·of·“patch·files”·with·the·source·code·for·the·purpose·of·modifying·the·program·at·build·time. |
| 988 | The·license·must·explicitly·permit·distribution·of·software·built·from·modified·source·code.·The·license·may | 988 | The·license·must·explicitly·permit·distribution·of·software·built·from·modified·source·code.·The·license·may |
| 989 | require·derived·works·to·carry·a·different·name·or·version·number·from·the·original·software.·(This·is·a | 989 | require·derived·works·to·carry·a·different·name·or·version·number·from·the·original·software.·(This·is·a |
| 990 | 1·The·Debian·archive·software·uses·the·term· | 990 | 1·The·Debian·archive·software·uses·the·term·“component”·internally·and·in·the·Release·file·format·to·refer·to·the·division·of·an·archive.·The·Debian |
| 991 | Social·Contract·simply·refers·to· | 991 | Social·Contract·simply·refers·to·“areas.”·This·document·uses·terminology·similar·to·the·Social·Contract. |
| 992 | 7 | 992 | 7 |
| 993 | \xcDebian·Policy·Manual,·Release·4.7.2.0 | 993 | \xcDebian·Policy·Manual,·Release·4.7.2.0 |
| 994 | compromise.·The·Debian·Project·encourages·all·authors·to·not·restrict·any·files,·source·or·binary,·from·being | 994 | compromise.·The·Debian·Project·encourages·all·authors·to·not·restrict·any·files,·source·or·binary,·from·being |
| 995 | modified.) | 995 | modified.) |
| Offset 1003, 24 lines modified | Offset 1003, 24 lines modified | ||
| 1003 | The·license·must·not·restrict·anyone·from·making·use·of·the·program·in·a·specific·field·of·endeavor.·For | 1003 | The·license·must·not·restrict·anyone·from·making·use·of·the·program·in·a·specific·field·of·endeavor.·For |
| 1004 | example,·it·may·not·restrict·the·program·from·being·used·in·a·business,·or·from·being·used·for·genetic | 1004 | example,·it·may·not·restrict·the·program·from·being·used·in·a·business,·or·from·being·used·for·genetic |
| 1005 | research. | 1005 | research. |
| 1006 | 7.·Distribution·of·License | 1006 | 7.·Distribution·of·License |
| 1007 | The·rights·attached·to·the·program·must·apply·to·all·to·whom·the·program·is·redistributed·without·the·need | 1007 | The·rights·attached·to·the·program·must·apply·to·all·to·whom·the·program·is·redistributed·without·the·need |
| 1008 | for·execution·of·an·additional·license·by·those·parties. | 1008 | for·execution·of·an·additional·license·by·those·parties. |
| 1009 | 8.·License·Must·Not·Be·Specific·to·Debian | 1009 | 8.·License·Must·Not·Be·Specific·to·Debian |
| 1010 | The·rights·attached·to·the·program·must·not·depend·on·the·program | 1010 | The·rights·attached·to·the·program·must·not·depend·on·the·program’s·being·part·of·a·Debian·system.·If·the |
| 1011 | program·is·extracted·from·Debian·and·used·or·distributed·without·Debian·but·otherwise·within·the·terms·of | 1011 | program·is·extracted·from·Debian·and·used·or·distributed·without·Debian·but·otherwise·within·the·terms·of |
| 1012 | the·program | 1012 | the·program’s·license,·all·parties·to·whom·the·program·is·redistributed·must·have·the·same·rights·as·those |
| 1013 | that·are·granted·in·conjunction·with·the·Debian·system. | 1013 | that·are·granted·in·conjunction·with·the·Debian·system. |
| 1014 | 9.·License·Must·Not·Contaminate·Other·Software | 1014 | 9.·License·Must·Not·Contaminate·Other·Software |
| 1015 | The·license·must·not·place·restrictions·on·other·software·that·is·distributed·along·with·the·licensed·software. | 1015 | The·license·must·not·place·restrictions·on·other·software·that·is·distributed·along·with·the·licensed·software. |
| 1016 | For·example,·the·license·must·not·insist·that·all·other·programs·distributed·on·the·same·medium·must·be·free | 1016 | For·example,·the·license·must·not·insist·that·all·other·programs·distributed·on·the·same·medium·must·be·free |
| 1017 | software. | 1017 | software. |
| 1018 | 10.·Example·Licenses | 1018 | 10.·Example·Licenses |
| 1019 | The· | 1019 | The·“GPL,”·“BSD,”·and·“Artistic”·licenses·are·examples·of·licenses·that·we·consider·free. |
| 1020 | 2.2·Archive·areas | 1020 | 2.2·Archive·areas |
| 1021 | 2.2.1·The·main·archive·area | 1021 | 2.2.1·The·main·archive·area |
| 1022 | The·main·archive·area·comprises·the·Debian·distribution.·Only·the·packages·in·this·area·are·considered·part·of·the | 1022 | The·main·archive·area·comprises·the·Debian·distribution.·Only·the·packages·in·this·area·are·considered·part·of·the |
| 1023 | distribution.·None·of·the·packages·in·the·main·archive·area·require·software·outside·of·that·area·to·function.·Anyone | 1023 | distribution.·None·of·the·packages·in·the·main·archive·area·require·software·outside·of·that·area·to·function.·Anyone |
| 1024 | may·use,·share,·modify·and·redistribute·the·packages·in·this·archive·area·freely2·. | 1024 | may·use,·share,·modify·and·redistribute·the·packages·in·this·archive·area·freely2·. |
| 1025 | Every·package·in·main·must·comply·with·the·DFSG·(Debian·Free·Software·Guidelines).3 | 1025 | Every·package·in·main·must·comply·with·the·DFSG·(Debian·Free·Software·Guidelines).3 |
| Offset 1028, 22 lines modified | Offset 1028, 22 lines modified | ||
| 1028 | •·must·not·require·or·recommend·a·package·outside·of·main·for·compilation·or·execution·(thus,·the·package | 1028 | •·must·not·require·or·recommend·a·package·outside·of·main·for·compilation·or·execution·(thus,·the·package |
| 1029 | must·not·declare·a·Pre-Depends,·Depends,·Recommends,·Build-Depends,·Build-Depends-Indep,·or | 1029 | must·not·declare·a·Pre-Depends,·Depends,·Recommends,·Build-Depends,·Build-Depends-Indep,·or |
| 1030 | Build-Depends-Arch·relationship·on·a·non-main·package·unless·that·package·is·only·listed·as·a·non-default | 1030 | Build-Depends-Arch·relationship·on·a·non-main·package·unless·that·package·is·only·listed·as·a·non-default |
| 1031 | alternative·for·a·package·in·main), | 1031 | alternative·for·a·package·in·main), |
| 1032 | •·must·not·be·so·buggy·that·we·refuse·to·support·them,·and | 1032 | •·must·not·be·so·buggy·that·we·refuse·to·support·them,·and |
| 1033 | •·must·meet·all·policy·requirements·presented·in·this·manual. | 1033 | •·must·meet·all·policy·requirements·presented·in·this·manual. |
| 1034 | If·a·source·package·is·in·the·main·archive·area,·then·at·least·one·of·its·binary·packages·must·be·in·the·main·archive·area, | 1034 | If·a·source·package·is·in·the·main·archive·area,·then·at·least·one·of·its·binary·packages·must·be·in·the·main·archive·area, |
| 1035 | and·each·of·the·remaining·packages·must·be·in·either·the·main·or·contrib·archive·area.·Each·binary·package | 1035 | and·each·of·the·remaining·packages·must·be·in·either·the·main·or·contrib·archive·area.·Each·binary·package’s·archive |
| 1036 | area·is·indicated·by·its·Section·field:·see·Sections. | 1036 | area·is·indicated·by·its·Section·field:·see·Sections. |
| 1037 | Source·packages·in·main·with·a·mixture·of·main·and·contrib·binary·packages·are·more·complex·for·archive·tooling·to | 1037 | Source·packages·in·main·with·a·mixture·of·main·and·contrib·binary·packages·are·more·complex·for·archive·tooling·to |
| 1038 | handle,·and·therefore·should·be·limited·to·situations·where·it·would·be·inconvenient·to·split·the·source·package.·If·it·is | 1038 | handle,·and·therefore·should·be·limited·to·situations·where·it·would·be·inconvenient·to·split·the·source·package.·If·it·is |
| 1039 | straightforward·to·split·the·source·package·into·a·main·part·and·a·contrib·part·that·are·built·separately,·then·those·parts | 1039 | straightforward·to·split·the·source·package·into·a·main·part·and·a·contrib·part·that·are·built·separately,·then·those·parts |
| 1040 | should·be·represented·as·separate·source·packages. | 1040 | should·be·represented·as·separate·source·packages. |
| 1041 | 2·See·What·Does·Free·Mean?·for·more·about·what·we·mean·by·free·software. | 1041 | 2·See·What·Does·Free·Mean?·for·more·about·what·we·mean·by·free·software. |
| 1042 | 3·Debian | 1042 | 3·Debian’s·FTP·Masters·publish·a·REJECT-FAQ·which·details·the·project’s·current·working·interpretation·of·the·DFSG. |
| 1043 | 8 | 1043 | 8 |
| 1044 | Chapter·2.·The·Debian·Archive | 1044 | Chapter·2.·The·Debian·Archive |
| 1045 | \xcDebian·Policy·Manual,·Release·4.7.2.0 | 1045 | \xcDebian·Policy·Manual,·Release·4.7.2.0 |
| Offset 1127, 44 lines modified | Offset 1127, 44 lines modified | ||
| 1127 | saying·what·is·permitted·then·nothing·is·permitted. | 1127 | saying·what·is·permitted·then·nothing·is·permitted. |
| 1128 | Many·authors·are·unaware·of·the·problems·that·restrictive·copyrights·(or·lack·of·copyright·notices)·can·cause·for·the | 1128 | Many·authors·are·unaware·of·the·problems·that·restrictive·copyrights·(or·lack·of·copyright·notices)·can·cause·for·the |
| 1129 | users·of·their·supposedly-free·software.·It·is·often·worthwhile·contacting·such·authors·diplomatically·to·ask·them·to | 1129 | users·of·their·supposedly-free·software.·It·is·often·worthwhile·contacting·such·authors·diplomatically·to·ask·them·to |
| 1130 | modify·their·license·terms.·However,·this·can·be·a·politically·difficult·thing·to·do·and·you·should·ask·for·advice·on·the | 1130 | modify·their·license·terms.·However,·this·can·be·a·politically·difficult·thing·to·do·and·you·should·ask·for·advice·on·the |
| 1131 | debian-legal·mailing·list·first,·as·explained·below. | 1131 | debian-legal·mailing·list·first,·as·explained·below. |
| 1132 | When·in·doubt·about·a·copyright,·send·mail·to·debian-legal@lists.debian.org.·Be·prepared·to·provide·us·with·the·copyright | 1132 | When·in·doubt·about·a·copyright,·send·mail·to·debian-legal@lists.debian.org.·Be·prepared·to·provide·us·with·the·copyright |
| 1133 | statement.·Software·covered·by·the·GPL,·public·domain·software·and·BSD-like·copyrights·are·safe;·be·wary·of·the·phrases | 1133 | statement.·Software·covered·by·the·GPL,·public·domain·software·and·BSD-like·copyrights·are·safe;·be·wary·of·the·phrases |
| 1134 | 1134 | “commercial·use·prohibited”·and·“distribution·restricted”. | |
| 1135 | 5·Licenses·that·are·not·thought·to·require·the·copying·of·all·copyright·notices·into·Debian | 1135 | 5·Licenses·that·are·not·thought·to·require·the·copying·of·all·copyright·notices·into·Debian’s·copyright·file·include·Apache-2.0·and·the·Boost·Software |
| 1136 | License,·version·1.0.·Final·determination·as·to·whether·a·package | 1136 | License,·version·1.0.·Final·determination·as·to·whether·a·package’s·copyright·file·is·sufficient·lies·with·the·FTP·team. |
| 1137 | To·help·find·copyright·notices·you·need·to·copy,·you·might·try·grep·--color=always·-Eir·'(copyright|©)'·*·|·less·-R | 1137 | To·help·find·copyright·notices·you·need·to·copy,·you·might·try·grep·--color=always·-Eir·'(copyright|©)'·*·|·less·-R |
| Max diff block lines reached; 100708/111353 bytes (90.44%) of diff not shown. | |||
| Offset 69, 39851 lines modified | Offset 69, 36495 lines modified | ||
| 00000440:·6379·2076·6572·7369·6f6e·2034·2e37·2e32··cy·version·4.7.2 | 00000440:·6379·2076·6572·7369·6f6e·2034·2e37·2e32··cy·version·4.7.2 | ||
| 00000450:·2e30·2c20·7265·6c65·6173·6564·206f·6e20··.0,·released·on· | 00000450:·2e30·2c20·7265·6c65·6173·6564·206f·6e20··.0,·released·on· | ||
| 00000460:·3230·3235·2d30·322d·3237·2e0a·0a2a·204d··2025-02-27...*·M | 00000460:·3230·3235·2d30·322d·3237·2e0a·0a2a·204d··2025-02-27...*·M | ||
| 00000470:·656e·753a·0a0a·2a20·4162·6f75·7420·7468··enu:..*·About·th | 00000470:·656e·753a·0a0a·2a20·4162·6f75·7420·7468··enu:..*·About·th | ||
| 00000480:·6973·206d·616e·7561·6c3a·3a0a·2a20·5468··is·manual::.*·Th | 00000480:·6973·206d·616e·7561·6c3a·3a0a·2a20·5468··is·manual::.*·Th | ||
| 00000490:·6520·4465·6269·616e·2041·7263·6869·7665··e·Debian·Archive | 00000490:·6520·4465·6269·616e·2041·7263·6869·7665··e·Debian·Archive | Diff chunk too large, falling back to line-by-line diff (36488 lines added, 39844 lines removed) | |
| 000004a0:·3a3a·0a2a·2042·696e·6172·7920·7061·636b··::.*·Binary·pack | 000004a0:·3a3a·0a2a·2042·696e·6172·7920·7061·636b··::.*·Binary·pack | ||
| 000004b0:·6167·6573·3a3a·0a2a·20 | 000004b0:·6167·6573·3a3a·0a2a·2043·6f6e·7472·6f6c··ages::.*·Control | ||
| 000004c0:· | 000004c0:·2066·696c·6573·2061·6e64·2074·6865·6972···files·and·their | ||
| 000004d0:· | 000004d0:·2066·6965·6c64·733a·3a0a·2a20·5061·636b···fields::.*·Pack | ||
| 000004e0:·6 | 000004e0:·6167·6520·6d61·696e·7461·696e·6572·2073··age·maintainer·s | ||
| 000004f0:· | 000004f0:·6372·6970·7473·2061·6e64·2069·6e73·7461··cripts·and·insta | ||
| 00000500:·6 | 00000500:·6c6c·6174·696f·6e20·7072·6f63·6564·7572··llation·procedur | ||
| 00000510:·6 | 00000510:·653a·3a0a·2a20·4465·636c·6172·696e·6720··e::.*·Declaring· | ||
| 00000520:· | 00000520:·7265·6c61·7469·6f6e·7368·6970·7320·6265··relationships·be | ||
| 00000530:·6 | 00000530:·7477·6565·6e20·7061·636b·6167·6573·3a3a··tween·packages:: | ||
| 00000540:· | 00000540:·0a2a·2053·6861·7265·6420·6c69·6272·6172··.*·Shared·librar | ||
| 00000550:·6 | 00000550:·6965·733a·3a0a·2a20·5468·6520·4f70·6572··ies::.*·The·Oper | ||
| 00000560:·6 | 00000560:·6174·696e·6720·5379·7374·656d·3a3a·0a2a··ating·System::.* | ||
| 00000570:· | 00000570:·2046·696c·6573·3a20·4669·6c65·733c·323e···Files:·Files<2> | ||
| 00000580:· | 00000580:·2e0a·2a20·4375·7374·6f6d·697a·6564·2070··..*·Customized·p | ||
| 00000590:·7 | 00000590:·726f·6772·616d·733a·3a0a·2a20·446f·6375··rograms::.*·Docu | ||
| 000005a0:·6 | 000005a0:·6d65·6e74·6174·696f·6e3a·3a0a·2a20·496e··mentation::.*·In | ||
| 000005b0:· | 000005b0:·7472·6f64·7563·7469·6f6e·2061·6e64·2073··troduction·and·s | ||
| 000005c0:· | 000005c0:·636f·7065·206f·6620·7468·6573·6520·6170··cope·of·these·ap | ||
| 000005d0:· | 000005d0:·7065·6e64·6963·6573·3a3a·0a2a·2042·696e··pendices::.*·Bin | ||
| 000005e0:·6 | 000005e0:·6172·7920·7061·636b·6167·6573·2028·6672··ary·packages·(fr | ||
| 000005f0:· | 000005f0:·6f6d·206f·6c64·2050·6163·6b61·6769·6e67··om·old·Packaging | ||
| 00000600:·20 | 00000600:·204d·616e·7561·6c29·3a20·4269·6e61·7279···Manual):·Binary | ||
| 00000610:· | 00000610:·2070·6163·6b61·6765·7320·6672·6f6d·206f···packages·from·o | ||
| 00000620:·6 | 00000620:·6c64·2050·6163·6b61·6769·6e67·204d·616e··ld·Packaging·Man | ||
| 00000630:· | 00000630:·7561·6c2e·0a2a·2053·6f75·7263·6520·7061··ual..*·Source·pa | ||
| 00000640:· | 00000640:·636b·6167·6573·2028·6672·6f6d·206f·6c64··ckages·(from·old | ||
| 00000650:· | 00000650:·2050·6163·6b61·6769·6e67·204d·616e·7561···Packaging·Manua | ||
| 00000660:·2 | 00000660:·6c29·3a20·536f·7572·6365·2070·6163·6b61··l):·Source·packa | ||
| 00000670:·6 | 00000670:·6765·7320·6672·6f6d·206f·6c64·2050·6163··ges·from·old·Pac | ||
| 00000680:·6 | 00000680:·6b61·6769·6e67·204d·616e·7561·6c2e·0a2a··kaging·Manual..* | ||
| 00000690:·20 | 00000690:·2043·6f6e·7472·6f6c·2066·696c·6573·2061···Control·files·a | ||
| 000006a0:·6 | 000006a0:·6e64·2074·6865·6972·2066·6965·6c64·7320··nd·their·fields· | ||
| 000006b0:· | 000006b0:·2866·726f·6d20·6f6c·6420·5061·636b·6167··(from·old·Packag | ||
| 000006c0:·6 | 000006c0:·696e·6720·4d61·6e75·616c·293a·2043·6f6e··ing·Manual):·Con | ||
| 000006d0:· | 000006d0:·7472·6f6c·2066·696c·6573·2061·6e64·2074··trol·files·and·t | ||
| 000006e0:· | 000006e0:·6865·6972·2066·6965·6c64·7320·6672·6f6d··heir·fields·from | ||
| 000006f0:· | 000006f0:·206f·6c64·2050·6163·6b61·6769·6e67·204d···old·Packaging·M | ||
| 00000700:·6 | 00000700:·616e·7561·6c2e·0a2a·2043·6f6e·6669·6775··anual..*·Configu | ||
| 00000710:· | 00000710:·7261·7469·6f6e·2066·696c·6520·6861·6e64··ration·file·hand | ||
| 00000720:·6 | 00000720:·6c69·6e67·2028·6672·6f6d·206f·6c64·2050··ling·(from·old·P | ||
| 00000730:·6 | 00000730:·6163·6b61·6769·6e67·204d·616e·7561·6c29··ackaging·Manual) | ||
| 00000740:· | 00000740:·3a20·436f·6e66·6967·7572·6174·696f·6e20··:·Configuration· | ||
| 00000750:· | 00000750:·6669·6c65·2068·616e·646c·696e·6720·6672··file·handling·fr | ||
| 00000760:·6 | 00000760:·6f6d·206f·6c64·2050·6163·6b61·6769·6e67··om·old·Packaging | ||
| 00000770:· | 00000770:·204d·616e·7561·6c2e·0a2a·2041·6c74·6572···Manual..*·Alter | ||
| 00000780:·6769· | 00000780:·6e61·7469·7665·2076·6572·7369·6f6e·7320··native·versions· | ||
| 00000790:·6 | 00000790:·6f66·2061·6e20·696e·7465·7266·6163·6520··of·an·interface· | ||
| 000007a0:· | 000007a0:·2d20·7570·6461·7465·2d61·6c74·6572·6e61··-·update-alterna | ||
| 000007b0:· | 000007b0:·7469·7665·7320·2866·726f·6d20·6f6c·6420··tives·(from·old· | ||
| 000007c0:· | 000007c0:·5061·636b·6167·696e·6720·4d61·6e75·616c··Packaging·Manual | ||
| 000007d0:· | 000007d0:·293a·2041·6c74·6572·6e61·7469·7665·2076··):·Alternative·v | ||
| 000007e0:·6 | 000007e0:·6572·7369·6f6e·7320·6f66·2061·6e20·696e··ersions·of·an·in | ||
| 000007f0:·7 | 000007f0:·7465·7266·6163·6520·2d20·7570·6461·7465··terface·-·update | ||
| 00000800:· | 00000800:·2d61·6c74·6572·6e61·7469·7665·7320·6672··-alternatives·fr | ||
| 00000810:·6 | 00000810:·6f6d·206f·6c64·2050·6163·6b61·6769·6e67··om·old·Packaging | ||
| 00000820:· | 00000820:·204d·616e·7561·6c2e·0a2a·2044·6976·6572···Manual..*·Diver | ||
| 00000830:· | 00000830:·7369·6f6e·7320·2d20·6f76·6572·7269·6469··sions·-·overridi | ||
| 00000840:·6 | 00000840:·6e67·2061·2070·6163·6b61·6765·e280·9973··ng·a·package...s | ||
| 00000850:·7 | 00000850:·2076·6572·7369·6f6e·206f·6620·6120·6669···version·of·a·fi | ||
| 00000860:· | 00000860:·6c65·2028·6672·6f6d·206f·6c64·2050·6163··le·(from·old·Pac | ||
| 00000870:·6 | 00000870:·6b61·6769·6e67·204d·616e·7561·6c29·3a20··kaging·Manual):· | ||
| 00000880:· | 00000880:·4469·7665·7273·696f·6e73·202d·206f·7665··Diversions·-·ove | ||
| 00000890:· | 00000890:·7272·6964·696e·6720·6120·7061·636b·6167··rriding·a·packag | ||
| 000008a0:· | 000008a0:·65e2·8099·7320·7665·7273·696f·6e20·6f66··e...s·version·of | ||
| 000008b0:·616 | 000008b0:·2061·2066·696c·6520·6672·6f6d·206f·6c64···a·file·from·old | ||
| 000008c0:·20 | 000008c0:·2050·6163·6b61·6769·6e67·204d·616e·7561···Packaging·Manua | ||
| 000008d0:·20 | 000008d0:·6c2e·0a2a·2044·6562·6961·6e20·506f·6c69··l..*·Debian·Poli | ||
| 000008e0:·6 | 000008e0:·6379·2063·6861·6e67·6573·2070·726f·6365··cy·changes·proce | ||
| 000008f0:· | 000008f0:·7373·3a3a·0a2a·204d·6169·6e74·6169·6e65··ss::.*·Maintaine | ||
| 00000900:·7 | 00000900:·7220·7363·7269·7074·2066·6c6f·7763·6861··r·script·flowcha | ||
| 00000910:·72 | 00000910:·7274·733a·3a0a·2a20·5570·6772·6164·696e··rts::.*·Upgradin | ||
| 00000920:·72 | 00000920:·6720·6368·6563·6b6c·6973·743a·3a0a·2a20··g·checklist::.*· | ||
| 00000930:· | 00000930:·4c69·6365·6e73·653a·3a0a·2a20·496e·6465··License::.*·Inde | ||
| 00000940:· | 00000940:·783a·3a0a·0a20·2d2d·2054·6865·2044·6574··x::..·--·The·Det | ||
| 00000950:· | 00000950:·6169·6c65·6420·4e6f·6465·204c·6973·7469··ailed·Node·Listi | ||
| 00000960:·6 | 00000960:·6e67·202d·2d0a·0a41·626f·7574·2074·6869··ng·--..About·thi | ||
| 00000970:· | 00000970:·7320·6d61·6e75·616c·0a0a·2a20·5363·6f70··s·manual..*·Scop | ||
| 00000980:· | 00000980:·653a·3a0a·2a20·4e65·7720·7665·7273·696f··e::.*·New·versio | ||
| 00000990:·6 | 00000990:·6e73·206f·6620·7468·6973·2064·6f63·756d··ns·of·this·docum | ||
| 000009a0:·6 | 000009a0:·656e·743a·3a0a·2a20·4175·7468·6f72·7320··ent::.*·Authors· | ||
| 000009b0:·6 | 000009b0:·616e·6420·4d61·696e·7461·696e·6572·733a··and·Maintainers: | ||
| 000009c0:· | 000009c0:·3a0a·2a20·5265·6c61·7465·6420·646f·6375··:.*·Related·docu | ||
| 000009d0:· | 000009d0:·6d65·6e74·733a·3a0a·2a20·4465·6669·6e69··ments::.*·Defini | ||
| 000009e0:· | 000009e0:·7469·6f6e·733a·3a0a·2a20·5472·616e·736c··tions::.*·Transl | ||
| 000009f0:·7469 | 000009f0:·6174·696f·6e73·3a3a·0a0a·4175·7468·6f72··ations::..Author | ||
| 00000a00:· | 00000a00:·7320·616e·6420·4d61·696e·7461·696e·6572··s·and·Maintainer | ||
| 00000a10:·73 | 00000a10:·730a·0a2a·2045·6172·6c79·2068·6973·746f··s..*·Early·histo | ||
| 00000a20:·73 | 00000a20:·7279·3a3a·0a2a·2043·7572·7265·6e74·2070··ry::.*·Current·p | ||
| 00000a30:·727 | 00000a30:·726f·6365·7373·3a3a·0a2a·2049·6d70·726f··rocess::.*·Impro | ||
| 00000a40:·7 | 00000a40:·7665·6d65·6e74·733a·3a0a·0a54·6865·2044··vements::..The·D | ||
| 00000a50:· | 00000a50:·6562·6961·6e20·4172·6368·6976·650a·0a2a··ebian·Archive..* | ||
| 00000a60:· | 00000a60:·2054·6865·2044·6562·6961·6e20·4672·6565···The·Debian·Free | ||
| 00000a70:·205 | 00000a70:·2053·6f66·7477·6172·6520·4775·6964·656c···Software·Guidel | ||
| 00000a80:· | 00000a80:·696e·6573·3a3a·0a2a·2041·7263·6869·7665··ines::.*·Archive | ||
| 00000a90:·6 | 00000a90:·2061·7265·6173·3a3a·0a2a·2043·6f70·7972···areas::.*·Copyr | ||
| 00000aa0:· | 00000aa0:·6967·6874·2063·6f6e·7369·6465·7261·7469··ight·considerati | ||
| 00000ab0:·6 | 00000ab0:·6f6e·733a·3a0a·2a20·5365·6374·696f·6e73··ons::.*·Sections | ||
| 00000ac0:· | 00000ac0:·3a3a·0a2a·2050·7269·6f72·6974·6965·733a··::.*·Priorities: | ||
| 00000ad0:·3a | 00000ad0:·3a0a·0a41·7263·6869·7665·2061·7265·6173··:..Archive·areas | ||
| 00000ae0:· | 00000ae0:·0a0a·2a20·5468·6520·6d61·696e·2061·7263··..*·The·main·arc | ||
| 00000af0:· | 00000af0:·6869·7665·2061·7265·613a·3a0a·2a20·5468··hive·area::.*·Th | ||
| 00000b00:·6 | 00000b00:·6520·6e6f·6e2d·6672·6565·2d66·6972·6d77··e·non-free-firmw | ||
| 00000b10:·6 | 00000b10:·6172·6520·6172·6368·6976·6520·6172·6561··are·archive·area | ||
| 00000b20:· | 00000b20:·3a3a·0a2a·2054·6865·2063·6f6e·7472·6962··::.*·The·contrib | ||
| 00000b30:· | 00000b30:·2061·7263·6869·7665·2061·7265·613a·3a0a···archive·area::. | ||
| 00000b40:·2 | 00000b40:·2a20·5468·6520·6e6f·6e2d·6672·6565·2061··*·The·non-free·a | ||
| 00000b50:· | 00000b50:·7263·6869·7665·2061·7265·613a·3a0a·0a42··rchive·area::..B | ||
| 00000b60:· | 00000b60:·696e·6172·7920·7061·636b·6167·6573·0a0a··inary·packages.. | ||
| 00000b70:· | 00000b70:·2a20·5468·6520·7061·636b·6167·6520·6e61··*·The·package·na | ||
| 00000b80:· | 00000b80:·6d65·3a3a·0a2a·2054·6865·2076·6572·7369··me::.*·The·versi | ||
| 00000b90:·6 | 00000b90:·6f6e·206f·6620·6120·7061·636b·6167·653a··on·of·a·package: | ||
| 00000ba0:· | 00000ba0:·3a0a·2a20·5468·6520·6d61·696e·7461·696e··:.*·The·maintain | ||
| 00000bb0:· | 00000bb0:·6572·206f·6620·6120·7061·636b·6167·653a··er·of·a·package: | ||
| 00000bc0:· | 00000bc0:·3a0a·2a20·5468·6520·6465·7363·7269·7074··:.*·The·descript | ||
| 00000bd0:· | 00000bd0:·696f·6e20·6f66·2061·2070·6163·6b61·6765··ion·of·a·package | ||
| 00000be0:· | 00000be0:·3a3a·0a2a·2044·6570·656e·6465·6e63·6965··::.*·Dependencie | ||
| 00000bf0:· | 00000bf0:·733a·3a0a·2a20·5669·7274·7561·6c20·7061··s::.*·Virtual·pa | ||
| 00000c00:· | 00000c00:·636b·6167·6573·3a3a·0a2a·2042·6173·6520··ckages::.*·Base· | ||
| 00000c10:· | 00000c10:·7379·7374·656d·3a3a·0a2a·2045·7373·656e··system::.*·Essen | ||
| Max diff block lines reached; -1/5267404 bytes (-0.00%) of diff not shown. | |||