changed path references
diff --git a/Misc/FAQ b/Misc/FAQ
index d6bdbb5..acb2d15 100644
--- a/Misc/FAQ
+++ b/Misc/FAQ
@@ -9,7 +9,7 @@
Archive-name: python-faq/part1
Submitted-by: Guido van Rossum <guido@cwi.nl>
-Version: 1.22
+Version: 1.23
Last-modified: 10 April 1995
This article contains answers to Frequently Asked Questions about
@@ -30,7 +30,7 @@
Email: <guido@cwi.nl>
The latest version of this FAQ is available by anonymous ftp from
-<URL:ftp://ftp.cwi.nl/pub/python/python-FAQ>. It will also be posted
+<URL:ftp://ftp.cwi.nl/pub/python/FAQ>. It will also be posted
regularly to the newsgroups comp.answers <URL:news:comp.answers> and
comp.lang.python <URL:news:comp.lang.python>.
@@ -199,18 +199,19 @@
7. Using Python on non-UNIX platforms
7.1. Q. Is there a Mac version of Python?
7.2. Q. Is there a DOS version of Python?
- 7.3. Q. Is there a Windows version of Python?
+ 7.3. Q. Is there a Windows 3.1(1) version of Python?
7.4. Q. Is there a Windows NT version of Python?
- 7.5. Q. Is there an OS/2 version of Python?
- 7.6. Q. Is there a VMS version of Python?
- 7.7. Q. What about IBM mainframes, or other esoteric non-UNIX
+ 7.5. Q. Is there a Windows 95 version of Python?
+ 7.6. Q. Is there an OS/2 version of Python?
+ 7.7. Q. Is there a VMS version of Python?
+ 7.8. Q. What about IBM mainframes, or other esoteric non-UNIX
platforms?
- 7.8. Q. Where are the source or Makefiles for the non-UNIX versions?
- 7.9. Q. What is the status and support for the non-UNIX versions?
- 7.10. Q. I have the PC version but it appears to be only a binary.
+ 7.9. Q. Where are the source or Makefiles for the non-UNIX versions?
+ 7.10. Q. What is the status and support for the non-UNIX versions?
+ 7.11. Q. I have a PC version but it appears to be only a binary.
Where's the library?
- 7.11. Q. Where's the documentation for the Mac or PC version?
- 7.12. Q. The Mac (PC) version doesn't seem to have any facilities for
+ 7.12. Q. Where's the documentation for the Mac or PC version?
+ 7.13. Q. The Mac (PC) version doesn't seem to have any facilities for
creating or editing programs apart from entering it interactively, and
there seems to be no way to save code that was entered interactively.
How do I create a Python program on the Mac (PC)?
@@ -255,15 +256,17 @@
A. The latest complete Python source distribution is always available
by anonymous ftp, e.g.
-<URL:ftp://ftp.cwi.nl/pub/python/python1.1.tar.gz>. It is a gzipped
-tar file containing the complete C source, LaTeX documentation, Python
-library modules, example programs, and several useful pieces of freely
-distributable software. This will compile and run out of the box on
-most UNIX platforms. (See section 7 for non-UNIX information.)
+<URL:ftp://ftp.cwi.nl/pub/python/src/python1.2.tar.gz>. It is a
+gzipped tar file containing the complete C source, LaTeX
+documentation, Python library modules, example programs, and several
+useful pieces of freely distributable software. This will compile and
+run out of the box on most UNIX platforms. (See section 7 for
+non-UNIX information.)
Occasionally a set of patches is issued which has to be applied using
the patch program. These patches are placed in the same directory,
-e.g. <URL:ftp://ftp.cwi.nl/pub/python/patch1.1.1>.
+e.g. <URL:ftp://ftp.cwi.nl/pub/python/src/patch1.1.1>. (At the time
+of writing, no patches exist for 1.2.)
An index of said ftp directory can be found in the file INDEX. An
HTML version of the index can be found in the file index.html,
@@ -274,7 +277,7 @@
A. The LaTeX source for the documentation is part of the source
distribution. If you don't have LaTeX, the latest Python
documentation set is always available by anonymous ftp, e.g.
-<URL:ftp://ftp.cwi.nl/pub/python/pythondoc-ps1.1.tar.gz>. It is a
+<URL:ftp://ftp.cwi.nl/pub/python/doc/postscript.tar.gz>. It is a
gzipped tar file containing PostScript files of the reference manual,
the library manual, and the tutorial. Note that the library manual is
the most important one of the set, as much of Python's power stems
@@ -305,15 +308,15 @@
and a mailing list. The newsgroup and mailing list are gatewayed into
each other -- if you can read news it's unnecessary to subscribe to
the mailing list. Send e-mail to <python-list-request@cwi.nl> to
-(un)subscribe to the mailing list. Hypermail archives of
-(nearly) everything posted to the mailing list (and thus the
-newsgroup) are available on our WWW server,
+(un)subscribe to the mailing list. Hypermail archives of (nearly)
+everything posted to the mailing list (and thus the newsgroup) are
+available on our WWW server,
<URL:http://www.cwi.nl/~guido/hypermail/index.html>. The raw archives
are also available by ftp, e.g.
-<URL:ftp://ftp.cwi.nl/pub/python/mailinglist.gz>. The uncompressed
-versions of these files can be read with the standard UNIX Mail
-program ("Mail -f file") or with nn ("nn file"). To read them using
-MH, you could use "inc -file file".
+<URL:ftp://ftp.cwi.nl/pub/python/mail/mailinglist.gz>. The
+uncompressed versions of these files can be read with the standard
+UNIX Mail program ("Mail -f file") or with nn ("nn file"). To read
+them using MH, you could use "inc -file file".
1.7. Q. Is there a WWW page devoted to Python?
@@ -332,12 +335,12 @@
If you wish to browse this collection of HTML files on your own
machine, it is available bundled up by anonymous ftp,
-e.g. <URL:ftp://ftp.cwi.nl/pub/python/python-html.tar.gz>. (This
+e.g. <URL:ftp://ftp.cwi.nl/pub/python/doc/html.tar.gz>. (This
requires some manual patch-up for the references to images,
unfortunately.)
An Emacs-INFO set containing the library manual is also available by
-ftp, e.g. <URL:ftp://ftp.cwi.nl/pub/python/python-lin-info.tar.gz>.
+ftp, e.g. <URL:ftp://ftp.cwi.nl/pub/python/doc/lib-info.tar.gz>.
1.9. Q. Is there a book on Python, or will there be one out soon?
@@ -367,12 +370,12 @@
PostScript for this paper and for the slides used for the accompanying
presentation is available by ftp as
-<URL:ftp://ftp.cwi.nl/pub/python/nluug-paper.ps> and
-<URL:ftp://ftp.cwi.nl/pub/python/nluug-slides.ps>, respectively.
+<URL:ftp://ftp.cwi.nl/pub/python/doc/nluug-paper.ps> and
+<URL:ftp://ftp.cwi.nl/pub/python/doc/nluug-slides.ps>, respectively.
Slides for a talk on Python that I gave at the Usenix Symposium on
Very High Level Languages in Santa Fe, NM, USA in October 1995 are
-available as <URL:ftp://ftp.cwi.nl/pub/python/vhll-slides.ps>.
+available as <URL:ftp://ftp.cwi.nl/pub/python/doc/vhll-slides.ps>.
1.12. Q. How does the Python version numbering scheme work?
@@ -630,10 +633,8 @@
People have reported problems with gcc 2.5.8 up to 2.6.3. The DEC
OSF/1 cc compiler does not have these problems so it's likely a gcc
-bug. The latest news is that (at least in the 1.2 beta release) the
-problem still exists but only when you use -O, and only affects the
-code generated from Python/marshal.c. A fix is to change "long i, n;"
-into "int i, n;" in w_object().
+bug. The latest news is that this has been fixed in Python 1.2 by a
+source change (I gave up waiting for a fixed gcc).
3.9. Q. I use VPATH but some targets are built in the source directory.
@@ -972,10 +973,8 @@
For X-related modules (Xt and Xm) you will have to do more work: they
are currently not part of the standard Python distribution. You will
have to ftp the Extensions tar file, e.g.
-<URL:ftp://ftp.cwi.nl/pub/python/extensions.tar.gz> and follow the
-instructions there. Note: the X related modules are still somewhat
-flakey, so don't try this unless you alread know a bit or two about
-building X applications on your platform.
+<URL:ftp://ftp.cwi.nl/pub/python/src/extensions.tar.gz> and follow the
+instructions there.
See also the next question.
@@ -1024,7 +1023,7 @@
- There's an interface to X11, including the Athena and Motif widget
sets (and a few individual widgets, like Mosaic's HTML widget and
SGI's GL widget) in the Extensions set, which is separately ftp'able
-<URL:ftp://ftp.cwi.nl/pub/python/extensions.tar.gz>.
+<URL:ftp://ftp.cwi.nl/pub/python/src/extensions.tar.gz>.
- There's an interface to SUIT, the U of Virginia's Simple User
Interface Toolkit; it can be ftp'ed from
@@ -1062,10 +1061,11 @@
There's an interface to metalbase by Lance Ellinghaus
<lance@markv.com>; it is part of the separate Extensions distribution
-<URL:ftp://ftp.cwi.nl/pub/python/extensions.tar.gz>.
+<URL:ftp://ftp.cwi.nl/pub/python/src/extensions.tar.gz>.
Anthony Baxter <anthony.baxter@aaii.oz.au> has written an interface to
-mSQL (mini-SQL). <URL:ftp://ftp.cwi.nl/pub/python/PymSQL.tar.gz>.
+mSQL (mini-SQL).
+<URL:ftp://ftp.cwi.nl/pub/python/contrib/PymSQL.tar.gz>.
Tom Culliton <culliton@clark.net> has written an Oracle module. Write
him to get a copy of the latest version.
@@ -1302,7 +1302,7 @@
commonly used URL types (file, ftp, http, gopher).
The Demo2/www directory (Demo2 has to be retrieved separately from the
-Python ftp sites <URL:ftp://ftp.cwi.nl/pub/python/demo2.tar.gz>)
+Python ftp sites <URL:ftp://ftp.cwi.nl/pub/python/src/demo2.tar.gz>)
contains some (really old) code to parse HTML and to display it.
Steve Miale <smiale@cs.indiana.edu> has written a modular WWW browser
@@ -1754,39 +1754,18 @@
7.1. Q. Is there a Mac version of Python?
-A. Yes. It is on most ftp sites carrying Python as python.sea.hqx,
-e.g. <URL:ftp://ftp.cwi.nl/pub/python/python_1.1.sea.hqx> -- this is a
-self-extracting archive containing the application binary as well as
-the Lib modules.
+A. Yes, see the "mac" subdirectory of the distribution sites,
+e.g. <URL:ftp://ftp.cwi.nl/pub/python/mac/>.
7.2. Q. Is there a DOS version of Python?
-A. Yes. More than one, actually: 16python.exe runs in standard DOS
-mode on 186 CPUs or higher; 32python.exe uses a DOS extender and only
-runs on a 386 or higher CPUs. Although 16python.exe does not pass the
-test set because test_grammar is too big for the parser, it actually
-has about 270 kbyte of allocatable heap space, which is sufficient for
-fairly large programs. 32python.exe is distributed as a tar file
-containing the required DOS extended and 387 emulator. Both are on
-most ftp sites carrying Python.
+A. Yes, see the "pc" subdirectory of the distribution sites,
+e.g. <URL:ftp://ftp.cwi.nl/pub/python/pc/>.
-The file dosbuild.tar.gz on the standard ftp sites contains
-rudimentary Makefiles and instructions
-<URL:ftp://ftp.cwi.nl/pub/python/dosbuild.tar.gz>.
+7.3. Q. Is there a Windows 3.1(1) version of Python?
-7.3. Q. Is there a Windows version of Python?
-
-A. Yes. Use qwpython.exe. The only problem with it: ^C
-unconditionally kills the entire program -- it does not raise
-KeyboardInterrupt. You can also run 16python.exe or 32python.exe in a
-"DOS box", but qwpython.exe appears to be slightly faster.
-
-There aren't any Makefiles at this moment. Sorry.
-
-Using Win32s (a free NT compatibility package by Microsoft) you can
-also use the NT version by Mark Hammond -- the Win32s package is also
-in that directory (you'll need several MB of disk space to install
-it). See the next question.
+A. Yes, also see the "pc" subdirectory of the distribution sites,
+e.g. <URL:ftp://ftp.cwi.nl/pub/python/pc/>.
7.4. Q. Is there a Windows NT version of Python?
@@ -1804,45 +1783,33 @@
all NT platforms -- hopefully Microsoft will fix this with the release
of Visual C++ 2.0.
-7.5. Q. Is there an OS/2 version of Python?
+7.5. Q. Is there a Windows 95 version of Python?
-A. Yes. You can ftp an old version from the usual places as
-pyth_os2.zip, e.g. <URL:ftp://ftp.cwi.nl/pub/python/pyth_os2.zip>.
-This contains both an executable and Makefiles for those fortunate
-enough to have a C compiler. A newer port is in progress -- Chris
-Vale <cvale@netcom.com> is doing the work, using Borland C, based on
-Mark Hammond's NT port.
+A. The Windows NT version might work, otherwise the Windows 3.1(1)
+version should work (isn't Windows 95 supposed to be backwards
+compatible?).
-7.6. Q. Is there a VMS version of Python?
+7.6. Q. Is there an OS/2 version of Python?
-A. I think not (yet). This question has been asked on the list
-several times and I've never seen an answer. Maybe someone with a VMS
-C compiler could attempt a port? Probably coming up with proper
-Makefiles, config.h and config.c should be sufficient. If you succeed
-(or even if you get stuck halfway), please let me know! (Info as of
-23 September 1994.)
+A. Yes, also see the "pc" subdirectory of the distribution sites,
+e.g. <URL:ftp://ftp.cwi.nl/pub/python/pc/>.
-7.7. Q. What about IBM mainframes, or other esoteric non-UNIX
+7.7. Q. Is there a VMS version of Python?
+
+A. I think not. This question has been asked on the list several
+times and I've never seen an affirmative answer.
+
+7.8. Q. What about IBM mainframes, or other esoteric non-UNIX
platforms?
-A. Basically, the same story as for VMS... (Info as of 23 September
-1994.)
+A. Basically, the same story as for VMS...
-7.8. Q. Where are the source or Makefiles for the non-UNIX versions?
+7.9. Q. Where are the source or Makefiles for the non-UNIX versions?
-A. The standard sources can (almost) be used. See the previous
-questions for availability of Makefiles/projects or patches. If you
-find things in the standard sources that don't work on your particular
-platform, please let me know and I'll integrate a solution into the
-next release of the standard sources. If you submit a fix, please use
-some kind of #ifdef so as to keep the source working for other
-platforms. In particular, if the patch works around the availability
-of a particular function of header file, you should mimic the
-HAVE_... style used by the configure script -- you can then submit a
-config.h file for a particular platform so there are no absolutely
-platform-specific #ifdefs in the rest of the sources.
+A. The standard sources can (almost) be used. Additional sources can
+be found in the platform-specific subdirectories of the distribution.
-7.9. Q. What is the status and support for the non-UNIX versions?
+7.10. Q. What is the status and support for the non-UNIX versions?
A. I don't have access to most of these platforms, so in general I am
dependent on material submitted by volunteers(*). However I strive to
@@ -1853,15 +1820,14 @@
(*) For the Macintosh, that volunteer is me, with help from Jack
Jansen <jack@cwi.nl>.
-7.10. Q. I have the PC version but it appears to be only a binary.
+7.11. Q. I have a PC version but it appears to be only a binary.
Where's the library?
A. You still need to copy the files from the distribution directory
"python/Lib" to your system. If you don't have the full distribution,
-you can get the file pythonlib<version>.tar.gz from most ftp sites
-carrying Python; this is a subset of the distribution containing just
-those files, e.g.
-<URL:ftp://ftp.cwi.nl/pub/python/pythonlib1.1.tar.gz>.
+you can get the file lib<version>.tar.gz from most ftp sites carrying
+Python; this is a subset of the distribution containing just those
+files, e.g. <URL:ftp://ftp.cwi.nl/pub/python/src/lib1.1.tar.gz>.
Once you have installed the library, you need to point sys.path to it.
Assuming the library is in C:\misc\python\lib, the following commands
@@ -1877,13 +1843,12 @@
C> SET PYTHONPATH=C:\misc\python\lib
-7.11. Q. Where's the documentation for the Mac or PC version?
+7.12. Q. Where's the documentation for the Mac or PC version?
-A. There isn't any. The documentation for the Unix version also
-applies to the Mac and PC versions. Where applicable, differences
-are indicated in the text.
+A. The documentation for the Unix version also applies to the Mac and
+PC versions. Where applicable, differences are indicated in the text.
-7.12. Q. The Mac (PC) version doesn't seem to have any facilities for
+7.13. Q. The Mac (PC) version doesn't seem to have any facilities for
creating or editing programs apart from entering it interactively, and
there seems to be no way to save code that was entered interactively.
How do I create a Python program on the Mac (PC)?