summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1995-03-30 16:01:15 (GMT)
committerGuido van Rossum <guido@python.org>1995-03-30 16:01:15 (GMT)
commit233aa1d4fc3eca921b353524abe1b9678691c70f (patch)
tree3dcb4dcd993802de7b681547260a28d737c0fa80 /Doc
parent45416028fb73d611eef2a2e7afc5921ad8697e3b (diff)
downloadcpython-233aa1d4fc3eca921b353524abe1b9678691c70f.zip
cpython-233aa1d4fc3eca921b353524abe1b9678691c70f.tar.gz
cpython-233aa1d4fc3eca921b353524abe1b9678691c70f.tar.bz2
rewritten introduction
Diffstat (limited to 'Doc')
-rw-r--r--Doc/lib/libintro.tex60
-rw-r--r--Doc/libintro.tex60
2 files changed, 90 insertions, 30 deletions
diff --git a/Doc/lib/libintro.tex b/Doc/lib/libintro.tex
index fa591ec..4435c1a 100644
--- a/Doc/lib/libintro.tex
+++ b/Doc/lib/libintro.tex
@@ -1,17 +1,47 @@
\chapter{Introduction}
-The Python library consists of three parts, with different levels of
-integration with the interpreter.
-Closest to the interpreter are built-in types, exceptions and functions.
-Next are built-in modules, which are written in \C{} and linked statically
-with the interpreter.
-Finally there are standard modules that are implemented entirely in
-Python, but are always available.
-For efficiency, some standard modules may become built-in modules in
-future versions of the interpreter.
-\indexii{built-in}{types}
-\indexii{built-in}{exceptions}
-\indexii{built-in}{functions}
-\indexii{built-in}{modules}
-\indexii{standard}{modules}
-\indexii{\C{}}{language}
+The ``Python library'' contains several different kinds of components.
+
+It contains data types that would normally be considered part of the
+``core'' of the language, such as numbers and lists. For these types,
+the core language defines the form of literals and places some
+constraints on their semantics, but it does not fully describe the
+semantics. (On the other hand, the core of the language defines
+syntactic properties like the spelling and priorities of operators.)
+
+The library also contains built-in functions and exceptions ---
+objects that can be used by all Python code without the need of an
+\code{import} statement. Some of these are defined by the core
+language, but many are not essential for the core semantics and are
+only described here.
+
+The bulk of the library, however, consists of a collection of modules.
+There are many ways to dissect this collection. Some modules are
+written in C and built in to the Python interpreter; others are
+written in Python and imported in source form. Some modules provide
+interfaces that are highly specific to Python, like printing a stack
+trace; some provide interfaces that are specific to particular
+operating systems, like socket I/O; others provide interfaces that are
+specific to a particular application domain, like the World-Wide Web.
+Some modules are avaiable in all versions and ports of Python; others
+are only available when the underlying system supports or requires
+them; yet others are available only when a particular configuration
+option was chosen at the time when Python was compiled and installed.
+
+This manual is organized ``from the inside out'': it first describes
+the built-in data types, then the built-in functions and exceptions,
+and finally the modules, grouped in chapters of related modules. The
+ordering of the chapters as well as the ordering of the modules within
+each chapter is roughly from most relevant to least important.
+
+This means that if you start reading this manual from the start, and
+skip to the next chapter when you get bored, you will get a reasonable
+overview of the available modules and application areas that are
+supported by the Python library. Of course, you don't \emph{have} to
+read it like a novel --- you can also browse the table of contents (in
+front of the manual) or look for a specific function, module or term
+in the index (in the back). And finally, if you enjoy learning about
+random subjects, you choose a random page number (see module
+\code{rand}) and read a section or two.
+
+Let the show begin!
diff --git a/Doc/libintro.tex b/Doc/libintro.tex
index fa591ec..4435c1a 100644
--- a/Doc/libintro.tex
+++ b/Doc/libintro.tex
@@ -1,17 +1,47 @@
\chapter{Introduction}
-The Python library consists of three parts, with different levels of
-integration with the interpreter.
-Closest to the interpreter are built-in types, exceptions and functions.
-Next are built-in modules, which are written in \C{} and linked statically
-with the interpreter.
-Finally there are standard modules that are implemented entirely in
-Python, but are always available.
-For efficiency, some standard modules may become built-in modules in
-future versions of the interpreter.
-\indexii{built-in}{types}
-\indexii{built-in}{exceptions}
-\indexii{built-in}{functions}
-\indexii{built-in}{modules}
-\indexii{standard}{modules}
-\indexii{\C{}}{language}
+The ``Python library'' contains several different kinds of components.
+
+It contains data types that would normally be considered part of the
+``core'' of the language, such as numbers and lists. For these types,
+the core language defines the form of literals and places some
+constraints on their semantics, but it does not fully describe the
+semantics. (On the other hand, the core of the language defines
+syntactic properties like the spelling and priorities of operators.)
+
+The library also contains built-in functions and exceptions ---
+objects that can be used by all Python code without the need of an
+\code{import} statement. Some of these are defined by the core
+language, but many are not essential for the core semantics and are
+only described here.
+
+The bulk of the library, however, consists of a collection of modules.
+There are many ways to dissect this collection. Some modules are
+written in C and built in to the Python interpreter; others are
+written in Python and imported in source form. Some modules provide
+interfaces that are highly specific to Python, like printing a stack
+trace; some provide interfaces that are specific to particular
+operating systems, like socket I/O; others provide interfaces that are
+specific to a particular application domain, like the World-Wide Web.
+Some modules are avaiable in all versions and ports of Python; others
+are only available when the underlying system supports or requires
+them; yet others are available only when a particular configuration
+option was chosen at the time when Python was compiled and installed.
+
+This manual is organized ``from the inside out'': it first describes
+the built-in data types, then the built-in functions and exceptions,
+and finally the modules, grouped in chapters of related modules. The
+ordering of the chapters as well as the ordering of the modules within
+each chapter is roughly from most relevant to least important.
+
+This means that if you start reading this manual from the start, and
+skip to the next chapter when you get bored, you will get a reasonable
+overview of the available modules and application areas that are
+supported by the Python library. Of course, you don't \emph{have} to
+read it like a novel --- you can also browse the table of contents (in
+front of the manual) or look for a specific function, module or term
+in the index (in the back). And finally, if you enjoy learning about
+random subjects, you choose a random page number (see module
+\code{rand}) and read a section or two.
+
+Let the show begin!