source: general/prog/python2.xml@ 879932f

10.0 10.1 11.0 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 879932f was 879932f, checked in by Douglas R. Reno <renodr@…>, 5 years ago

Archive setuptools
Modify Python instructions to add setuptools and pip as part of the installation
Tags for the Python section + a few others

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@18316 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 10.8 KB
Line 
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 <!ENTITY python2-download-http
8 "https://www.python.org/ftp/python/&python2-version;/Python-&python2-version;.tar.xz">
9 <!ENTITY python2-download-ftp " ">
10 <!ENTITY python2-md5sum "53b43534153bb2a0363f08bae8b9d990">
11 <!ENTITY python2-size "12 MB">
12 <!ENTITY python2-buildsize "253 MB (additional 18 MB for tests)">
13 <!ENTITY python2-time "0.8 SBU (additional 4.3 SBU for tests)">
14
15 <!ENTITY python2htmldoc-download-http
16 "https://docs.python.org/2.7/archives/python-&python2-version;-docs-html.tar.bz2">
17]>
18
19<sect1 id="python2" xreflabel="Python-&python2-version;">
20 <?dbhtml filename="python2.html" ?>
21
22 <sect1info>
23 <othername>$LastChangedBy$</othername>
24 <date>$Date$</date>
25 </sect1info>
26
27 <title>Python-&python2-version;</title>
28
29 <indexterm zone="python2">
30 <primary sortas="a-Python2">Python2</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to Python 2</title>
35
36 <para>
37 The <application>Python 2</application> package contains the
38 <application>Python</application> development environment. It is useful
39 for object-oriented programming, writing scripts, prototyping large
40 programs or developing entire applications. This version is for backward
41 compatibility with other dependent packages.
42 </para>
43
44 &lfs80_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>
50 Download (HTTP): <ulink url="&python2-download-http;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download (FTP): <ulink url="&python2-download-ftp;"/>
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download MD5 sum: &python2-md5sum;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download size: &python2-size;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated disk space required: &python2-buildsize;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated build time: &python2-time;
76 </para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
81
82 <itemizedlist spacing="compact">
83 <title>Optional HTML Documentation</title>
84 <listitem>
85 <para>
86 Download (HTTP): <ulink url="&python2htmldoc-download-http;"/>
87 </para>
88 </listitem>
89 </itemizedlist>
90
91 <bridgehead renderas="sect3">Python 2 Dependencies</bridgehead>
92
93 <bridgehead renderas="sect4">Recommended</bridgehead>
94 <para role="recommended">
95 <xref linkend="libffi"/>
96 </para>
97
98 <bridgehead renderas="sect4">Optional</bridgehead>
99 <para role="optional">
100 <xref linkend="bluez"/> and
101 <xref linkend="valgrind"/>
102 </para>
103
104 <bridgehead renderas="sect4">Optional (For Additional Modules)</bridgehead>
105 <para role="optional">
106 <xref linkend="openssl"/>,
107 <xref linkend="sqlite"/> and
108 <xref linkend="tk"/>
109 </para>
110
111 <note>
112 <para>
113 <!-- new for ff31. Any reasonable version of openssl will do,
114 even old maintained versions, so do not xref openssl here -->
115 If you are building <xref linkend="thunderbird"/> or
116 <xref linkend="firefox"/>
117 you must install <application>openssl</application> before you build
118 <application>Python 2</application>.
119 </para>
120 </note>
121
122 <para condition="html" role="usernotes">
123 User Notes: <ulink url="&blfs-wiki;/Python"/>
124 </para>
125 </sect2>
126
127 <sect2 role="installation">
128 <title>Installation of Python 2</title>
129
130 <para>
131 Install <application>Python 2</application> by running the following
132 commands:
133 </para>
134
135<screen><userinput>./configure --prefix=/usr \
136 --enable-shared \
137 --with-system-expat \
138 --with-system-ffi \
139 --with-ensurepip=yes \
140 --enable-unicode=ucs4 &amp;&amp;
141make</userinput></screen>
142
143 <para>
144 To test the results, issue: <command>make -k test</command>.
145 One test fails for unknown reasons.
146 </para>
147
148 <para>
149 Now, as the <systemitem class="username">root</systemitem> user:
150 </para>
151
152<screen role="root"><userinput>make install &amp;&amp;
153chmod -v 755 /usr/lib/libpython&python2-majorver;.so.1.0</userinput></screen>
154
155 <para>
156 Since <application>Python 2</application> is in maintenance mode, and
157 <application>Python 3</application> is recommended by upstream for
158 development, you probably do not need to install the documentation.
159 However, if you still want to install documentation for both
160 <application>Python</application> versions, be sure to define the
161 <envar>PYTHONDOCS</envar>
162 variable for the version you want to use, each time you need to consult
163 the documentation. If you have downloaded the preformatted documentation
164 from <ulink url="http://docs.python.org/download.html"/>, install it
165 as the <systemitem class="username">root</systemitem> user:
166 </para>
167
168<screen role="root"><userinput>install -v -dm755 /usr/share/doc/python-&python2-version; &amp;&amp;
169
170tar --strip-components=1 \
171 --no-same-owner \
172 --directory /usr/share/doc/python-&python2-version; \
173 -xvf ../python-&python2-version;-docs-html.tar.bz2 &amp;&amp;
174
175find /usr/share/doc/python-&python2-version; -type d -exec chmod 0755 {} \; &amp;&amp;
176find /usr/share/doc/python-&python2-version; -type f -exec chmod 0644 {} \;</userinput></screen>
177 </sect2>
178
179 <sect2 role="commands">
180 <title>Command Explanations</title>
181
182 <para>
183 <parameter>--with-system-expat</parameter>: This switch enables linking
184 against system version of <application>Expat</application>.
185 </para>
186
187 <para>
188 <parameter>--with-system-ffi</parameter>: This switch enables linking
189 against system version of <application>libffi</application>. Remove if
190 you have not installed <xref linkend="libffi"/>.
191 </para>
192
193 <para>
194 <parameter>--enable-unicode=ucs4</parameter>: This switch enables
195 32bit Unicode support in <application>Python</application>.
196 </para>
197
198 <para>
199 <option>--with-dbmliborder=bdb:gdbm:ndbm</option>: Use this switch
200 if you want to build <application>Python</application> DBM Module
201 against <application>Berkeley DB</application> instead of
202 <application>GDBM</application>.
203 </para>
204
205 <para>
206 <command>chmod ...</command>: Fix permissions for libraries to be
207 consistent with other libraries.
208 </para>
209
210 </sect2>
211
212 <sect2 role="configuration">
213 <title>Configuring Python 2</title>
214
215 <para>
216 In order for <command>python</command> to find the installed
217 documentation, you must add the following environment variable to
218 individual user's or the system's profile:
219 </para>
220
221<screen role="root"><userinput>export PYTHONDOCS=/usr/share/doc/python-&python2-version;</userinput></screen>
222
223 </sect2>
224
225 <sect2 role="content">
226 <title>Contents</title>
227
228 <segmentedlist>
229 <segtitle>Installed Programs</segtitle>
230 <segtitle>Installed Library</segtitle>
231 <segtitle>Installed Directories</segtitle>
232
233 <seglistitem>
234 <seg>
235 2to3, pydoc, python (symlink), python-config (symlink),
236 python2 (symlink), python2-config (symlink),
237 python&python2-majorver;, python&python2-majorver;-config,
238 smtpd.py, and idle
239 </seg>
240 <seg>
241 libpython&python2-majorver;.so
242 </seg>
243 <seg>
244 /usr/{include,lib}/python&python2-majorver; and
245 /usr/share/doc/python-&python2-version;
246 </seg>
247 </seglistitem>
248 </segmentedlist>
249
250 <variablelist>
251 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
252 <?dbfo list-presentation="list"?>
253 <?dbhtml list-presentation="table"?>
254
255 <varlistentry id="python2-2to3">
256 <term><command>2to3</command></term>
257 <listitem>
258 <para>
259 is a <application>Python</application> program that reads
260 <application>Python 2.x</application> source code and applies a
261 series of fixes to transform it into valid
262 <application>Python 3.x</application> code.
263 </para>
264 <indexterm zone="python2 python2-2to3">
265 <primary sortas="b-2to3">2to3</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="idle">
271 <term><command>idle</command></term>
272 <listitem>
273 <para>
274 is a wrapper script that opens a <application>Python</application>
275 aware GUI editor. For this script to run, you must have installed
276 <application>Tk</application> before Python so that the Tkinter
277 Python module is built.
278 </para>
279 <indexterm zone="python2 idle">
280 <primary sortas="b-idle">idle</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="pydoc2">
286 <term><command>pydoc</command></term>
287 <listitem>
288 <para>
289 is the <application>Python</application> documentation tool.
290 </para>
291 <indexterm zone="python2 pydoc2">
292 <primary sortas="b-pydoc2">pydoc</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 <varlistentry id="python">
298 <term><command>python</command></term>
299 <listitem>
300 <para>
301 is an interpreted, interactive, object-oriented programming
302 language.
303 </para>
304 <indexterm zone="python2 python">
305 <primary sortas="b-python2">python</primary>
306 </indexterm>
307 </listitem>
308 </varlistentry>
309
310 <varlistentry id="python2-ver">
311 <term><command>python&python2-majorver;</command></term>
312 <listitem>
313 <para>
314 is a version-specific name for the <command>python</command>
315 program.
316 </para>
317 <indexterm zone="python2 python2-ver">
318 <primary sortas="b-python&python2-majorver;">python&python2-majorver;</primary>
319 </indexterm>
320 </listitem>
321 </varlistentry>
322
323 <varlistentry id="smtpd.py">
324 <term><command>smtpd.py</command></term>
325 <listitem>
326 <para>
327 is an SMTP proxy implemented in <application>Python</application>.
328 </para>
329 <indexterm zone="python2 smtpd.py">
330 <primary sortas="b-smtpd.py">smtpd.py</primary>
331 </indexterm>
332 </listitem>
333 </varlistentry>
334
335 </variablelist>
336
337 </sect2>
338
339</sect1>
Note: See TracBrowser for help on using the repository browser.