PLD-Guide python.xml,1.9,1.10

[Artur Wróblewski]

Module name:    PLD-Guide
Changes by:     wrobell

Changed RCS file: /cvsroot/LDP/guide/docbook/PLD-Guide/devel/python.xml,v
----------------------------
revision 1.10
date: 2002/07/02 14:37:13;  author: wrobell;  state: Exp;  lines: +118 -0
- list of and info about Python langauge packages
 

Index: python.xml
===================================================================
RCS file: /cvsroot/LDP/guide/docbook/PLD-Guide/devel/python.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- python.xml	14 Jun 2002 16:15:04 -0000	1.9
+++ python.xml	2 Jul 2002 14:37:13 -0000	1.10
@@ -51,7 +51,125 @@
     <section id='python.lang'>
         <title>Python Language</title>
         <para>
+            Python language is splitted into several packages, which are listed below.
+        </para>
+        <para>
+            Package with Python library contains some basic modules. The modules are required
+            to use the library with applications embedding simple Python code.
+            Some people could complain, that there is no <literal>sys</literal> module,
+            which seems to be basic for most of us. The word &apos;basic&apos; means &apos;is required&apos;,
+            so simple Python code embedding works. Consider following listing.
+            <programlisting>
+                <![CDATA[
+#include &lt;Python.h&gt;
+
+int main(int argc, char *argv[]) {
+    Py_Initialize();
+    PyRun_SimpleString("print 2**4");
+    Py_Finalize();
+    return 0;
+}
+                ]]>
+            </programlisting>
+            If the modules are not present, then there will be the error message
+            that Python cannot find platform independent libraries.
         </para>
+        <para>
+            One can easily note, that sources of standard Python modules are distributed
+            in <literal>python-devel-src</literal> package. It is an exception to the rule,
+            that we do not distribute sources of modules for Python language.
+        </para>
+        <variablelist>
+            <varlistentry>
+                <term>python</term>
+                <listitem>
+                    <para>
+                        Python command line utility and its manual.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>python-modules</term>
+                <listitem>
+                    <para>
+                        Standard Python modules.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>python-libs</term>
+                <listitem>
+                    <para>
+                        Python library and basic modules.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>python-pydoc</term>
+                <listitem>
+                    <para>
+                        PyDoc module and command line utility.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>python-devel</term>
+                <listitem>
+                    <para>
+                        Development files, i.e. header and Python config files.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>python-devel-src</term>
+                <listitem>
+                    <para>
+                        Sources of all standard Python modules.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>python-static</term>
+                <listitem>
+                    <para>
+                        Python static library.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>python-examples</term>
+                <listitem>
+                    <para>
+                        All examples and tools which come with standard Python distribution.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>python-doc</term>
+                <listitem>
+                    <para>
+                        Python documentation in HTML format. It contains tutorial, global module index, library and
+                        language reference, etc.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>tkinter</term>
+                <listitem>
+                    <para>
+                        Standard Python interface to the Tk GUI toolkit.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>python-old</term>
+                <listitem>
+                    <para>
+                        Obsoleted Python modules.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
     </section>
     <section id='python.modules'>
         <title>Python Modules</title>