linuxOS_AP05/debian/test/usr/share/doc/python3/python-policy.html/index.html
2025-09-26 09:40:02 +08:00

25 lines
9.2 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Debian Python Policy</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><meta name="description" content="This document describes the packaging of Python within the Debian GNU/Linux distribution and the policy requirements for packaged Python programs and modules." /><link rel="home" href="index.html" title="Debian Python Policy" /><link rel="next" href="python3.html" title="Chapter 1. On the move to Python 3" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Debian Python Policy</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="python3.html">Next</a></td></tr></table><hr /></div><div xml:lang="en" class="book" lang="en"><div class="titlepage"><div><div><h1 class="title"><a id="idm1"></a>Debian Python Policy</h1></div><div><div class="author"><h3 class="author"><span class="firstname">Neil</span> <span class="surname">Schemenauer</span></h3><code class="email">&lt;<a class="email" href="mailto:nas@debian.org">nas@debian.org</a>&gt;</code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Matthias</span> <span class="surname">Klose</span></h3><code class="email">&lt;<a class="email" href="mailto:doko@debian.org">doko@debian.org</a>&gt;</code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Gregor</span> <span class="surname">Hoffleit</span></h3><code class="email">&lt;<a class="email" href="mailto:flight@debian.org">flight@debian.org</a>&gt;</code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Josselin</span> <span class="surname">Mouette</span></h3><code class="email">&lt;<a class="email" href="mailto:joss@debian.org">joss@debian.org</a>&gt;</code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Joe</span> <span class="surname">Wreschnig</span></h3><code class="email">&lt;<a class="email" href="mailto:piman@debian.org">piman@debian.org</a>&gt;</code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Loïc</span> <span class="surname">Minier</span></h3><code class="email">&lt;<a class="email" href="mailto:lool@debian.org">lool@debian.org</a>&gt;</code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Scott</span> <span class="surname">Kitterman</span></h3><code class="email">&lt;<a class="email" href="mailto:scott@kitterman.com">scott@kitterman.com</a>&gt;</code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Barry</span> <span class="surname">Warsaw</span></h3><code class="email">&lt;<a class="email" href="mailto:barry@debian.org">barry@debian.org</a>&gt;</code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Ben</span> <span class="surname">Finney</span></h3><code class="email">&lt;<a class="email" href="mailto:ben+debian@benfinney.id.au">ben+debian@benfinney.id.au</a>&gt;</code></div></div><div><p class="copyright">Copyright © 1999, 2016 Software in the Public Interest</p></div><div><div class="legalnotice"><a id="idm56"></a><p>
This manual is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version
2 of the License, or (at your option) any later version.
</p><p>
This is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
the GNU General Public License for more details.
</p><p>
A copy of the GNU General Public License version 2 is available as
<code class="filename">/usr/share/common-licences/GPL-2</code> in the Debian
GNU/Linux system, or on the World Wide Web at
<a class="ulink" href="https://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target="_blank">GNU General Public License, version 2</a>.
</p><p>
You can also obtain it by writing to the
Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
Boston, MA 02110-1301, USA.
</p></div></div><div><div class="abstract"><p class="title"><strong>Abstract</strong></p><p>
This document describes the packaging of Python within the
Debian GNU/Linux distribution and the policy requirements for
packaged Python programs and modules.
</p></div></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="chapter"><a href="python3.html">1. On the move to Python 3</a></span></dt><dt><span class="chapter"><a href="python.html">2. Python Packaging</a></span></dt><dd><dl><dt><span class="section"><a href="python.html#versions">2.1. Versions</a></span></dt><dt><span class="section"><a href="python.html#base">2.2. Main packages</a></span></dt><dt><span class="section"><a href="python.html#minimal">2.3. Minimal packages</a></span></dt><dt><span class="section"><a href="python.html#interpreter">2.4. Python Interpreter</a></span></dt><dd><dl><dt><span class="section"><a href="python.html#interpreter_name">2.4.1. Interpreter Name</a></span></dt><dt><span class="section"><a href="python.html#interpreter_loc">2.4.2. Interpreter Location</a></span></dt></dl></dd><dt><span class="section"><a href="python.html#paths">2.5. Module Path</a></span></dt><dt><span class="section"><a href="python.html#runtimes_hooks">2.6. Hooks for updates to installed runtimes</a></span></dt><dt><span class="section"><a href="python.html#docs">2.7. Documentation</a></span></dt></dl></dd><dt><span class="chapter"><a href="module_packages.html">3. Packaged Modules</a></span></dt><dd><dl><dt><span class="section"><a href="module_packages.html#idm302">3.1. Types of Python Modules</a></span></dt><dt><span class="section"><a href="module_packages.html#wheels">3.2. Wheels</a></span></dt><dt><span class="section"><a href="module_packages.html#package_names">3.3. Module Package Names</a></span></dt><dt><span class="section"><a href="module_packages.html#specifying_versions">3.4. Specifying Supported Versions</a></span></dt><dt><span class="section"><a href="module_packages.html#dependencies">3.5. Dependencies</a></span></dt><dt><span class="section"><a href="module_packages.html#provides">3.6. Provides</a></span></dt><dt><span class="section"><a href="module_packages.html#byte_compilation">3.7. Modules Byte-Compilation</a></span></dt></dl></dd><dt><span class="chapter"><a href="programs.html">4. Python Programs</a></span></dt><dd><dl><dt><span class="section"><a href="programs.html#interpreter-directive">4.1. Interpreter directive (“Shebang”)</a></span></dt><dt><span class="section"><a href="programs.html#version_indep_progs">4.2. Programs using the default Python</a></span></dt><dd><dl><dt><span class="section"><a href="programs.html#current_version_progs">4.2.1. Programs Shipping Private Modules</a></span></dt></dl></dd><dt><span class="section"><a href="programs.html#version_dep_progs">4.3. Programs Using a Particular Python Version</a></span></dt></dl></dd><dt><span class="chapter"><a href="embed.html">5. Programs Embedding Python</a></span></dt><dd><dl><dt><span class="section"><a href="embed.html#build_embedded">5.1. Building Embedded Programs</a></span></dt><dt><span class="section"><a href="embed.html#embedded_deps">5.2. Embedded Python Dependencies</a></span></dt></dl></dd><dt><span class="chapter"><a href="other.html">6. Interaction with Locally Installed Python Versions</a></span></dt><dt><span class="appendix"><a href="build_dependencies.html">A. Build Dependencies</a></span></dt><dt><span class="appendix"><a href="packaging_tools.html">B. Packaging Tools</a></span></dt><dd><dl><dt><span class="section"><a href="packaging_tools.html#distutils">B.1. distutils</a></span></dt><dt><span class="section"><a href="packaging_tools.html#setuptools">B.2. setuptools</a></span></dt><dt><span class="section"><a href="packaging_tools.html#dh-python">B.3. <code class="literal">dh-python</code></a></span></dt><dt><span class="section"><a href="packaging_tools.html#pybuild">B.4. pybuild</a></span></dt><dt><span class="section"><a href="packaging_tools.html#cdbs">B.5. CDBS</a></span></dt><dt><span class="section"><a href="packaging_tools.html#pysupport">B.6. <code class="literal">python-support</code> (removed)</a></span></dt><dt><span class="section"><a href="packaging_tools.html#pycentral">B.7. <code class="literal">python-central</code> (removed)</a></span></dt></dl></dd><dt><span class="appendix"><a href="upgrade.html">C. Upgrade Procedure</a></span></dt></dl></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="python3.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. On the move to Python 3</td></tr></table></div></body></html>