[Python-checkins] r68114 - in python/branches/release30-maint: Doc/c-api/arg.rst Doc/c-api/exceptions.rst Doc/howto/unicode.rst Doc/library/multiprocessing.rst Doc/library/pydoc.rst Doc/library/winsound.rst setup.py
benjamin.peterson
python-checkins at python.org
Thu Jan 1 01:28:11 CET 2009
Author: benjamin.peterson
Date: Thu Jan 1 01:28:11 2009
New Revision: 68114
Log:
Merged revisions 68113 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k
................
r68113 | benjamin.peterson | 2008-12-31 18:23:30 -0600 (Wed, 31 Dec 2008) | 53 lines
Merged revisions 67952,67957-67958,67960-67961,67963,67973,67978,67995,68030,68057,68061 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
r67952 | georg.brandl | 2008-12-27 11:42:40 -0600 (Sat, 27 Dec 2008) | 2 lines
#4752: actually use custom handler in example.
........
r67957 | georg.brandl | 2008-12-27 12:49:19 -0600 (Sat, 27 Dec 2008) | 2 lines
#4754: improve winsound documentation.
........
r67958 | georg.brandl | 2008-12-27 13:02:59 -0600 (Sat, 27 Dec 2008) | 2 lines
#4682: 'b' is actually unsigned char.
........
r67960 | georg.brandl | 2008-12-27 13:04:44 -0600 (Sat, 27 Dec 2008) | 2 lines
#4695: fix backslashery.
........
r67961 | georg.brandl | 2008-12-27 13:06:04 -0600 (Sat, 27 Dec 2008) | 2 lines
Use :samp: role.
........
r67963 | georg.brandl | 2008-12-27 13:11:15 -0600 (Sat, 27 Dec 2008) | 2 lines
#4671: document that pydoc imports modules.
........
r67973 | alexandre.vassalotti | 2008-12-27 20:58:22 -0600 (Sat, 27 Dec 2008) | 2 lines
Document Py_VaBuildValue.
........
r67978 | georg.brandl | 2008-12-28 05:58:49 -0600 (Sun, 28 Dec 2008) | 2 lines
#4731: clarify message about missing module prerequisites.
........
r67995 | benjamin.peterson | 2008-12-28 15:16:07 -0600 (Sun, 28 Dec 2008) | 1 line
#4763 PyErr_ExceptionMatches won't blow up with NULL arguments
........
r68030 | benjamin.peterson | 2008-12-29 15:38:14 -0600 (Mon, 29 Dec 2008) | 1 line
fix French
........
r68057 | vinay.sajip | 2008-12-30 01:01:25 -0600 (Tue, 30 Dec 2008) | 1 line
Minor documentation change relating to NullHandler.
........
r68061 | georg.brandl | 2008-12-30 04:15:49 -0600 (Tue, 30 Dec 2008) | 2 lines
#4778: attributes can't be called.
........
................
Modified:
python/branches/release30-maint/Doc/c-api/arg.rst
python/branches/release30-maint/Doc/c-api/exceptions.rst
python/branches/release30-maint/Doc/howto/unicode.rst
python/branches/release30-maint/Doc/library/multiprocessing.rst
python/branches/release30-maint/Doc/library/pydoc.rst
python/branches/release30-maint/Doc/library/winsound.rst
python/branches/release30-maint/setup.py
Modified: python/branches/release30-maint/Doc/c-api/arg.rst
==============================================================================
--- python/branches/release30-maint/Doc/c-api/arg.rst (original)
+++ python/branches/release30-maint/Doc/c-api/arg.rst Thu Jan 1 01:28:11 2009
@@ -164,8 +164,9 @@
them. Instead, the implementation assumes that the string object uses the
encoding passed in as parameter.
-``b`` (integer) [char]
- Convert a Python integer to a tiny int, stored in a C :ctype:`char`.
+``b`` (integer) [unsigned char]
+ Convert a nonnegative Python integer to an unsigned tiny int, stored in a C
+ :ctype:`unsigned char`.
``B`` (integer) [unsigned char]
Convert a Python integer to a tiny int without overflow checking, stored in a C
@@ -552,3 +553,8 @@
If there is an error in the format string, the :exc:`SystemError` exception is
set and *NULL* returned.
+
+.. cfunction:: PyObject* Py_VaBuildValue(const char *format, va_list vargs)
+
+ Identical to :cfunc:`Py_BuildValue`, except that it accepts a va_list
+ rather than a variable number of arguments.
Modified: python/branches/release30-maint/Doc/c-api/exceptions.rst
==============================================================================
--- python/branches/release30-maint/Doc/c-api/exceptions.rst (original)
+++ python/branches/release30-maint/Doc/c-api/exceptions.rst Thu Jan 1 01:28:11 2009
@@ -67,11 +67,10 @@
.. cfunction:: int PyErr_GivenExceptionMatches(PyObject *given, PyObject *exc)
- Return true if the *given* exception matches the exception in *exc*. If *exc*
- is a class object, this also returns true when *given* is an instance of a
- subclass. If *exc* is a tuple, all exceptions in the tuple (and recursively in
- subtuples) are searched for a match. If *given* is *NULL*, a memory access
- violation will occur.
+ Return true if the *given* exception matches the exception in *exc*. If
+ *exc* is a class object, this also returns true when *given* is an instance
+ of a subclass. If *exc* is a tuple, all exceptions in the tuple (and
+ recursively in subtuples) are searched for a match.
.. cfunction:: void PyErr_NormalizeException(PyObject**exc, PyObject**val, PyObject**tb)
Modified: python/branches/release30-maint/Doc/howto/unicode.rst
==============================================================================
--- python/branches/release30-maint/Doc/howto/unicode.rst (original)
+++ python/branches/release30-maint/Doc/howto/unicode.rst Thu Jan 1 01:28:11 2009
@@ -32,7 +32,7 @@
looking at Apple ][ BASIC programs, published in French-language publications in
the mid-1980s, that had lines like these::
- PRINT "FICHER EST COMPLETE."
+ PRINT "FICHIER EST COMPLETE."
PRINT "CARACTERE NON ACCEPTE."
Those messages should contain accents, and they just look wrong to someone who
Modified: python/branches/release30-maint/Doc/library/multiprocessing.rst
==============================================================================
--- python/branches/release30-maint/Doc/library/multiprocessing.rst (original)
+++ python/branches/release30-maint/Doc/library/multiprocessing.rst Thu Jan 1 01:28:11 2009
@@ -356,7 +356,7 @@
.. attribute:: daemon
- The process's daemon flag, a Boolean value. This must be called before
+ The process's daemon flag, a Boolean value. This must be set before
:meth:`start` is called.
The initial value is inherited from the creating process.
@@ -1808,9 +1808,9 @@
filesystem.
* An ``'AF_PIPE'`` address is a string of the form
- ``r'\\\\.\\pipe\\PipeName'``. To use :func:`Client` to connect to a named
+ :samp:`r'\\\\.\\pipe\\{PipeName}'`. To use :func:`Client` to connect to a named
pipe on a remote computer called ServerName* one should use an address of the
- form ``r'\\\\ServerName\\pipe\\PipeName'`` instead.
+ form :samp:`r'\\\\{ServerName}\\pipe\\{PipeName}'`` instead.
Note that any string beginning with two backslashes is assumed by default to be
an ``'AF_PIPE'`` address rather than an ``'AF_UNIX'`` address.
Modified: python/branches/release30-maint/Doc/library/pydoc.rst
==============================================================================
--- python/branches/release30-maint/Doc/library/pydoc.rst (original)
+++ python/branches/release30-maint/Doc/library/pydoc.rst Thu Jan 1 01:28:11 2009
@@ -34,6 +34,13 @@
Unix), and refers to an existing Python source file, then documentation is
produced for that file.
+.. note::
+
+ In order to find objects and their documentation, :mod:`pydoc` imports the
+ module(s) to be documented. Therefore, any code on module level will be
+ executed on that occasion. Use an ``if __name__ == '__main__':`` guard to
+ only execute code when a file is invoked as a script and not just imported.
+
Specifying a :option:`-w` flag before the argument will cause HTML documentation
to be written out to a file in the current directory, instead of displaying text
on the console.
Modified: python/branches/release30-maint/Doc/library/winsound.rst
==============================================================================
--- python/branches/release30-maint/Doc/library/winsound.rst (original)
+++ python/branches/release30-maint/Doc/library/winsound.rst Thu Jan 1 01:28:11 2009
@@ -26,8 +26,9 @@
Call the underlying :cfunc:`PlaySound` function from the Platform API. The
*sound* parameter may be a filename, audio data as a string, or ``None``. Its
interpretation depends on the value of *flags*, which can be a bitwise ORed
- combination of the constants described below. If the system indicates an error,
- :exc:`RuntimeError` is raised.
+ combination of the constants described below. If the *sound* parameter is
+ ``None``, any currently playing waveform sound is stopped. If the system
+ indicates an error, :exc:`RuntimeError` is raised.
.. function:: MessageBeep([type=MB_OK])
@@ -102,6 +103,10 @@
Stop playing all instances of the specified sound.
+ .. note::
+
+ This flag is not supported on modern Windows platforms.
+
.. data:: SND_ASYNC
Modified: python/branches/release30-maint/setup.py
==============================================================================
--- python/branches/release30-maint/setup.py (original)
+++ python/branches/release30-maint/setup.py Thu Jan 1 01:28:11 2009
@@ -208,7 +208,8 @@
if missing:
print()
- print("Failed to find the necessary bits to build these modules:")
+ print("Python build finished, but the necessary bits to build "
+ "these modules were not found:")
print_three_column(missing)
print("To find the necessary bits, look in setup.py in"
" detect_modules() for the module's name.")
More information about the Python-checkins
mailing list