mirror of
https://github.com/python/cpython.git
synced 2025-09-26 10:19:53 +00:00
Merged revisions 75797 via svnmerge from
svn+ssh://svn.python.org/python/branches/py3k ................ r75797 | georg.brandl | 2009-10-27 16:28:25 +0100 (Di, 27 Okt 2009) | 129 lines Merged revisions 75365,75394,75402-75403,75418,75459,75484,75592-75596,75600,75602-75607,75610-75613,75616-75617,75623,75627,75640,75647,75696,75795 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r75365 | georg.brandl | 2009-10-11 22:16:16 +0200 (So, 11 Okt 2009) | 1 line Fix broken links found by "make linkcheck". scipy.org seems to be done right now, so I could not verify links going there. ........ r75394 | georg.brandl | 2009-10-13 20:10:59 +0200 (Di, 13 Okt 2009) | 1 line Fix markup. ........ r75402 | georg.brandl | 2009-10-14 17:51:48 +0200 (Mi, 14 Okt 2009) | 1 line #7125: fix typo. ........ r75403 | georg.brandl | 2009-10-14 17:57:46 +0200 (Mi, 14 Okt 2009) | 1 line #7126: os.environ changes *do* take effect in subprocesses started with os.system(). ........ r75418 | georg.brandl | 2009-10-14 20:48:32 +0200 (Mi, 14 Okt 2009) | 1 line #7116: str.join() takes an iterable. ........ r75459 | georg.brandl | 2009-10-17 10:57:43 +0200 (Sa, 17 Okt 2009) | 1 line Fix refleaks in _ctypes PyCSimpleType_New, which fixes the refleak seen in test___all__. ........ r75484 | georg.brandl | 2009-10-18 09:58:12 +0200 (So, 18 Okt 2009) | 1 line Fix missing word. ........ r75592 | georg.brandl | 2009-10-22 09:05:48 +0200 (Do, 22 Okt 2009) | 1 line Fix punctuation. ........ r75593 | georg.brandl | 2009-10-22 09:06:49 +0200 (Do, 22 Okt 2009) | 1 line Revert unintended change. ........ r75594 | georg.brandl | 2009-10-22 09:56:02 +0200 (Do, 22 Okt 2009) | 1 line Fix markup. ........ r75595 | georg.brandl | 2009-10-22 09:56:56 +0200 (Do, 22 Okt 2009) | 1 line Fix duplicate target. ........ r75596 | georg.brandl | 2009-10-22 10:05:04 +0200 (Do, 22 Okt 2009) | 1 line Add a new directive marking up implementation details and start using it. ........ r75600 | georg.brandl | 2009-10-22 13:01:46 +0200 (Do, 22 Okt 2009) | 1 line Make it more robust. ........ r75602 | georg.brandl | 2009-10-22 13:28:06 +0200 (Do, 22 Okt 2009) | 1 line Document new directive. ........ r75603 | georg.brandl | 2009-10-22 13:28:23 +0200 (Do, 22 Okt 2009) | 1 line Allow short form with text as argument. ........ r75604 | georg.brandl | 2009-10-22 13:36:50 +0200 (Do, 22 Okt 2009) | 1 line Fix stylesheet for multi-paragraph impl-details. ........ r75605 | georg.brandl | 2009-10-22 13:48:10 +0200 (Do, 22 Okt 2009) | 1 line Use "impl-detail" directive where applicable. ........ r75606 | georg.brandl | 2009-10-22 17:00:06 +0200 (Do, 22 Okt 2009) | 1 line #6324: membership test tries iteration via __iter__. ........ r75607 | georg.brandl | 2009-10-22 17:04:09 +0200 (Do, 22 Okt 2009) | 1 line #7088: document new functions in signal as Unix-only. ........ r75610 | georg.brandl | 2009-10-22 17:27:24 +0200 (Do, 22 Okt 2009) | 1 line Reorder __slots__ fine print and add a clarification. ........ r75611 | georg.brandl | 2009-10-22 17:42:32 +0200 (Do, 22 Okt 2009) | 1 line #7035: improve docs of the various <method>_errors() functions, and give them docstrings. ........ r75612 | georg.brandl | 2009-10-22 17:52:15 +0200 (Do, 22 Okt 2009) | 1 line #7156: document curses as Unix-only. ........ r75613 | georg.brandl | 2009-10-22 17:54:35 +0200 (Do, 22 Okt 2009) | 1 line #6977: getopt does not support optional option arguments. ........ r75616 | georg.brandl | 2009-10-22 18:17:05 +0200 (Do, 22 Okt 2009) | 1 line Add proper references. ........ r75617 | georg.brandl | 2009-10-22 18:20:55 +0200 (Do, 22 Okt 2009) | 1 line Make printout margin important. ........ r75623 | georg.brandl | 2009-10-23 10:14:44 +0200 (Fr, 23 Okt 2009) | 1 line #7188: fix optionxform() docs. ........ r75627 | fred.drake | 2009-10-23 15:04:51 +0200 (Fr, 23 Okt 2009) | 2 lines add further note about what's passed to optionxform ........ r75640 | neil.schemenauer | 2009-10-23 21:58:17 +0200 (Fr, 23 Okt 2009) | 2 lines Improve some docstrings in the 'warnings' module. ........ r75647 | georg.brandl | 2009-10-24 12:04:19 +0200 (Sa, 24 Okt 2009) | 1 line Fix markup. ........ r75696 | georg.brandl | 2009-10-25 21:25:43 +0100 (So, 25 Okt 2009) | 1 line Fix a demo. ........ r75795 | georg.brandl | 2009-10-27 16:10:22 +0100 (Di, 27 Okt 2009) | 1 line Fix a strange mis-edit. ........ ................
This commit is contained in:
parent
1e8cbe36cc
commit
628e6f908e
50 changed files with 376 additions and 239 deletions
|
@ -396,12 +396,13 @@ calls into the Python run-time system, even for seemingly simple operations like
|
|||
``x+1``.
|
||||
|
||||
Several projects described in the Python newsgroup or at past `Python
|
||||
conferences <http://python.org/community/workshops/>`_ have shown that this approach is feasible,
|
||||
although the speedups reached so far are only modest (e.g. 2x). Jython uses the
|
||||
same strategy for compiling to Java bytecode. (Jim Hugunin has demonstrated
|
||||
that in combination with whole-program analysis, speedups of 1000x are feasible
|
||||
for small demo programs. See the proceedings from the `1997 Python conference
|
||||
<http://python.org/community/workshops/1997-10/proceedings/>`_ for more information.)
|
||||
conferences <http://python.org/community/workshops/>`_ have shown that this
|
||||
approach is feasible, although the speedups reached so far are only modest
|
||||
(e.g. 2x). Jython uses the same strategy for compiling to Java bytecode. (Jim
|
||||
Hugunin has demonstrated that in combination with whole-program analysis,
|
||||
speedups of 1000x are feasible for small demo programs. See the proceedings
|
||||
from the `1997 Python conference
|
||||
<http://python.org/workshops/1997-10/proceedings/>`_ for more information.)
|
||||
|
||||
Internally, Python source code is always translated into a bytecode
|
||||
representation, and this bytecode is then executed by the Python virtual
|
||||
|
|
|
@ -48,7 +48,7 @@ Python's C API.
|
|||
If you need to interface to some C or C++ library for which no Python extension
|
||||
currently exists, you can try wrapping the library's data types and functions
|
||||
with a tool such as `SWIG <http://www.swig.org>`_. `SIP
|
||||
<http://www.riverbankcomputing.co.uk/sip/>`_, `CXX
|
||||
<http://www.riverbankcomputing.co.uk/software/sip/>`__, `CXX
|
||||
<http://cxx.sourceforge.net/>`_ `Boost
|
||||
<http://www.boost.org/libs/python/doc/index.html>`_, or `Weave
|
||||
<http://www.scipy.org/site_content/weave>`_ are also alternatives for wrapping
|
||||
|
|
|
@ -164,9 +164,10 @@ Sphinx-formatted documentation, Python library modules, example programs, and
|
|||
several useful pieces of freely distributable software. The source will compile
|
||||
and run out of the box on most UNIX platforms.
|
||||
|
||||
Consult the `Developer FAQ
|
||||
<http://www.python.org/dev/devfaq.html#subversion-svn>`__ for more information
|
||||
on getting the source code and compiling it.
|
||||
.. XXX update link once the dev faq is relocated
|
||||
|
||||
Consult the `Developer FAQ <http://www.python.org/dev/faq/>`__ for more
|
||||
information on getting the source code and compiling it.
|
||||
|
||||
|
||||
How do I get documentation on Python?
|
||||
|
@ -176,7 +177,7 @@ How do I get documentation on Python?
|
|||
|
||||
The standard documentation for the current stable version of Python is available
|
||||
at http://docs.python.org/. PDF, plain text, and downloadable HTML versions are
|
||||
also available at http://docs.python.org/download/.
|
||||
also available at http://docs.python.org/download.html.
|
||||
|
||||
The documentation is written in reStructuredText and processed by `the Sphinx
|
||||
documentation tool <http://sphinx.pocoo.org/>`__. The reStructuredText source
|
||||
|
@ -220,8 +221,10 @@ releases are announced on the comp.lang.python and comp.lang.python.announce
|
|||
newsgroups and on the Python home page at http://www.python.org/; an RSS feed of
|
||||
news is available.
|
||||
|
||||
.. XXX update link once the dev faq is relocated
|
||||
|
||||
You can also access the development version of Python through Subversion. See
|
||||
http://www.python.org/dev/devfaq.html#subversion-svn for details.
|
||||
http://www.python.org/dev/faq/ for details.
|
||||
|
||||
|
||||
How do I submit bug reports and patches for Python?
|
||||
|
|
|
@ -45,11 +45,12 @@ Qt
|
|||
'''
|
||||
|
||||
There are bindings available for the Qt toolkit (`PyQt
|
||||
<http://www.riverbankcomputing.co.uk/pyqt/>`_) and for KDE (PyKDE). If you're
|
||||
writing open source software, you don't need to pay for PyQt, but if you want to
|
||||
write proprietary applications, you must buy a PyQt license from `Riverbank
|
||||
Computing <http://www.riverbankcomputing.co.uk>`_ and a Qt license from
|
||||
`Trolltech <http://www.trolltech.com>`_.
|
||||
<http://www.riverbankcomputing.co.uk/software/pyqt/>`_) and for KDE (PyKDE). If
|
||||
you're writing open source software, you don't need to pay for PyQt, but if you
|
||||
want to write proprietary applications, you must buy a PyQt license from
|
||||
`Riverbank Computing <http://www.riverbankcomputing.co.uk>`_ and (up to Qt 4.4;
|
||||
Qt 4.5 upwards is licensed under the LGPL license) a Qt license from `Trolltech
|
||||
<http://www.trolltech.com>`_.
|
||||
|
||||
Gtk+
|
||||
''''
|
||||
|
|
|
@ -16,14 +16,10 @@ Check :ref:`the Library Reference <library-index>` to see if there's a relevant
|
|||
standard library module. (Eventually you'll learn what's in the standard
|
||||
library and will able to skip this step.)
|
||||
|
||||
Search the `Python Package Index <http://pypi.python.org/pypi>`_.
|
||||
|
||||
Next, check the `Vaults of Parnassus <http://www.vex.net/parnassus/>`_, an older
|
||||
index of packages.
|
||||
|
||||
Finally, try `Google <http://www.google.com>`_ or other Web search engine.
|
||||
Searching for "Python" plus a keyword or two for your topic of interest will
|
||||
usually find something helpful.
|
||||
For third-party packages, search the `Python Package Index
|
||||
<http://pypi.python.org/pypi>`_ or try `Google <http://www.google.com>`_ or
|
||||
another Web search engine. Searching for "Python" plus a keyword or two for
|
||||
your topic of interest will usually find something helpful.
|
||||
|
||||
|
||||
Where is the math.py (socket.py, regex.py, etc.) source file?
|
||||
|
@ -181,11 +177,10 @@ in Python.
|
|||
How do I create documentation from doc strings?
|
||||
-----------------------------------------------
|
||||
|
||||
.. XXX mention Sphinx/epydoc
|
||||
|
||||
The :mod:`pydoc` module can create HTML from the doc strings in your Python
|
||||
source code. An alternative is `pythondoc
|
||||
<http://starship.python.net/crew/danilo/pythondoc/>`_.
|
||||
source code. An alternative for creating API documentation purely from
|
||||
docstrings is `epydoc <http://epydoc.sf.net/>`_. `Sphinx
|
||||
<http://sphinx.pocoo.org>`_ can also include docstring content.
|
||||
|
||||
|
||||
How do I get a single keypress at a time?
|
||||
|
@ -237,7 +232,7 @@ The :mod:`threading` module builds convenient abstractions on top of the
|
|||
low-level primitives provided by the :mod:`_thread` module.
|
||||
|
||||
Aahz has a set of slides from his threading tutorial that are helpful; see
|
||||
http://starship.python.net/crew/aahz/OSCON2001/.
|
||||
http://www.pythoncraft.com/OSCON2001/.
|
||||
|
||||
|
||||
None of my threads seem to run: why?
|
||||
|
@ -397,6 +392,7 @@ Can't we get rid of the Global Interpreter Lock?
|
|||
------------------------------------------------
|
||||
|
||||
.. XXX mention multiprocessing
|
||||
.. XXX link to dbeazley's talk about GIL?
|
||||
|
||||
The Global Interpreter Lock (GIL) is often seen as a hindrance to Python's
|
||||
deployment on high-end multiprocessor server machines, because a multi-threaded
|
||||
|
@ -583,7 +579,7 @@ substituted for standard input and output. You will have to use pseudo ttys
|
|||
("ptys") instead of pipes. Or you can use a Python interface to Don Libes'
|
||||
"expect" library. A Python extension that interfaces to expect is called "expy"
|
||||
and available from http://expectpy.sourceforge.net. A pure Python solution that
|
||||
works like expect is ` pexpect <http://pexpect.sourceforge.net>`_.
|
||||
works like expect is `pexpect <http://pypi.python.org/pypi/pexpect/>`_.
|
||||
|
||||
|
||||
How do I access the serial (RS232) port?
|
||||
|
|
|
@ -67,8 +67,8 @@ plug-ins to add a custom feature. In addition to the bug checking that
|
|||
PyChecker performs, Pylint offers some additional features such as checking line
|
||||
length, whether variable names are well-formed according to your coding
|
||||
standard, whether declared interfaces are fully implemented, and more.
|
||||
http://www.logilab.org/projects/pylint/documentation provides a full list of
|
||||
Pylint's features.
|
||||
http://www.logilab.org/card/pylint_manual provides a full list of Pylint's
|
||||
features.
|
||||
|
||||
|
||||
How can I create a stand-alone binary from a Python script?
|
||||
|
@ -1141,7 +1141,7 @@ use a list comprehension::
|
|||
A = [[None] * w for i in range(h)]
|
||||
|
||||
Or, you can use an extension that provides a matrix datatype; `Numeric Python
|
||||
<http://www.pfdubois.com/numpy/>`_ is the best known.
|
||||
<http://numpy.scipy.org/>`_ is the best known.
|
||||
|
||||
|
||||
How do I apply a method to a sequence of objects?
|
||||
|
|
|
@ -389,10 +389,10 @@ need)::
|
|||
.py :REG_SZ: c:\<path to python>\python.exe -u %s %s
|
||||
|
||||
This line will allow you to call your script with a simple reference like:
|
||||
http://yourserver/scripts/yourscript.py provided "scripts" is an "executable"
|
||||
directory for your server (which it usually is by default). The "-u" flag
|
||||
specifies unbuffered and binary mode for stdin - needed when working with binary
|
||||
data.
|
||||
``http://yourserver/scripts/yourscript.py`` provided "scripts" is an
|
||||
"executable" directory for your server (which it usually is by default). The
|
||||
:option:`-u` flag specifies unbuffered and binary mode for stdin - needed when
|
||||
working with binary data.
|
||||
|
||||
In addition, it is recommended that using ".py" may not be a good idea for the
|
||||
file extensions when used in this context (you might want to reserve ``*.py``
|
||||
|
@ -517,7 +517,7 @@ Why doesn't os.popen()/win32pipe.popen() work on Win9x?
|
|||
There is a bug in Win9x that prevents os.popen/win32pipe.popen* from
|
||||
working. The good news is there is a way to work around this problem. The
|
||||
Microsoft Knowledge Base article that you need to lookup is: Q150956. You will
|
||||
find links to the knowledge base at: http://www.microsoft.com/kb.
|
||||
find links to the knowledge base at: http://support.microsoft.com/.
|
||||
|
||||
|
||||
PyRun_SimpleFile() crashes on Windows but not on Unix; why?
|
||||
|
@ -604,4 +604,4 @@ Tim Peters:
|
|||
we can't fix it).
|
||||
|
||||
David A Burton has written a little program to fix this. Go to
|
||||
http://www.burtonsys.com/download.html and click on "ctl3dfix.zip".
|
||||
http://www.burtonsys.com/downloads.html and click on "ctl3dfix.zip".
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue