source: general/prog/python2.xml@ 60d53ec3

10.0 10.1 11.0 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 60d53ec3 was 60d53ec3, checked in by Bruce Dubbs <bdubbs@…>, 6 years ago

Tags and some minor formatting

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@16435 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 "c685ef0b8e9f27b5e3db5db12b268ac6">
11 <!ENTITY python2-size "12 MB">
12 <!ENTITY python2-buildsize "227 MB (additional 18 MB for the tests)">
13 <!ENTITY python2-time "0.8 SBU (additional 5.5 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 &lfs78_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 --enable-unicode=ucs4 &amp;&amp;
140make</userinput></screen>
141
142 <para>
143 To test the results, issue: <command>make -k test</command>.
144 One test fails for unknown reasons.
145 </para>
146
147 <para>
148 Now, as the <systemitem class="username">root</systemitem> user:
149 </para>
150
151<screen role="root"><userinput>make install &amp;&amp;
152chmod -v 755 /usr/lib/libpython&python2-majorver;.so.1.0</userinput></screen>
153
154 <para>
155 Since <application>Python 2</application> is in maintenance mode, and
156 <application>Python 3</application> is recommended by upstream for
157 development, you probably do not need to install the documentation.
158 However, if you still want to install documentation for both
159 <application>Python</application> versions, be sure to define the
160 <envar>PYTHONDOCS</envar>
161 variable for the version you want to use, each time you need to consult
162 the documentation. If you have downloaded the preformatted documentation
163 from <ulink url="http://docs.python.org/download.html"/>, install it
164 as the <systemitem class="username">root</systemitem> user:
165 </para>
166
167<screen role="root"><userinput>install -v -dm755 /usr/share/doc/python-&python2-version; &amp;&amp;
168
169tar --strip-components=1 \
170 --no-same-owner \
171 --directory /usr/share/doc/python-&python2-version; \
172 -xvf ../python-&python2-version;-docs-html.tar.bz2 &amp;&amp;
173
174find /usr/share/doc/python-&python2-version; -type d -exec chmod 0755 {} \; &amp;&amp;
175find /usr/share/doc/python-&python2-version; -type f -exec chmod 0644 {} \;</userinput></screen>
176 </sect2>
177
178 <sect2 role="commands">
179 <title>Command Explanations</title>
180
181 <para>
182 <option>--with-system-expat</option>: This switch enables linking against
183 system version of <application>Expat</application>.
184 </para>
185
186 <para>
187 <option>--with-system-ffi</option>: This switch enables linking against
188 system version of <application>libffi</application>. Remove if you have
189 not installed <xref linkend="libffi"/>.
190 </para>
191
192 <para>
193 <parameter>--enable-unicode=ucs4</parameter>: This switch enables
194 32bit Unicode support in <application>Python</application>.
195 </para>
196
197 <para>
198 <parameter>--with-dbmliborder=bdb:gdbm:ndbm</parameter>: Use this switch
199 if you want to build <application>Python</application> DBM Module
200 against <application>Berkeley DB</application> instead of
201 <application>GDBM</application>.
202 </para>
203
204 <para>
205 <command>chmod ...</command>: Fix permissions for libraries to be
206 consistent with other libraries.
207 </para>
208
209 </sect2>
210
211 <sect2 role="configuration">
212 <title>Configuring Python 2</title>
213
214 <para>
215 In order for <command>python</command> to find the installed
216 documentation, you must add the following environment variable to
217 individual user's or the system's profile:
218 </para>
219
220<screen role="root"><userinput>export PYTHONDOCS=/usr/share/doc/python-&python2-version;</userinput></screen>
221
222 </sect2>
223
224 <sect2 role="content">
225 <title>Contents</title>
226
227 <segmentedlist>
228 <segtitle>Installed Programs</segtitle>
229 <segtitle>Installed Library</segtitle>
230 <segtitle>Installed Directories</segtitle>
231
232 <seglistitem>
233 <seg>
234 2to3, pydoc, python (symlink), python-config (symlink),
235 python2 (symlink), python2-config (symlink),
236 python&python2-majorver;, python&python2-majorver;-config,
237 smtpd.py, and idle
238 </seg>
239 <seg>
240 libpython&python2-majorver;.so
241 </seg>
242 <seg>
243 /usr/include/python&python2-majorver;,
244 /usr/lib/python&python2-majorver;, and
245 /usr/share/doc/python-&python2-version;</seg>
246 </seglistitem>
247 </segmentedlist>
248
249 <variablelist>
250 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
251 <?dbfo list-presentation="list"?>
252 <?dbhtml list-presentation="table"?>
253
254 <varlistentry id="python2-2to3">
255 <term><command>2to3</command></term>
256 <listitem>
257 <para>
258 is a <application>Python</application> program that reads
259 <application>Python 2.x</application> source code and applies a series of
260 fixers to transform it into valid <application>Python 3.x</application>
261 code.
262 </para>
263 <indexterm zone="python2 python2-2to3">
264 <primary sortas="b-2to3">2to3</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 <varlistentry id="idle">
270 <term><command>idle</command></term>
271 <listitem>
272 <para>
273 is a wrapper script that opens a <application>Python</application>
274 aware GUI editor. For this script to run, you must have installed
275 <application>Tk</application> before Python so that the Tkinter
276 Python module is built.
277 </para>
278 <indexterm zone="python2 idle">
279 <primary sortas="b-idle">idle</primary>
280 </indexterm>
281 </listitem>
282 </varlistentry>
283
284 <varlistentry id="pydoc2">
285 <term><command>pydoc</command></term>
286 <listitem>
287 <para>
288 is the <application>Python</application> documentation tool.
289 </para>
290 <indexterm zone="python2 pydoc2">
291 <primary sortas="b-pydoc2">pydoc</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="python">
297 <term><command>python</command></term>
298 <listitem>
299 <para>
300 is an interpreted, interactive, object-oriented programming
301 language.
302 </para>
303 <indexterm zone="python2 python">
304 <primary sortas="b-python2">python</primary>
305 </indexterm>
306 </listitem>
307 </varlistentry>
308
309 <varlistentry id="python2-ver">
310 <term><command>python&python2-majorver;</command></term>
311 <listitem>
312 <para>
313 is a version-specific name for the <command>python</command>
314 program.
315 </para>
316 <indexterm zone="python2 python2-ver">
317 <primary sortas="b-python&python2-majorver;">python&python2-majorver;</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="smtpd.py">
323 <term><command>smtpd.py</command></term>
324 <listitem>
325 <para>
326 is an SMTP proxy implemented in <application>Python</application>.
327 </para>
328 <indexterm zone="python2 smtpd.py">
329 <primary sortas="b-smtpd.py">smtpd.py</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 </variablelist>
335
336 </sect2>
337
338</sect1>
Note: See TracBrowser for help on using the repository browser.