A few random updates to make things less horrifyingly out of date.

Delete some advice that can never, ever have worked.

There are a couple of XXX comments for bits I don't know how to
update.  It would be really good not to release Python 2.5 with these
in place :)

This file is way too big.  There's basically no chance of it staying
up to date.

README

@@ -35,6 +35,7 @@ What's new in this release?
 
 See the file "Misc/NEWS".
 
+
 If you don't read instructions
 ------------------------------
 
@@ -45,30 +46,29 @@ current directory and when it finishes, type "make".  This creates an
 executable "./python"; to install in /usr/local, first do "su root"
 and then "make install".
 
-The section `Build instructions' below is still recommended reading,
-especially the part on customizing Modules/Setup.
+The section `Build instructions' below is still recommended reading.
 
 
 What is Python anyway?
 ----------------------
 
-Python is an interpreted object-oriented programming language suitable
-(amongst other uses) for distributed application development,
-scripting, numeric computing and system testing.  Python is often
-compared to Tcl, Perl, Java, JavaScript, Visual Basic or Scheme.  To
-find out more about what Python can do for you, point your browser to
-http://www.python.org/.
+Python is an interpreted, interactive object-oriented programming
+language suitable (amongst other uses) for distributed application
+development, scripting, numeric computing and system testing.  Python
+is often compared to Tcl, Perl, Java, JavaScript, Visual Basic or
+Scheme.  To find out more about what Python can do for you, point your
+browser to http://www.python.org/.
 
 
 How do I learn Python?
 ----------------------
 
 The official tutorial is still a good place to start; see
-http://www.python.org/doc/ for online and downloadable versions, as
-well as a list of other introductions, and reference documentation.
+http://docs.python.org/ for online and downloadable versions, as well
+as a list of other introductions, and reference documentation.
 
 There's a quickly growing set of books on Python.  See
-http://www.python.org/cgi-bin/moinmoin/PythonBooks for a list.
+www.python.org/moin/PythonBooks for a list.
 
 
 Documentation
@@ -82,16 +82,17 @@ Python's power is described there, including the built-in data types
 and functions!
 
 All documentation is also available online at the Python web site
-(http://www.python.org/doc/, see below).  It is available online for
+(http://docs.python.org/, see below).  It is available online for
 occasional reference, or can be downloaded in many formats for faster
 access.  The documentation is available in HTML, PostScript, PDF, and
 LaTeX formats; the LaTeX version is primarily for documentation
 authors, translators, and people with special formatting requirements.
 
-The best documentation for the new (in Python 2.2) type/class
-unification features is Guido's tutorial introduction, at
+Unfortunately, new-style classes (new in Python 2.2) have not yet been
+integrated into Python's standard documention.  A collection of
+pointers to what has been written is at:
 
-    http://www.python.org/2.2.1/descrintro.html
+    http://www.python.org/doc/newstyle.html
 
 
 Web sites
@@ -110,12 +111,12 @@ Newsgroups and Mailing Lists
 Read comp.lang.python, a high-volume discussion newsgroup about
 Python, or comp.lang.python.announce, a low-volume moderated newsgroup
 for Python-related announcements.  These are also accessible as
-mailing lists: see http://www.python.org/psa/MailingLists.html for an
-overview of the many Python-related mailing lists.
+mailing lists: see http://www.python.org/community/lists.html for an
+overview of these and many other Python-related mailing lists.
 
 Archives are accessible via the Google Groups usenet archive; see
 http://groups.google.com/.  The mailing lists are also archived, see
-http://www.python.org/psa/MailingLists.html for details.
+http://www.python.org/community/lists.html for details.
 
 
 Bug reports
@@ -135,7 +136,7 @@ for patch submission may be found at http://www.python.org/patches/.
 If you have a proposal to change Python, it's best to submit a Python
 Enhancement Proposal (PEP) first.  All current PEPs, as well as
 guidelines for submitting a new PEP, are listed at
-http://python.sourceforge.net/peps/.
+http://www.python.org/peps/.
 
 
 Questions
@@ -189,10 +190,9 @@ Troubleshooting
 
 See also the platform specific notes in the next section.
 
-If you run into other trouble, see section 3 of the FAQ
-(http://www.python.org/cgi-bin/faqw.py or
-http://www.python.org/doc/FAQ.html) for hints on what can go wrong,
-and how to fix it.
+If you run into other trouble, see the FAQ
+(http://www.python.org/doc/faq) for hints on what can go wrong, and
+how to fix it.
 
 If you rerun the configure script with different options, remove all
 object files by running "make clean" before rebuilding.  Believe it or
@@ -200,8 +200,7 @@ not, "make clean" sometimes helps to clean up other inexplicable
 problems as well.  Try it before sending in a bug report!
 
 If the configure script fails or doesn't seem to find things that
-should be there, inspect the config.log file.  When you fix a
-configure problem, be sure to remove config.cache!
+should be there, inspect the config.log file.
 
 If you get a warning for every file about the -Olimit option being no
 longer supported, you can ignore it.  There's no foolproof way to know
@@ -227,6 +226,8 @@ compilers from the vendor, or one of the free compilers (gcc).
 Unsupported systems
 -------------------
 
+XXX This section is out of date!
+
 A number of features are not supported in Python 2.3 anymore. Some
 support code is still present, but will be removed in Python 2.4. 
 If you still need to use current Python versions on these systems,
@@ -263,12 +264,9 @@ Unix platforms: If your vendor still ships (and you still use) Berkeley DB
 	    bsddb185 bsddbmodule.c
 
 	should work.  (You may need to add -I, -L or -l flags to direct the
-	compiler and linker to your include files and libraries.)  You can
-	then force it to be the version people import by adding
+	compiler and linker to your include files and libraries.)
 
-	    import bsddb185 as bsddb
-
-	in sitecustomize.py.
+XXX I think this next bit is out of date:
 
 64-bit platforms: The modules audioop, imageop and rgbimg don't work.
 	The setup.py script disables them on 64-bit installations.
@@ -314,10 +312,6 @@ Linux:  A problem with threads and fork() was tracked down to a bug in
 	solves the problem.  This causes the popen2 test to fail;
 	problem and solution reported by Pablo Bleyer.
 
-	Under Linux systems using GNU libc 2 (aka libc6), the crypt
-	module now needs the -lcrypt option.  The setup.py script
-	takes care of this automatically.
-
 Red Hat Linux: Red Hat 9 built Python2.2 in UCS-4 mode and hacked
 	Tcl to support it. To compile Python2.3 with Tkinter, you will
 	need to pass --enable-unicode=ucs4 flag to ./configure.
@@ -1028,6 +1022,7 @@ Modules/getpath.o.
 
 --with-tsc: Profile using the Pentium timestamping counter (TSC).
 
+
 Building for multiple architectures (using the VPATH feature)
 -------------------------------------------------------------
 
@@ -1130,9 +1125,7 @@ higher.
 For more Tkinter information, see the Tkinter Resource page:
 http://www.python.org/topics/tkinter/
 
-There are demos in the Demo/tkinter directory, in the subdirectories
-guido, matt and www (the matt and guido subdirectories have been
-overhauled to use more recent Tkinter coding conventions).
+There are demos in the Demo/tkinter directory.
 
 Note that there's a Python module called "Tkinter" (capital T) which
 lives in Lib/lib-tk/Tkinter.py, and a C module called "_tkinter"