History

add hg and python

cinap_lenrek committed 15 years ago

Commit 4bb9e221 parent 987265c3706 files · +1228772 −-233Browse files

Showing the changes to sys/src/cmd/python/Doc/python-docs.txt (1 of 3706 files). Show all

Unified · Split

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