python.xml 7.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  3. "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  4. <!ENTITY % general-entities SYSTEM "../general.ent">
  5. %general-entities;
  6. ]>
  7. <sect1 id="ch-system-Python" role="wrap">
  8. <?dbhtml filename="Python.html"?>
  9. <sect1info condition="script">
  10. <productname>Python</productname>
  11. <productnumber>&python-version;</productnumber>
  12. <address>&python-url;</address>
  13. </sect1info>
  14. <title>Python-&python-version;</title>
  15. <indexterm zone="ch-system-Python">
  16. <primary sortas="a-Python">Python</primary>
  17. </indexterm>
  18. <sect2 role="package">
  19. <title/>
  20. <para>The Python 3 package contains the Python development environment. It
  21. is useful for object-oriented programming, writing scripts, prototyping
  22. large programs, or developing entire applications.</para>
  23. <segmentedlist>
  24. <segtitle>&buildtime;</segtitle>
  25. <segtitle>&diskspace;</segtitle>
  26. <seglistitem>
  27. <seg>&python-fin-sbu;</seg>
  28. <seg>&python-fin-du;</seg>
  29. </seglistitem>
  30. </segmentedlist>
  31. </sect2>
  32. <sect2 role="installation">
  33. <title>Installation of Python 3</title>
  34. <para>Prepare Python for compilation:</para>
  35. <screen><userinput remap="configure">./configure --prefix=/usr \
  36. --enable-shared \
  37. --with-system-expat \
  38. --with-system-ffi \
  39. --with-ensurepip=yes</userinput></screen>
  40. <variablelist>
  41. <title>The meaning of the configure options:</title>
  42. <varlistentry>
  43. <term><parameter>--with-system-expat</parameter></term>
  44. <listitem>
  45. <para>This switch enables linking against system version of
  46. <application>Expat</application>.</para>
  47. </listitem>
  48. </varlistentry>
  49. <varlistentry>
  50. <term><parameter>--with-system-ffi</parameter></term>
  51. <listitem>
  52. <para>This switch enables linking against system version of
  53. <application>libffi</application>.</para>
  54. </listitem>
  55. </varlistentry>
  56. <varlistentry>
  57. <term><parameter>--with-ensurepip=yes</parameter></term>
  58. <listitem>
  59. <para>This switch enables building <command>pip</command> and
  60. <command>setuptools</command> packaging programs.</para>
  61. </listitem>
  62. </varlistentry>
  63. </variablelist>
  64. <para>Compile the package:</para>
  65. <screen><userinput remap="make">make</userinput></screen>
  66. <para>To test the results, issue:</para>
  67. <screen><userinput remap="test">make test</userinput></screen>
  68. <para>Some tests requiring a network connection or additional packages are
  69. skipped. The test named test_unicodedata fails because network
  70. configuration is not completed yet. For more comprehensive results,
  71. the test can be rerun when Python 3 is reinstalled in BLFS.</para>
  72. <para>Install the package:</para>
  73. <screen><userinput remap="install">make install
  74. chmod -v 755 /usr/lib/libpython&python-minor;.so
  75. chmod -v 755 /usr/lib/libpython3.so
  76. ln -sfv pip&python-minor; /usr/bin/pip3</userinput></screen>
  77. <variablelist>
  78. <title>The meaning of the install commands:</title>
  79. <!-- ====== Change 8m if Python minor version changes ======= -->
  80. <varlistentry>
  81. <term><command>chmod -v 755 /usr/lib/libpython3.{8.,}so</command></term>
  82. <listitem>
  83. <para>Fix permissions for libraries to be consistent with other
  84. libraries.</para>
  85. </listitem>
  86. </varlistentry>
  87. </variablelist>
  88. <para>If desired, install the preformatted documentation:</para>
  89. <screen><userinput remap="install">install -v -dm755 /usr/share/doc/python-&python-version;/html
  90. tar --strip-components=1 \
  91. --no-same-owner \
  92. --no-same-permissions \
  93. -C /usr/share/doc/python-&python-version;/html \
  94. -xvf ../python-&python-version;-docs-html.tar.bz2</userinput></screen>
  95. <variablelist>
  96. <title>The meaning of the documentation install commands:</title>
  97. <varlistentry>
  98. <term><option>--no-same-owner</option> and <option>--no-same-permissions</option></term>
  99. <listitem>
  100. <para>Ensure the installed files have the correct ownership and
  101. permissions. Without these options, using <application>tar</application>
  102. will install the package files with the upstream creator's values.
  103. </para>
  104. </listitem>
  105. </varlistentry>
  106. </variablelist>
  107. </sect2>
  108. <sect2 id="contents-python" role="content">
  109. <title>Contents of Python 3</title>
  110. <segmentedlist>
  111. <segtitle>Installed Programs</segtitle>
  112. <segtitle>Installed Library</segtitle>
  113. <segtitle>Installed Directories</segtitle>
  114. <seglistitem>
  115. <seg>
  116. 2to3, idle3, pip3, pydoc3, python3, and python3-config
  117. </seg>
  118. <seg>
  119. libpython&python-minor;.so and libpython3.so
  120. </seg>
  121. <seg>
  122. /usr/include/python&python-minor;,
  123. /usr/lib/python3, and
  124. /usr/share/doc/python-&python-version;
  125. </seg>
  126. </seglistitem>
  127. </segmentedlist>
  128. <variablelist>
  129. <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  130. <?dbfo list-presentation="list"?>
  131. <?dbhtml list-presentation="table"?>
  132. <varlistentry id="python-2to3">
  133. <term><command>2to3</command></term>
  134. <listitem>
  135. <para>
  136. is a <application>Python</application> program that reads
  137. <application>Python 2.x</application> source code and applies a
  138. series of fixes to transform it into
  139. valid <application>Python 3.x</application> code.
  140. </para>
  141. <indexterm zone="ch-system-Python">
  142. <primary sortas="b-2to3">2to3</primary>
  143. </indexterm>
  144. </listitem>
  145. </varlistentry>
  146. <varlistentry id="idle3">
  147. <term><command>idle3</command></term>
  148. <listitem>
  149. <para>
  150. is a wrapper script that opens a <application>Python</application>
  151. aware GUI editor. For this script to run, you must have installed
  152. <application>Tk</application> before Python so that the Tkinter
  153. Python module is built.
  154. </para>
  155. <indexterm zone="ch-system-Python">
  156. <primary sortas="b-idle3">idle3</primary>
  157. </indexterm>
  158. </listitem>
  159. </varlistentry>
  160. <varlistentry id="pip3">
  161. <term><command>pip3</command></term>
  162. <listitem>
  163. <para>
  164. The package installer for Python. You can use pip to install
  165. packages from Python Package Index and other indexes.
  166. </para>
  167. <indexterm zone="ch-system-Python">
  168. <primary sortas="b-pip3">pip3</primary>
  169. </indexterm>
  170. </listitem>
  171. </varlistentry>
  172. <varlistentry id="pydoc3">
  173. <term><command>pydoc3</command></term>
  174. <listitem>
  175. <para>
  176. is the <application>Python</application> documentation tool.
  177. </para>
  178. <indexterm zone="ch-system-Python">
  179. <primary sortas="b-pydoc3">pydoc3</primary>
  180. </indexterm>
  181. </listitem>
  182. </varlistentry>
  183. <varlistentry id="python3">
  184. <term><command>python3</command></term>
  185. <listitem>
  186. <para>
  187. is an interpreted, interactive, object-oriented programming
  188. language.
  189. </para>
  190. <indexterm zone="ch-system-Python">
  191. <primary sortas="b-python3">python3</primary>
  192. </indexterm>
  193. </listitem>
  194. </varlistentry>
  195. </variablelist>
  196. </sect2>
  197. </sect1>