source: general/prog/python2.xml@ c8b4decb

10.0 10.1 11.0 11.1 11.2 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since c8b4decb was c8b4decb, checked in by Pierre Labastie <pieere@…>, 5 years ago

Change Python documentation download urls to something more permanent
(the url containing "archive" only points to the most recent version)

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

  • Property mode set to 100644
File size: 11.1 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 "1f6db41ad91d9eb0a6f0c769b8613c5b">
11 <!ENTITY python2-size "12 MB">
12 <!ENTITY python2-buildsize "127 MB (additional 18 MB for tests)">
13 <!ENTITY python2-time "0.9 SBU (additional 4.3 SBU for tests)">
14
15 <!ENTITY python2htmldoc-download-http
16 "https://docs.python.org/ftp/python/doc/&python2-version;/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 &lfs81_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>--with-ensurepip=yes</parameter> : This switch enables building
195 <command>pip</command> and <command>setuptools</command> packaging programs.
196 <command>setuptools</command> is needed for building some Python modules.
197 </para>
198
199 <para>
200 <parameter>--enable-unicode=ucs4</parameter>: This switch enables
201 32bit Unicode support in <application>Python</application>.
202 </para>
203
204 <para>
205 <option>--with-dbmliborder=bdb:gdbm:ndbm</option>: Use this switch
206 if you want to build <application>Python</application> DBM Module
207 against <application>Berkeley DB</application> instead of
208 <application>GDBM</application>.
209 </para>
210
211 <para>
212 <command>chmod ...</command>: Fix permissions for libraries to be
213 consistent with other libraries.
214 </para>
215
216 </sect2>
217
218 <sect2 role="configuration">
219 <title>Configuring Python 2</title>
220
221 <para>
222 In order for <command>python</command> to find the installed
223 documentation, you must add the following environment variable to
224 individual user's or the system's profile:
225 </para>
226
227<screen role="root"><userinput>export PYTHONDOCS=/usr/share/doc/python-&python2-version;</userinput></screen>
228
229 </sect2>
230
231 <sect2 role="content">
232 <title>Contents</title>
233
234 <segmentedlist>
235 <segtitle>Installed Programs</segtitle>
236 <segtitle>Installed Library</segtitle>
237 <segtitle>Installed Directories</segtitle>
238
239 <seglistitem>
240 <seg>
241 2to3, pydoc, python (symlink), python-config (symlink),
242 python2 (symlink), python2-config (symlink),
243 python&python2-majorver;, python&python2-majorver;-config,
244 smtpd.py, and idle
245 </seg>
246 <seg>
247 libpython&python2-majorver;.so
248 </seg>
249 <seg>
250 /usr/{include,lib}/python&python2-majorver; and
251 /usr/share/doc/python-&python2-version;
252 </seg>
253 </seglistitem>
254 </segmentedlist>
255
256 <variablelist>
257 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
258 <?dbfo list-presentation="list"?>
259 <?dbhtml list-presentation="table"?>
260
261 <varlistentry id="python2-2to3">
262 <term><command>2to3</command></term>
263 <listitem>
264 <para>
265 is a <application>Python</application> program that reads
266 <application>Python 2.x</application> source code and applies a
267 series of fixes to transform it into valid
268 <application>Python 3.x</application> code.
269 </para>
270 <indexterm zone="python2 python2-2to3">
271 <primary sortas="b-2to3">2to3</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 <varlistentry id="idle">
277 <term><command>idle</command></term>
278 <listitem>
279 <para>
280 is a wrapper script that opens a <application>Python</application>
281 aware GUI editor. For this script to run, you must have installed
282 <application>Tk</application> before Python so that the Tkinter
283 Python module is built.
284 </para>
285 <indexterm zone="python2 idle">
286 <primary sortas="b-idle">idle</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="pydoc2">
292 <term><command>pydoc</command></term>
293 <listitem>
294 <para>
295 is the <application>Python</application> documentation tool.
296 </para>
297 <indexterm zone="python2 pydoc2">
298 <primary sortas="b-pydoc2">pydoc</primary>
299 </indexterm>
300 </listitem>
301 </varlistentry>
302
303 <varlistentry id="python">
304 <term><command>python</command></term>
305 <listitem>
306 <para>
307 is an interpreted, interactive, object-oriented programming
308 language.
309 </para>
310 <indexterm zone="python2 python">
311 <primary sortas="b-python2">python</primary>
312 </indexterm>
313 </listitem>
314 </varlistentry>
315
316 <varlistentry id="python2-ver">
317 <term><command>python&python2-majorver;</command></term>
318 <listitem>
319 <para>
320 is a version-specific name for the <command>python</command>
321 program.
322 </para>
323 <indexterm zone="python2 python2-ver">
324 <primary sortas="b-python&python2-majorver;">python&python2-majorver;</primary>
325 </indexterm>
326 </listitem>
327 </varlistentry>
328
329 <varlistentry id="smtpd.py">
330 <term><command>smtpd.py</command></term>
331 <listitem>
332 <para>
333 is an SMTP proxy implemented in <application>Python</application>.
334 </para>
335 <indexterm zone="python2 smtpd.py">
336 <primary sortas="b-smtpd.py">smtpd.py</primary>
337 </indexterm>
338 </listitem>
339 </varlistentry>
340
341 </variablelist>
342
343 </sect2>
344
345</sect1>
Note: See TracBrowser for help on using the repository browser.