Continue going through the language reference, bringing it up-to-date.
In particular, document the new comprehensions and remove mentions of long integers.
Fix a bunch of related things in the lib ref.
diff --git a/Doc/library/constants.rst b/Doc/library/constants.rst
index c36b2fa..634656a 100644
--- a/Doc/library/constants.rst
+++ b/Doc/library/constants.rst
@@ -5,6 +5,11 @@
A small number of constants live in the built-in namespace. They are:
+.. note::
+
+ :data:`None`, :data:`False`, :data:`True` and :data:`__debug__` cannot be
+ reassigned, so they can be considered "true" constants.
+
.. XXX False, True, None are keywords too
.. data:: False
@@ -37,3 +42,10 @@
slicing syntax for user-defined container data types, as in ::
val = container[1:5, 7:10, ...]
+
+
+.. data:: __debug__
+
+ A boolean value that is :data:`True` if Python was not started with the
+ ``-O`` command line option. Its value is used indirectly by the
+ :keyword:`assert` statement, but it can also be used directly in code.
diff --git a/Doc/library/fileinput.rst b/Doc/library/fileinput.rst
index ba7e980..fd84139 100644
--- a/Doc/library/fileinput.rst
+++ b/Doc/library/fileinput.rst
@@ -19,10 +19,10 @@
This iterates over the lines of all files listed in ``sys.argv[1:]``, defaulting
to ``sys.stdin`` if the list is empty. If a filename is ``'-'``, it is also
replaced by ``sys.stdin``. To specify an alternative list of filenames, pass it
-as the first argument to :func:`input`. A single file name is also allowed.
+as the first argument to :func:`.input`. A single file name is also allowed.
All files are opened in text mode by default, but you can override this by
-specifying the *mode* parameter in the call to :func:`input` or
+specifying the *mode* parameter in the call to :func:`.input` or
:class:`FileInput()`. If an I/O error occurs during opening or reading a file,
:exc:`IOError` is raised.
diff --git a/Doc/library/new.rst b/Doc/library/new.rst
index 438329f..6153ff1 100644
--- a/Doc/library/new.rst
+++ b/Doc/library/new.rst
@@ -50,4 +50,4 @@
This function returns a new class object, with name *name*, derived from
*baseclasses* (which should be a tuple of classes) and with namespace *dict*.
-
+ Alias for the built-in :class:`type`.
diff --git a/Doc/library/readline.rst b/Doc/library/readline.rst
index ed2027d..7727c3b 100644
--- a/Doc/library/readline.rst
+++ b/Doc/library/readline.rst
@@ -12,8 +12,8 @@
completion and reading/writing of history files from the Python interpreter.
This module can be used directly or via the :mod:`rlcompleter` module. Settings
made using this module affect the behaviour of both the interpreter's
-interactive prompt and the prompts offered by the :func:`raw_input` and
-:func:`input` built-in functions.
+interactive prompt and the prompts offered by the built-in :func:`input`
+function.
The :mod:`readline` module defines the following functions: