Add NEWS entry as per RDM's suggestion (the bug was actually present
[python.git] / Doc / library / index.rst
blobf25724ce3fef0665a6aa6bbee097a0d20f6a98ee
1 .. _library-index:
3 ###############################
4   The Python Standard Library
5 ###############################
7 :Release: |version|
8 :Date: |today|
10 While :ref:`reference-index` describes the exact syntax and
11 semantics of the Python language, this library reference manual
12 describes the standard library that is distributed with Python. It also
13 describes some of the optional components that are commonly included
14 in Python distributions.
16 Python's standard library is very extensive, offering a wide range of
17 facilities as indicated by the long table of contents listed below. The
18 library contains built-in modules (written in C) that provide access to
19 system functionality such as file I/O that would otherwise be
20 inaccessible to Python programmers, as well as modules written in Python
21 that provide standardized solutions for many problems that occur in
22 everyday programming. Some of these modules are explicitly designed to
23 encourage and enhance the portability of Python programs by abstracting
24 away platform-specifics into platform-neutral APIs.
26 The Python installers for the Windows platform usually includes
27 the entire standard library and often also include many additional
28 components. For Unix-like operating systems Python is normally provided
29 as a collection of packages, so it may be necessary to use the packaging
30 tools provided with the operating system to obtain some or all of the
31 optional components.
33 In addition to the standard library, there is a growing collection of
34 several thousand components (from individual programs and modules to
35 packages and entire application development frameworks), available from
36 the `Python Package Index <http://pypi.python.org/pypi>`_.
39 .. toctree::
40    :maxdepth: 2
41    :numbered:
43    intro.rst
44    functions.rst
45    constants.rst
46    objects.rst
47    stdtypes.rst
48    exceptions.rst
50    strings.rst
51    datatypes.rst
52    numeric.rst
53    filesys.rst
54    persistence.rst
55    archiving.rst
56    fileformats.rst
57    crypto.rst
58    allos.rst
59    someos.rst
60    ipc.rst
61    netdata.rst
62    markup.rst
63    internet.rst
64    mm.rst
65    i18n.rst
66    frameworks.rst
67    tk.rst
68    development.rst
69    debug.rst
70    python.rst
71    custominterp.rst
72    restricted.rst
73    modules.rst
74    language.rst
75    compiler.rst
76    misc.rst
77    windows.rst
78    unix.rst
79    mac.rst
80    macosa.rst
81    sgi.rst
82    sun.rst
83    undoc.rst