Mercurial > cpython-lru_cache-weakref

annotate Doc/python-docs.txt @ 30759:f772d3403ca7 legacy-trunk

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
- add "Why is Python installed on my computer?" as a documentation FAQ since this gets asked at the docs at python.org address a lot - fix some minor style violations and inconsistencies
author Fred Drake <fdrake@acm.org>
date Thu, 23 Oct 2003 14:33:46 +0000
parents 3fe82d57d0d1
children 583178518bd0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
24774
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
1 This message is being sent in response to your message to the Python
30020
3fe82d57d0d1 update the documentation contact address
Fred Drake <fdrake@acm.org>
parents: 24774
diff changeset
2 documentation maintainers (docs@python.org). Your message will
24774
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
3 be handled by a human, but this message serves to answer the most
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
4 common questions sent to this address.
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
5
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
6 You will only receive this message if it has not been sent to you for
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
7 at least three months.
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
8
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
9 If your question is answered below, you may not receive an additional
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
10 message from the documentation maintainers. If you feel the answers
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
11 below are not sufficient and you do not receive an additional response
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
12 within a week, please do send a note letting us know that your
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
13 question has not been properly answered, and be specific regarding
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
14 what additional information you are looking for.
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
15
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
16
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
17 -Fred
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
18
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
19
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
20 Frequently Asked Questions about the Python Documentation
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
21 ---------------------------------------------------------
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
22
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
23 1. Can I download HTML/PDF/PostScript versions of the docs?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
24 2. Where can I download Python?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
25 3. I can't unpack a downloaded copy on Windows; what should I do?
30759
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
26 4. I can't unpack a downloaded copy on Mac OS; what should I do?
24774
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
27 5. What can I use Python for?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
28 6. How do I use module/function/whatever XXX?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
29 7. What about JPython?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
30 8. I found a bug in the documentation, who should I tell?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
31 9. Can I get an algorithm to do THIS in language THAT?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
32 10. How do I decode an XXX file from my email on a YYY computer?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
33 11. Acrobat Reader won't print the PDF. What's wrong?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
34 12. Where can I find documentation in my native language?
30759
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
35 13. Why is Python installed on my computer?
24774
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
36
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
37
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
38 Answers to the Questions
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
39 ------------------------
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
40
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
41 1. Can I download HTML/PDF/PostScript/<other> versions of the docs?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
42
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
43 Yes. These are available via the Web and traditional FTP. For
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
44 Web access to the latest version, see:
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
45
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
46 http://www.python.org/doc/
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
47
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
48 For FTP access to the latest version and archives of previous
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
49 versions, see:
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
50
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
51 ftp.python.org:/pub/python/doc/
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
52
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
53 2. Where can I download Python?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
54
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
55 You can get Python in source form and as a Windows installer
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
56 from the main Python website. You can also find information
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
57 about pre-built packages for other platforms there as well.
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
58
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
59 Downloading information at the website is at the URL:
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
60
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
61 http://www.python.org/download/
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
62
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
63 The sources and Windows installer can be downloaded from the FTP
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
64 site as well:
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
65
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
66 ftp://ftp.python.org/pub/python/
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
67
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
68 3. I can't unpack a downloaded archive on Windows; what should I do?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
69
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
70 Make sure the archive was saved with the .tgz extension; you may
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
71 need to watch carefully when telling the browser where to save
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
72 the file, as the default may change the extension to .tar or
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
73 even .exe.
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
74
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
75 Once you're sure the file has the right extension, use a recent
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
76 version of WinZip to upack the file (version 7.0 works). Get
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
77 WinZip from:
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
78
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
79 http://www.winzip.com/
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
80
30759
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
81 4. I can't unpack a downloaded archive on Mac OS; what should I do?
24774
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
82
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
83 Stuffit Expander 4.5 (and probably other versions) cannot handle
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
84 the "tar" archive, although it can decompress it from the .tgz
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
85 file. Expander Enhancer, which you have to pay for, can handle
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
86 the tar archive.
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
87
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
88 5. What can I use Python for?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
89
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
90 Python is a general purpose programming language. See the
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
91 Python home page at http://www.python.org/ for more information;
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
92 introductory material is available at:
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
93
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
94 http://www.python.org/doc/Intros.html
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
95
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
96 6. How do I use module/function/whatever XXX?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
97
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
98 Start by reading the documentation for XXX. If the
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
99 documentation doesn't make sense or seems incomplete, please
30020
3fe82d57d0d1 update the documentation contact address
Fred Drake <fdrake@acm.org>
parents: 24774
diff changeset
100 file a specific bug report to docs@python.org (the
24774
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
101 address you sent your question to). Otherwise, you probably
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
102 sent your question to the wrong place (which does not preclude
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
103 an answer, if I know it).
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
104
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
105 If you're looking for examples or tutorial information on how to
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
106 use a particular Python library component, check the Demo/
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
107 directory of the source distribution or Windows installation;
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
108 there might be an example. If that doesn't help, point your Web
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
109 browser to http://www.python.org/doc/ and look around; there may
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
110 be a link to some interesting examples online. After that, try
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
111 searching the Python Web site at http://www.python.org/search/.
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
112
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
113 If your question still hasn't been answered, you may send your
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
114 query to the Python newsgroup (comp.lang.python) or the mailing
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
115 list (see http://www.python.org/mailman/listinfo/python-list).
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
116 If you'd rather not send you message to a public forum, you can
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
117 try sending it to python-help@python.org. (This is typically
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
118 slower than sending your question to the public list, however.)
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
119
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
120 7. What about Jython and JPython?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
121
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
122 If your question is specific to Jython or JPython, you should
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
123 consult the Jython website at:
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
124
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
125 http://www.jython.org/
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
126
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
127 Chances are very good that the person who answers questions
30020
3fe82d57d0d1 update the documentation contact address
Fred Drake <fdrake@acm.org>
parents: 24774
diff changeset
128 posted to docs@python.org doesn't use Jython very often,
24774
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
129 and won't be able to give you a meaningful answer beyond "Look
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
130 at the Jython website." Sorry, I don't have *all* the answers!
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
131
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
132 8. I found a bug in the documentation, who should I tell?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
133
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
134 If you're reading this, you've found the right address! Send
30020
3fe82d57d0d1 update the documentation contact address
Fred Drake <fdrake@acm.org>
parents: 24774
diff changeset
135 all documentation bug reports to docs@python.org. If
24774
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
136 you prefer to use a Web-based reporting mechanism, you can use
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
137 the bug database at http://www.python.org/python-bugs/.
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
138
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
139 9. Can I get an algorithm to do THIS in language THAT?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
140
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
141 If THAT is Python, look in the standard library. If THAT isn't
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
142 Python, use your favorite Internet search engine.
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
143
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
144 10. How do I decode an XXX file from my email on a YYY computer?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
145
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
146 I really, honestly do not know. I don't even know why this
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
147 question gets asked here. Since I don't have a YYY computer,
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
148 I couldn't even try a few things out for you.
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
149
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
150 11. Acrobat Reader won't print the PDF. What's wrong?
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
151
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
152 Adobe has reportedly admitted that there is a bug Acrobat Reader
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
153 5.0 which causes it not to print at least some PDF files
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
154 generated by pdfTeX. This software is used to produce the PDF
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
155 version of the Python documentation, and our documents
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
156 definately trigger this bug in Acrobat Reader. To print the PDF
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
157 files, use Acrobat Reader 4.x, ghostscript, or xpdf.
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
158
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
159 Information on ghostscript can be found at:
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
160
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
161 http://www.ghostscript.com/
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
162
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
163 Information on xpdf can be found at:
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
164
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
165 http://www.foolabs.com/xpdf/
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
166
30759
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
167 12. Where can I find documentation in my native language?
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
168
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
169 There is a lot of contributed documentation in languages other
24774
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
170 than English. Some of the documents are translations of English
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
171 documents, and others were originally authored in other
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
172 languages. If we know about it, it will be listed at:
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
173
9e7ec2f5a1bd The auto-reply text for the python-docs address. This is not automatically
Fred Drake <fdrake@acm.org>
parents:
diff changeset
174 http://www.python.org/doc/NonEnglish.html
30759
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
175
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
176 13. Why is Python installed on my computer?
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
177
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
178 We're increasingly seeing Python being installed on computers
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
179 as delivered by vendors. For more information on why, and
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
180 whether it's safe to remove, see the "Why is Python Installed on
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
181 my Computer?" FAQ, found at:
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
182
f772d3403ca7 - add "Why is Python installed on my computer?" as a documentation FAQ
Fred Drake <fdrake@acm.org>
parents: 30020
diff changeset
183 http://www.python.org/doc/faq/installed.html