Commit Graph

926 Commits

Author SHA1 Message Date
Brett Cannon 0aa6e1b8fb Deprecate the dircache module for 3.0. 2008-05-10 21:12:57 +00:00
Andrew M. Kuchling 4ff7fc49c6 #1625509: describe behaviour of import lock 2008-05-10 17:48:45 +00:00
Andrew M. Kuchling 311c580539 Document the 'line' argument 2008-05-10 17:37:05 +00:00
Skip Montanaro 45f585915e Note the PyPI-edness of bsddb185 for people who might still need it. 2008-05-10 14:48:49 +00:00
Brett Cannon 6192df10b6 Deprecate the compiler package for removal in 3.0. 2008-05-10 02:58:26 +00:00
Brett Cannon 768d44f54d Deprecate the bsddb185 module for removal in 3.0. 2008-05-10 02:47:54 +00:00
Brett Cannon 4c1f881f13 Deprecate Bastion and rexec for 3.0. 2008-05-10 02:27:04 +00:00
Brett Cannon ccdf9081b7 Fix some errors in the deprecation warnings for new and user. 2008-05-10 02:25:00 +00:00
Benjamin Peterson 54718dd691 In stdtypes.rst, move methods under class directives where applicable 2008-05-09 21:30:26 +00:00
Georg Brandl 2e829cb769 Add Kodos as a re reference. 2008-05-09 06:36:07 +00:00
Georg Brandl 3ddaf2d64b Add another link to colorsys docs. 2008-05-09 06:26:54 +00:00
Georg Brandl dfb5bbd44a Add a sentence to basicConfig() that is in the docstring. 2008-05-09 06:18:27 +00:00
Georg Brandl 5117409a53 #2781: fix function name. 2008-05-09 06:10:43 +00:00
Brett Cannon fa24d9a71c Deprecate the toaiff module for removal in 3.0. 2008-05-09 05:32:42 +00:00
Brett Cannon 3c75914434 Deprecate test.testall for removal in 3.0. 2008-05-09 05:25:37 +00:00
Brett Cannon d7265d6483 Deprecate the new module for removal in 3.0. 2008-05-09 05:18:40 +00:00
Benjamin Peterson d03238a647 reindent example 2008-05-09 00:50:40 +00:00
Skip Montanaro e404a12a46 Add an example about using NamedTemporaryFile() to replace mktemp(). I'm
unclear whether the verbatim text should have been indented or by how much.
2008-05-09 00:45:00 +00:00
Benjamin Peterson 0893a0a961 Add Py3k warnings to os.path.walk 2008-05-09 00:27:01 +00:00
Brett Cannon e3b1940eb9 Deprecate the user module for removal in 3.0. 2008-05-08 20:36:09 +00:00
Brett Cannon 98b9c07ab7 Document the 'record' argument for test.test_support.catch_warning(). 2008-05-08 20:20:54 +00:00
Brett Cannon 9d44182427 The mutex module has been deprecated for removal in 3.0. 2008-05-08 19:26:08 +00:00
Brett Cannon 80bb9d92e3 Deprecate the imputil module for removal in 3.0. 2008-05-08 18:15:14 +00:00
Raymond Hettinger f8105ceec7 Issue 2778. Document the temporary frozenset swap in __contains__(), remove(), and discard(). 2008-05-08 17:18:13 +00:00
Raymond Hettinger 5a9fed75bd Fix-up the enumerate type example and move it to the end. 2008-05-08 07:23:30 +00:00
Brett Cannon e5d2cbaeaf Deprecate the audiodev module for 3.0. 2008-05-06 23:23:34 +00:00
Christian Heimes af748c3ab8 Implemented PEP 370 2008-05-06 22:41:46 +00:00
Georg Brandl c730d5f7e5 > != (!<). 2008-05-06 17:20:54 +00:00
Georg Brandl 5820022862 #2773: fix description of 'g' and 'G' formatting spec. 2008-05-06 17:11:42 +00:00
Georg Brandl 98fd03637f #2752: fix second example too. 2008-05-05 21:06:48 +00:00
Georg Brandl 3961f1872c Fix JSON module docs. 2008-05-05 20:53:39 +00:00
Brett Cannon 4b964f9c90 Add the 'json' package. Code taken from simplejson 1.9 and contributed by Bob
Ippolito.

Closes issue #2750.
2008-05-05 20:21:38 +00:00
Brett Cannon 8a232cc385 Add a DeprecationWarning for when warnings.showwarning() is set to a function
that lacks support for the new 'line' argument.
2008-05-05 05:32:07 +00:00
Georg Brandl bc04346446 #2757: Remove spare newline. 2008-05-04 15:45:05 +00:00
Gerhard Häring e11c9b3dfd Implemented feature request 2157: Converter names are cut off at '('
characters. This avoids the common case of something like 'NUMBER(10)' not
being parsed as 'NUMBER', like expected. Also corrected the docs about
converter names being case-sensitive. They aren't any longer.
2008-05-04 13:42:44 +00:00
Georg Brandl 08c72187ef #2752: wrong meaning of '' for socket host. 2008-05-04 09:15:04 +00:00
Mark Dickinson 1840c1abca Backport Raymond's changes in r60508 to Python 2.6.
'Context flags get set, not incremented'
2008-05-03 18:23:14 +00:00
Georg Brandl 0c65fe606e Fix synopsis. 2008-05-01 18:24:32 +00:00
Georg Brandl 28e0873f1f #2719: backport next() from 3k. 2008-04-30 19:47:09 +00:00
Georg Brandl e8559916fb Fix markup. 2008-04-28 05:16:30 +00:00
Skip Montanaro dfd982715b Wrap some long lines. 2008-04-28 03:25:37 +00:00
Skip Montanaro f30f6e8216 Correct documentation to match implementation: "Class" instead of
"class_descriptor", "Function" instead of "function_descriptor".  Note
default path value for readmodule*.  Wrap some long paragraphs.  Don't
mention 'inpackage' which isn't part of the public API.
2008-04-28 02:59:45 +00:00
Skip Montanaro 798099279d Wrap some long paragraphs and include the default values for optional
function parameters.
2008-04-27 22:52:02 +00:00
Skip Montanaro ef1e58b6f3 minor wording changes, rewrap a few lines 2008-04-27 20:53:57 +00:00
Georg Brandl a3bb57caee #2668: nit in apply() docs. 2008-04-26 18:25:43 +00:00
Thomas Heller 6ad5fbb7ea Add from_buffer and from_buffer_copy class methods to ctypes types. 2008-04-25 15:44:16 +00:00
Benjamin Peterson c7b05920d6 reformat some documentation of classes so methods and attributes are under the class directive 2008-04-25 01:29:10 +00:00
Benjamin Peterson c8590944e5 #2673 Fix example typo in optparse docs 2008-04-23 20:38:06 +00:00
Gregory P. Smith 6c6f4f7139 syntax fixup 2008-04-23 01:06:42 +00:00
Skip Montanaro 6d9aafa49d Factor in documentation changes from issue 1753732. 2008-04-22 22:45:09 +00:00
Gregory P. Smith 19b4411181 Major improvements:
* Default to using /dev/tty for the password prompt and input before
  falling back to sys.stdin and sys.stderr.
* Use sys.stderr instead of sys.stdout.
* print the 'password may be echoed' warning to stream used to display
  the prompt rather than always sys.stderr.
* warn() with GetPassWarning when input may be echoed.
2008-04-22 08:08:41 +00:00
Benjamin Peterson 3c399d1ad1 Various io doc updates 2008-04-22 02:16:03 +00:00
Jeroen Ruigrok van der Werven aa3cadb01e Windows x64 also falls under VER_PLATFORM_WIN32_NT. 2008-04-21 20:15:39 +00:00
Benjamin Peterson ad9f62953f Moved Mark SummerField's io doc changes back to the trunk. (He will edit here in the future.) 2008-04-21 11:57:40 +00:00
Andrew M. Kuchling 89830c3ab1 Wording changes 2008-04-21 02:08:13 +00:00
Andrew M. Kuchling 64c6a0ef6e Markup fix 2008-04-21 02:08:00 +00:00
Mark Dickinson 47a84aa978 Move asinh documentation to the proper place.
Remove meaningless 'in radians' from inverse
hyperbolic functions.
2008-04-19 21:49:22 +00:00
Mark Dickinson 48f7a4aabb Correct documentation for math.pow;
0**nan is nan, not 0.  (But nan**0 and 1**nan are 1.)

Also fix minor typo: 'quite NaN' -> 'quiet NaN'
2008-04-19 21:35:35 +00:00
Benjamin Peterson a7d09031a0 Complete documentation for errors argument of io's open and TextIOWrapper 2008-04-19 19:47:34 +00:00
Benjamin Peterson 53be57e8f8 Copy io documentation back from py3k branch so changes can be merged into it. 2008-04-19 19:34:05 +00:00
Georg Brandl 2fb8a53645 #2631: clarify IMPORT_NAME semantics. 2008-04-19 16:59:16 +00:00
Georg Brandl f801b0f04c #2633: clarify meaning of env parameter. 2008-04-19 16:58:49 +00:00
Georg Brandl fb246c410b #2634: clarify meaning of env parameter to spawn/exec*e. 2008-04-19 16:58:28 +00:00
Georg Brandl 786ead684a #2369: clarify that copyfile() doesn't take a target directory. 2008-04-19 16:57:43 +00:00
Georg Brandl 734de68dd5 Fix-up docs for revision 62386. 2008-04-19 08:23:59 +00:00
Christian Heimes e74c8f2879 Added kill, terminate and send_signal to subprocess.Popen
The bits and pieces for the Windows side were already in place. The POSIX side is trivial (as usual) and uses os.kill().
2008-04-19 02:23:57 +00:00
Christian Heimes 6f34109384 I finally got the time to update and merge Mark's and my trunk-math branch. The patch is collaborated work of Mark Dickinson and me. It was mostly done a few months ago. The patch fixes a lot of loose ends and edge cases related to operations with NaN, INF, very small values and complex math.
The patch also adds acosh, asinh, atanh, log1p and copysign to all platforms. Finally it fixes differences between platforms like different results or exceptions for edge cases. Have fun :)
2008-04-18 23:13:07 +00:00
Andrew M. Kuchling 08923177b4 Rewrite introductory section, and remove old section. (It was already commented-out, but why keep it?) 2008-04-18 18:39:55 +00:00
Andrew M. Kuchling 02f63561a9 Remove personal note from Jim Roskind; it no longer applies, and the
e-mail address is for a previous employer.

Can we move the big long copyright statement into a sidebar or something?
2008-04-18 18:28:23 +00:00
Andrew M. Kuchling aea8d2e8cd Use correct parameter name 2008-04-18 02:40:47 +00:00
Andrew M. Kuchling e2e031394c Typo fixes 2008-04-17 20:44:06 +00:00
Jeroen Ruigrok van der Werven ea7fa72630 Be consistent in the use of read-only. 2008-04-17 12:39:45 +00:00
Raymond Hettinger 5eaffc4ce1 Issue 2648: Add leading zero to money format recipe in the docs. 2008-04-17 10:48:31 +00:00
Jeroen Ruigrok van der Werven 967a83c4ef Add details about the return value for mmap.flush(). 2008-04-16 12:57:43 +00:00
Jeroen Ruigrok van der Werven 069dfad2af Reformat to 80 columns prior to adding documentation. 2008-04-16 12:47:01 +00:00
Nick Coghlan 106fc48336 Issue 2439: add pkgutils.get_data() as a convenience wrapper for the PEP 302 get_data() API (contributed by Paul Moore) 2008-04-15 10:25:31 +00:00
Georg Brandl 4aa8df2871 Fix markup. 2008-04-13 07:07:44 +00:00
Benjamin Peterson 7bb4d2d0fa Backported io module docs 2008-04-13 02:01:27 +00:00
Brett Cannon e974689038 Re-implement the 'warnings' module in C. This allows for usage of the
'warnings' code in places where it was previously not possible (e.g., the
parser). It could also potentially lead to a speed-up in interpreter start-up
if the C version of the code (_warnings) is imported over the use of the
Python version in key places.

Closes issue #1631171.
2008-04-12 23:44:07 +00:00
Georg Brandl 8189310a7f #2615: small consistency update by Jeroen Ruigrok van der Werven. 2008-04-12 18:36:09 +00:00
Amaury Forgeot d'Arc 7adc776ea6 Issue 2408: remove the _types module
It was only used as a helper in types.py to access types (GetSetDescriptorType and MemberDescriptorType),
when they can easily be obtained with python code.
These expressions even work with Jython.

I don't know what the future of the types module is; (cf. discussion in http://bugs.python.org/issue1605 )
at least this change makes it simpler.
2008-04-08 22:07:05 +00:00
Andrew M. Kuchling 5b1070a32b Typo fix 2008-04-07 23:57:21 +00:00
Mark Summerfield 528576031d changed "2500 components" to "several thousand" since the number keeps
growning:-)
2008-04-07 07:39:23 +00:00
Georg Brandl 3b1202dfe8 Mention that the tuple returned by __reduce__ is pickled as normal. 2008-04-05 17:45:58 +00:00
Andrew M. Kuchling 1f2af8c6e4 Markup fix; explain what interval timers do; typo fix 2008-04-05 02:47:07 +00:00
Andrew M. Kuchling 9ff4aea24c Minor edits 2008-04-05 02:42:20 +00:00
Vinay Sajip 89a01cd44b Added updates with respect to recent changes to TimedRotatingFileHandler. 2008-04-02 21:17:25 +00:00
Benjamin Peterson 092a1f7ad7 PyErr_Warn is decrepated. Use PyErr_WarnEx 2008-03-31 21:57:13 +00:00
Georg Brandl c52ed59473 #2505: allow easier creation of AST nodes. 2008-03-30 07:01:47 +00:00
Gerhard Häring c15317efcd Documented the lastrowid attribute. 2008-03-29 19:11:52 +00:00
Georg Brandl 0069d85ba9 Fix capitalization. 2008-03-29 11:46:18 +00:00
Raymond Hettinger 594b76b7eb Be explicit about what efficient means. 2008-03-29 10:42:07 +00:00
Gerhard Häring 4130930b4c Brought documentation for sqlite3 module up-to-date. Fixed Issue1625205 which
complained about commit, rollback and close not being documented.
2008-03-29 01:27:37 +00:00
Georg Brandl d289ea6df9 #2502: add example how to do enum types with named tuples. 2008-03-28 12:58:26 +00:00
Georg Brandl 8ca6c84b6f Phase out has_key usage in the tutorial; correct docs for PyMapping_HasKey*. 2008-03-28 12:22:12 +00:00
Georg Brandl fc8eef3c78 Patch #1810 by Thomas Lee, reviewed by myself:
allow compiling Python AST objects into code objects
in compile().
2008-03-28 12:11:56 +00:00
Gregory P. Smith b9803421d2 Accept patch issue2426 by Paul Kippes (kippesp).
Adds sqlite3.Connection.iterdump to allow dumping of databases.
2008-03-28 08:32:09 +00:00
Georg Brandl 621cd26253 #2406: add examples to gzip docs. 2008-03-28 08:06:56 +00:00
Georg Brandl deaf2cafbd #2248: return result of QUIT from quit(). 2008-03-27 13:27:31 +00:00
Georg Brandl 27f43740b1 Add an example for an RFC 822 continuation. 2008-03-26 09:32:46 +00:00
Georg Brandl 799b372f31 #2476: document that %default feature is new in 2.4. 2008-03-25 08:39:10 +00:00
Georg Brandl 18f1914a02 #868845: document <...> reprs. 2008-03-25 07:20:15 +00:00
Martin v. Löwis aef18b1c67 Patch #2240: Implement signal.setitimer and signal.getitimer. 2008-03-24 13:31:16 +00:00
Georg Brandl 9bdead0aed #1700821: add a note to audioop docs about signedness of sample formats. 2008-03-24 09:34:34 +00:00
Raymond Hettinger d145240f9a Tighten documentation for Random.triangular. 2008-03-24 06:07:49 +00:00
Raymond Hettinger c4f7bab0a0 Adopt Nick's suggestion for useful default arguments.
Clean-up floating point issues by adding true division and float constants.
2008-03-23 19:37:53 +00:00
Raymond Hettinger bbc50eafe5 Issue 1681432: Add triangular distribution the random module. 2008-03-23 13:32:32 +00:00
Georg Brandl 61854332b9 Make the doctests presentation-friendlier. 2008-03-23 08:05:30 +00:00
Raymond Hettinger e70bb8d6f2 Simplify demo code. 2008-03-23 00:55:46 +00:00
Georg Brandl e8f1b00372 Enable doctest running for several other documents.
We have now over 640 doctests that are run with "make doctest".
2008-03-22 22:04:10 +00:00
Georg Brandl 7a45ab826e Enable doctests in functions.rst. Already found two errors :) 2008-03-22 21:38:33 +00:00
Georg Brandl 4f0f34f131 Test doctests in operator docs. 2008-03-22 21:26:44 +00:00
Georg Brandl 3f04303ba4 Test doctests in datetime docs. 2008-03-22 21:21:57 +00:00
Georg Brandl 4c8bbe69e5 Make collections' doctests executable.
(The <BLANKLINE>s will be stripped from presentation output.)
2008-03-22 21:06:20 +00:00
Georg Brandl 3dd57815b2 Fix-up syntax problems. 2008-03-22 20:08:43 +00:00
Georg Brandl 838b4b0145 No need to specify explicit "doctest_block" anymore. 2008-03-22 13:07:06 +00:00
Georg Brandl 473f1642a4 Make more doctests in pprint docs testable. 2008-03-22 12:59:37 +00:00
Georg Brandl 6199e32a74 Make doctests in re docs usable with sphinx' doctest. 2008-03-22 12:04:26 +00:00
Georg Brandl 9f6623255b Test decimal.rst doctests as far as possible with sphinx doctest. 2008-03-22 11:47:10 +00:00
Georg Brandl 17baef0b7c Activate the Sphinx doctest extension and convert howto/functional to use it. 2008-03-22 10:56:23 +00:00
Georg Brandl 86f38c81ae #1918: document that weak references *to* an object are
cleared before the object's __del__ is called, to ensure that the weak
reference callback (if any) finds the object healthy.
2008-03-22 10:07:29 +00:00
Christian Heimes 0e9ab5f2f0 Applied patch #1657 epoll and kqueue wrappers for the select module
The patch adds wrappers for the Linux epoll syscalls and the BSD kqueue syscalls. Thanks to Thomas Herve and the Twisted people for their support and help.
TODO: Finish documentation documentation
2008-03-21 23:49:44 +00:00
Georg Brandl 5f79446af0 Add missing versionadded tag. 2008-03-21 21:05:03 +00:00
Georg Brandl d346475a0c Add docs for print_function and future_builtins. Fixes #2442. 2008-03-21 19:37:57 +00:00
Georg Brandl 3fbe20c01e Add docs for __func__ and __self__ on methods. 2008-03-21 19:20:21 +00:00
Georg Brandl 06291185e1 Fix a code block in __future__ docs. 2008-03-21 19:14:38 +00:00
Marc-André Lemburg 4e0c72bbf0 Clarfiy the availability of the extended support for win32_ver() in Py2.6. 2008-03-20 18:58:14 +00:00
Marc-André Lemburg 53c7a60379 Add documentation for updated Windows support in win32_ver().
Add documentation for linux_distribution() API.
2008-03-20 17:55:31 +00:00
Sean Reifscheider 45ea86c124 Issue 2188: Documentation hint about disabling proxy detection. 2008-03-20 03:20:48 +00:00
Gregory P. Smith a5cfcad0e3 Prevent ioctl op codes from being sign extended from int to unsigned long
when used on platforms that actually define ioctl as taking an unsigned long.
(the BSDs and OS X / Darwin)

Adds a unittest for fcntl.ioctl that tests what happens with both positive and
negative numbers.

This was done because of issue1471 but I'm not able to reproduce -that- problem
in the first place on Linux 32bit or 64bit or OS X 10.4 & 10.5 32bit or 64 bit.
2008-03-19 23:03:25 +00:00
Georg Brandl 97e863eaf8 Another one. 2008-03-19 07:57:57 +00:00
Georg Brandl 482d752dcb Remove footnote from versionchanged as it upsets LaTeX. 2008-03-19 07:56:40 +00:00
Gregory P. Smith bde40078b0 Mention that crc32 and adler32 are available in a different module (zlib).
Some people look for them in hashlib.
2008-03-19 01:38:35 +00:00
Steven Bethard 6f778cfb5b Document unicode.isnumeric() and unicode.isdecimal() (issue2326) 2008-03-17 19:33:11 +00:00
Gregory P. Smith f48f9d38c0 Force zlib.crc32 and zlib.adler32 to return a signed integer on all platforms
regardless of the native sizeof(long) used in the integer object.

This somewhat odd behavior of returning a signed is maintained in 2.x for
compatibility reasons of always returning an integer rather than a long object.

Fixes Issue1202 for Python 2.6
2008-03-17 18:48:05 +00:00
Mark Summerfield 43da35de7b Added a footnote to each pointing out that for XML output if an encoding
string is given it should conform to the appropriate XML standards---for
example, "UTF-8" is okay, but "UTF8" is not.
2008-03-17 08:28:15 +00:00
Vinay Sajip 91f0ee4db6 Clarified documentation on use of shutdown(). 2008-03-16 21:35:58 +00:00
Raymond Hettinger a6cfeb4b9d Update docs to reflect removal of Exact/Inexact 2008-03-16 05:20:42 +00:00
Skip Montanaro fc070d2731 add %f format to datetime - issue 1158 2008-03-15 16:04:45 +00:00
Skip Montanaro 75e51680f1 note that fork and forkpty raise OSError on failure 2008-03-15 02:32:49 +00:00
Georg Brandl 0267781742 Fix lots of broken links in the docs, found by Sphinx' external link checker. 2008-03-15 00:20:19 +00:00
Georg Brandl bd77681f36 Remove obsolete paragraph. #2288. 2008-03-14 23:10:34 +00:00
Raymond Hettinger 53bdf09343 Issue 2274: Add heapq.heappushpop(). 2008-03-13 19:03:51 +00:00
Georg Brandl 2e25551ef8 #1720705: add docs about import/threading interaction, wording by Nick. 2008-03-13 07:21:41 +00:00
Georg Brandl 4bb40b9428 #2270: fix typo. 2008-03-13 07:17:14 +00:00
Georg Brandl d85a13a954 #2265: fix example. 2008-03-13 07:15:56 +00:00
Raymond Hettinger 513460f80d Improve docs for itemgetter(). Show that it works with slices. 2008-03-11 21:37:46 +00:00
Raymond Hettinger e8b4b60555 Add recipe to docs. 2008-03-11 00:19:07 +00:00
Georg Brandl c557db5268 #2249: document assertTrue and assertFalse. 2008-03-09 15:11:39 +00:00
Facundo Batista c54aec1fda Issue 1106316. post_mortem()'s parameter, traceback, is now
optional: it defaults to the traceback of the exception that is currently
being handled.
2008-03-08 16:50:27 +00:00
Andrew M. Kuchling 31c6de4f79 Grammar fix 2008-03-07 21:09:23 +00:00
Nick Coghlan 7af53be66f Speed up with statements by storing the __exit__ method on the stack instead of in a temp variable (bumps the magic number for pyc files) 2008-03-07 14:13:28 +00:00
Jeffrey Yasskin e75f59a578 Progress on issue #1193577 by adding a polling .shutdown() method to
SocketServers. The core of the patch was written by Pedro Werneck, but any bugs
are mine. I've also rearranged the code for timeouts in order to avoid
interfering with the shutdown poll.
2008-03-07 06:22:15 +00:00
Raymond Hettinger 38fb9bee6c Tweak recipes and tests 2008-03-07 01:33:20 +00:00
Georg Brandl a7bd27f0a8 #2225: return nonzero status code from py_compile if not all files could be compiled. 2008-03-06 07:41:16 +00:00
Georg Brandl 70992c3c83 Expand on re.split behavior with captured expressions. 2008-03-06 07:19:15 +00:00
Raymond Hettinger 040f10e9b3 Add examples. 2008-03-06 01:15:52 +00:00
Thomas Heller f3c0559b5e Issue 1872: Changed the struct module typecode from 't' to '?', for
compatibility with PEP3118.
2008-03-05 15:34:29 +00:00
Raymond Hettinger d553d856e7 Beef-up docs and tests for itertools. Fix-up end-case for product(). 2008-03-04 04:17:08 +00:00
Andrew M. Kuchling 3fe1843cee Add versionadded tags 2008-03-04 01:49:37 +00:00
Andrew M. Kuchling 684868ac90 Fix sentence fragment 2008-03-04 01:47:38 +00:00
Andrew M. Kuchling ece10b4004 Grammar fix; markup fix 2008-03-04 01:30:10 +00:00
Georg Brandl 3e9d66fee1 There are now sixteen isfoo functions. 2008-03-03 20:37:55 +00:00
Christian Heimes 608c1d8e87 Since abc._Abstract was replaces by a new type flags the regression test suite fails. I've added a new function inspect.isabstract(). Is the mmethod fine or should I check if object is a instance of type or subclass of object, too? 2008-03-03 18:28:04 +00:00
Georg Brandl e6dab2a077 Fix factual error. 2008-03-02 14:15:04 +00:00
Georg Brandl 72780a4b0c Make clear that the constants are strings. 2008-03-02 13:41:39 +00:00
Raymond Hettinger 2b7a5c468b Tighten example code. 2008-03-02 11:17:51 +00:00
Raymond Hettinger f287f17779 Finish-up docs for combinations() and permutations() in itertools. 2008-03-02 10:59:31 +00:00
Raymond Hettinger 330958e647 Document impending updates to itertools. 2008-02-28 19:41:24 +00:00
Raymond Hettinger 18750ab2a0 Add repeat keyword argument to itertools.product(). 2008-02-28 09:23:48 +00:00
Raymond Hettinger c105289ec4 Simply the sample code for combinations(). 2008-02-27 01:44:34 +00:00
Raymond Hettinger 93e804da9c Add itertools.combinations(). 2008-02-26 23:40:50 +00:00
Neal Norwitz ca37661a69 Add a timing flag to Trace so you can see where slowness occurs
like waiting for socket timeouts in test_smtplib :-).
2008-02-26 08:21:28 +00:00
Georg Brandl 1b3e41c67e Banish tab. 2008-02-26 06:40:10 +00:00
Raymond Hettinger 3fa41d5a1c Docs for itertools.combinations(). Implementation in forthcoming checkin. 2008-02-26 02:46:54 +00:00
Georg Brandl fd429063e1 Revert r61029. 2008-02-25 20:20:45 +00:00
Brett Cannon 499969a08c Add minor markup for a string. 2008-02-25 05:33:07 +00:00
Georg Brandl f1699cd4c1 Document import ./. threading issues. #1720705. 2008-02-23 23:25:26 +00:00
Georg Brandl ebcfd11c16 #1506171: added operator.methodcaller(). 2008-02-23 23:04:35 +00:00
Georg Brandl e2065c65d3 #1826: allow dotted attribute paths in operator.attrgetter. 2008-02-23 23:02:23 +00:00
Georg Brandl b0b0317ba2 #1825: correctly document msilib.add_data. 2008-02-23 22:55:18 +00:00
Georg Brandl ffada76d04 Add examples to modulefinder docs. Written for GHOP by Josip Dzolonga. 2008-02-23 22:05:38 +00:00
Georg Brandl 7d009926ad #2101: fix removeAttribute docs. 2008-02-23 21:59:11 +00:00
Andrew M. Kuchling 8887e54867 #835521: Add index entries for various pickle-protocol methods and attributes 2008-02-23 16:39:43 +00:00
Andrew M. Kuchling 085f75a851 #1330538: Improve comparison of xmlrpclib.DateTime and datetime instances.
Remove automatic handling of datetime.date and datetime.time.
This breaks backward compatibility, but python-dev discussion was strongly
against this automatic conversion; see the bug for a link.
2008-02-23 16:23:05 +00:00
Georg Brandl 5972493383 #2161: Fix opcode name. 2008-02-23 15:43:48 +00:00
Andrew M. Kuchling b678f98511 #2072: correct documentation for .rpc_paths 2008-02-23 15:41:51 +00:00
Georg Brandl 080b094d20 More difflib examples. Written for GHOP by Josip Dzolonga. 2008-02-23 15:19:54 +00:00
Facundo Batista 7e251e83d5 Issue 1089358. Adds the siginterrupt() function, that is just a
wrapper around the system call with the same name.  Also added
test cases, doc changes and NEWS entry. Thanks Jason and Ralf
Schmitt.
2008-02-23 15:07:35 +00:00
Georg Brandl 1647923bbf #1492: allow overriding BaseHTTPServer's content type for error messages. 2008-02-23 15:02:28 +00:00
Facundo Batista b12f0b581a Issue 1781. Now ConfigParser.add_section does not let you add a
DEFAULT section any more, because it duplicated sections with
the rest of the machinery. Thanks Tim Lesher and Manuel Kaufmann.
2008-02-23 12:46:10 +00:00
Raymond Hettinger 7832d4d534 Add recipe using itertools.product(). 2008-02-23 10:04:15 +00:00
Raymond Hettinger c5705a823b Document itertools.product(). 2008-02-22 19:50:06 +00:00
Georg Brandl 1699db145f Another fix. 2008-02-22 12:57:05 +00:00
Georg Brandl 907a720f89 A lot more typo fixes by Ori Avtalion. 2008-02-22 12:31:45 +00:00
Georg Brandl 12db865a64 Part of #2154: minimal syntax fixes in doc example snippets. 2008-02-21 20:38:13 +00:00
Georg Brandl 359b9e994b #2079: typo in userdict docs. 2008-02-21 20:33:38 +00:00
Facundo Batista 759bfc6207 Issue #1916. Added isgenerator() and isgeneratorfunction() to
inspect.py.  Thanks Javi Mansilla for patch review and
corrections.
2008-02-18 03:43:43 +00:00
Georg Brandl 5e203f56db #2131: note that codecs.open() always opens files in binary mode. 2008-02-17 11:33:38 +00:00
Thomas Heller e7fb0c5114 Try to correct a markup error that does hide the following paragraph. 2008-02-14 21:00:28 +00:00
Raymond Hettinger 5111c522e7 Fix markup 2008-02-14 19:02:39 +00:00
Raymond Hettinger 0cd717007d Simplify moneyfmt() recipe. 2008-02-14 12:49:37 +00:00
Raymond Hettinger 50361d4d9b Fix markup. 2008-02-14 12:05:42 +00:00
Raymond Hettinger d68bf02810 Show how to remove exponents. 2008-02-14 11:57:25 +00:00
Raymond Hettinger 27a90d989d Improve rst markup 2008-02-14 11:01:10 +00:00
Raymond Hettinger 4631481dfd Add fixed-point examples to the decimal FAQ 2008-02-14 10:46:57 +00:00
Raymond Hettinger abe3237187 Fix decimal repr which should have used single quotes like other reprs. 2008-02-14 02:41:22 +00:00
Thomas Heller a06a1a88ee Add pickle support to ctypes types. 2008-02-13 20:21:53 +00:00
Georg Brandl 0a40ffb1b3 #2063: correct order of utime and stime in os.times()
result on Windows.
2008-02-13 07:20:22 +00:00
Mark Dickinson e1b824793a Implementation of Fraction.limit_denominator.
Remove Fraction.to_continued_fraction and
Fraction.from_continued_fraction
2008-02-12 21:31:59 +00:00
Raymond Hettinger 596fdd0fd3 Restore fractions.rst to the document tree. 2008-02-12 00:15:32 +00:00
Raymond Hettinger bc4ffc17df Backport ABC docs 2008-02-11 23:38:00 +00:00
Raymond Hettinger 2ddbd80606 Fix markup 2008-02-11 23:34:56 +00:00
Mark Dickinson d058cd2cc8 Rename rational.Rational to fractions.Fraction, to avoid name clash
with numbers.Rational.  See issue #1682 for related discussion.
2008-02-10 21:29:51 +00:00
Raymond Hettinger da614dcc4f Complete an open todo on pickletools -- add a pickle optimizer. 2008-02-10 20:35:16 +00:00
Mark Dickinson 3a94ee05f7 Typos in decimal comment and documentation 2008-02-10 15:19:58 +00:00
Raymond Hettinger 13a707577f Clarify that decimal also supports fixed-point arithmetic. 2008-02-10 07:21:09 +00:00
Nick Coghlan 97fac3eb0a Issue 2021: Allow NamedTemporaryFile and SpooledTemporaryFile to be used as context managers. (The NamedTemporaryFile fix should be considered for backporting to 2.5) 2008-02-09 15:28:09 +00:00
Raymond Hettinger 7e33663ec4 Add advice on choosing between DictMixin and MutableMapping 2008-02-08 23:57:06 +00:00
Raymond Hettinger 23bdcc9253 Fix typo 2008-02-07 20:10:49 +00:00
Raymond Hettinger ff1f97307d The float conversion recipe is simpler in Py2.6 2008-02-07 20:04:37 +00:00
Walter Dörwald a53800e02c Fix documentation for Calendar.iterweekdays(): firstweekday is a property.
Fixes second part of #2018.
2008-02-07 19:48:34 +00:00
Walter Dörwald 97bf449f75 Clarify that the output of TextCalendar.formatmonth() and
TextCalendar.formatyear() for custom instances won't be influenced by calls
to the module global setfirstweekday() function. Fixes #2018.
2008-02-07 19:30:22 +00:00
Mark Dickinson 00c2e65850 IEEE 754 should be IEEE 854; give precise reference for
comparisons involving NaNs.
2008-02-07 01:42:06 +00:00
Mark Dickinson ff6672fda1 Fix broken link in decimal documentation. 2008-02-07 01:14:23 +00:00
Mark Dickinson bafa9425a6 Remove incorrect usage of :const: in documentation. 2008-02-06 22:25:16 +00:00
Mark Dickinson 2fc9263df5 Issue 1979: Make Decimal comparisons (other than !=, ==) involving NaN
raise InvalidOperation (and return False if InvalidOperation is trapped).
2008-02-06 22:10:50 +00:00
Walter Dörwald c16c57c733 Remove month parameter from Calendar.yeardatescalendar(),
Calendar.yeardays2calendar() and Calendar.yeardayscalendar() as the methods
don't have such a parameter. Fixes issue #2017.

Rewrap content to 80 chars.
2008-02-06 14:31:55 +00:00
Skip Montanaro 3c0f309fd1 correct object name 2008-02-05 19:24:30 +00:00
Georg Brandl 1cf0522f26 Convert external links to internal links. Fixes #2010. 2008-02-05 12:01:24 +00:00
Christian Heimes 422051a367 Patch #1953
I implemented the function sys._compact_freelists() and C API functions PyInt_/PyFloat_CompactFreeList() to compact the pre-allocated blocks of ints and floats. They allow the user to reduce the memory usage of a Python process that deals with lots of numbers.
The patch also renames sys._cleartypecache to sys._clear_type_cache
2008-02-04 18:00:12 +00:00
Brett Cannon 89dfbe35af Remove extra tick marks and add a missing closing parenthesis. 2008-02-03 02:34:14 +00:00
Georg Brandl bbc4fc2933 Add email example how to send a multipart message.
Written for GHOP by Martin Matejek.
2008-02-02 10:49:58 +00:00
Georg Brandl 586a57a43c Amendments to the urllib2 docs, written for GHOP by Thomas Lamb. 2008-02-02 09:56:20 +00:00
Georg Brandl 2a5d1c3493 Update IPv6 RFC number. 2008-02-01 11:59:08 +00:00
Jeffrey Yasskin ca2b69f765 Move __builtins__.trunc() to math.trunc() per
http://mail.python.org/pipermail/python-dev/2008-January/076626.html and issue
1965.
2008-02-01 06:22:46 +00:00
Jeffrey Yasskin b23dea6adb Added more documentation on how mixed-mode arithmetic should be implemented. I
also noticed and fixed a bug in Rational's forward operators (they were
claiming all instances of numbers.Rational instead of just the concrete types).
2008-01-31 07:44:11 +00:00
Raymond Hettinger a44327a9a2 Update itertool recipes 2008-01-30 22:17:31 +00:00
Christian Heimes 908caac52e Added clear cache methods to clear the internal type lookup cache for ref leak test runs. 2008-01-27 23:34:59 +00:00
Raymond Hettinger 9bba7b7085 Removed an unnecessary and confusing paragraph from the namedtuple docs. 2008-01-27 10:47:55 +00:00
Gregory P. Smith d006380fe1 Update docs for new callpack params added in r60188 2008-01-26 18:51:05 +00:00
Georg Brandl 0522548d61 Slashes allowed on Windows. 2008-01-26 11:02:22 +00:00
Georg Brandl fe7dd50907 #1934: fix os.path.isabs docs. 2008-01-26 09:43:35 +00:00
Vinay Sajip f38ba78d7d Added documentation for optional delay argument to FileHandler and subclasses. 2008-01-24 12:38:30 +00:00
Gregory P. Smith 7b7ce7854c Fix issue1789: The tutorial contained a misuse of the struct module.
(also remove an unneeded import struct from test_largefile)
2008-01-24 09:38:26 +00:00
Raymond Hettinger c226c31139 Let pprint() support sets and frozensets (suggested by David Mertz). 2008-01-23 00:04:40 +00:00
Raymond Hettinger 2dec48d1c5 Improve variable name in sample code 2008-01-22 22:09:26 +00:00
Raymond Hettinger 9ed5b57fe2 Give zip() the same guarantee as izip() for left-to-right evaluation. 2008-01-22 20:18:53 +00:00
Raymond Hettinger 48c6293500 Document when to use izip_longest(). 2008-01-22 19:51:41 +00:00
Vinay Sajip 733024a752 Minor documentation change - hyperlink tidied up. 2008-01-21 17:39:22 +00:00
Georg Brandl 0751d1ad2a Adapt pydoc to new doc URLs. 2008-01-21 17:13:03 +00:00
Georg Brandl f8dd5b393c Removing bundlebuilder docs again -- it's not to be used anymore (see #779825). 2008-01-21 16:46:58 +00:00
Georg Brandl d7e3e60b87 Add a stub for bundlebuilder documentation. 2008-01-21 16:36:00 +00:00
Georg Brandl 864de8274c #1555501: document plistlib and move it to the general library. 2008-01-21 16:34:07 +00:00
Georg Brandl 960b186eaf Fix example. 2008-01-21 16:28:13 +00:00
Georg Brandl 845c403c08 #1087741: make mmap.mmap the type of mmap objects, not a
factory function. Allow it to be subclassed.
2008-01-21 14:16:46 +00:00
Georg Brandl 5235398323 #1669: don't allow shutil.rmtree() to be called on a symlink. 2008-01-20 14:17:42 +00:00
Georg Brandl 56112895d6 #1648: add sys.gettrace() and sys.getprofile(). 2008-01-20 13:59:46 +00:00
Georg Brandl 92058d2933 #652749: document the constants added to the builtins by site.py. 2008-01-20 13:08:37 +00:00
Georg Brandl 440f2fff14 #799369: document possible sys.platform values. 2008-01-20 12:57:47 +00:00
Georg Brandl 2235011d49 #856047: respect the ``no_proxy`` env var when checking for proxies
in urllib and using the other ``_proxy`` env vars.
Original patch by Donovan Baarda.
2008-01-20 12:05:43 +00:00
Georg Brandl 9b0d46db11 #1178141: add addinfourl.code to get http status code from urllib. 2008-01-20 11:43:03 +00:00
Gregory P. Smith da407232e0 Document that zipfile decryption is insanely slow and fix a typo and
blatant lie in a docstring (it is not useful for security regardless of
how you spell it).
2008-01-20 01:32:00 +00:00
Andrew M. Kuchling 8b506e7a2d Bug 1296: restore text describing OptionGroup 2008-01-19 21:00:38 +00:00
Georg Brandl f558d2e5f5 #1509: fix sqlite3 docstrings and docs w.r.t. cursor.fetchXXX methods. 2008-01-19 20:53:07 +00:00
Georg Brandl e3979f776a #1411695: clarify behavior of xml.sax.utils.[un]escape. 2008-01-19 20:40:24 +00:00
Georg Brandl 309501a617 #1663329: add os.closerange() to close a range of fds,
ignoring errors, and use this in subprocess to speed up
subprocess creation in close_fds mode. Patch by Mike Klaas.
2008-01-19 20:22:13 +00:00
Facundo Batista 873c9857b7 Fix #1693149. Now you can pass several modules separated by
coma to trace.py in the same --ignore-module option.
Thanks Raghuram Devarakonda.
2008-01-19 18:38:19 +00:00
Andrew M. Kuchling 5c60bfcfbf Patch #976880: add mmap .rfind() method, and 'end' paramter to .find().
Contributed by John Lenton.
2008-01-19 18:18:41 +00:00
Georg Brandl 6ebc52749c Clarify thread.join() docs. #1873. 2008-01-19 17:38:53 +00:00
Andrew M. Kuchling e45a77adbe Patch #742598 from Michael Pomraning: add .timeout attribute to SocketServer that will call
.handle_timeout() method when no requests are received within the timeout period.
2008-01-19 16:26:13 +00:00
Andrew M. Kuchling f8f4eb69ce Polish sentence 2008-01-19 13:33:20 +00:00
Georg Brandl a7d70fd438 Amend curses docs by info how to write non-ascii characters.
Thanks to Jeroen Ruigrok van der Werven.
2008-01-19 10:16:09 +00:00
Georg Brandl f8e6afbb66 Fix markup. 2008-01-19 10:11:27 +00:00
Jeffrey Yasskin 45169fbc80 Several tweaks: add construction from strings and .from_decimal(), change
__init__ to __new__ to enforce immutability, and remove "rational." from repr
and the parens from str.
2008-01-19 09:56:06 +00:00
Raymond Hettinger 0fe6ca4673 Better variable name in an example. 2008-01-18 21:14:58 +00:00
Vinay Sajip c7403355df Added section on passing contextual information to logging and documentation for the LoggerAdapter class. 2008-01-18 15:54:14 +00:00
Andrew M. Kuchling 6d22c3961d Typo fix 2008-01-18 02:42:52 +00:00
Raymond Hettinger 64cd1e2d91 Fix markup 2008-01-17 23:56:56 +00:00
Raymond Hettinger 497fdbf767 Fix-up Timer() example. 2008-01-17 23:32:01 +00:00
Raymond Hettinger d0ab014b5e Add advice on choosing between scheduler and threading.Timer(). 2008-01-17 22:27:49 +00:00
Raymond Hettinger 44bd6c0a4f Issue #1861: Add read-only attribute listing upcoming events in the order they will be run. 2008-01-17 19:31:38 +00:00
Gregory P. Smith bde4ae4bde Fixes (accepts patch) issue1339 - http://bugs.python.org/issue1339
- Factor out the duplication of EHLO/HELO in login() and sendmail() to
  a new function, ehlo_or_helo_if_needed().
- Use ehlo_or_helo_if_needed() in starttls()
- Check for the starttls exception in starttls() in the same way as
  login() checks for the auth extension.
Contributed by Bill Fenner.
2008-01-17 08:35:49 +00:00
Raymond Hettinger d59f457279 Note versionadded. 2008-01-17 08:07:05 +00:00
Raymond Hettinger 473170908e Make starmap() match its pure python definition and accept any itertable input (not just tuples). 2008-01-17 03:02:14 +00:00
Raymond Hettinger 171f3916c5 Minor wordsmithing. 2008-01-16 23:38:16 +00:00
Georg Brandl 5c8b2abf71 Fix MSDN library URL. (#1854) 2008-01-16 16:56:29 +00:00
Andrew M. Kuchling 95f17bbfc0 Markup fix 2008-01-16 13:01:51 +00:00
Raymond Hettinger e805782b53 Fix-up half-written paragraph in the docs 2008-01-15 21:22:47 +00:00
Raymond Hettinger f59e962b49 Refactor if/elif chain for clarity and speed. Remove dependency on subclasses having to implement _empty and _full. 2008-01-15 20:52:42 +00:00
Jeffrey Yasskin d7b00334f3 Add rational.Rational as an implementation of numbers.Rational with infinite
precision. This has been discussed at http://bugs.python.org/issue1682. It's
useful primarily for teaching, but it also demonstrates how to implement a
member of the numeric tower, including fallbacks for mixed-mode arithmetic.

I expect to write a couple more patches in this area:
 * Rational.from_decimal()
 * Rational.trim/approximate() (maybe with different names)
 * Maybe remove the parentheses from Rational.__str__()
 * Maybe rename one of the Rational classes
 * Maybe make Rational('3/2') work.
2008-01-15 07:46:24 +00:00
Raymond Hettinger 907cda6ebb Small grammar nit 2008-01-15 05:46:43 +00:00
Skip Montanaro f233b0c454 Better (?) text describing the lack of guarantees provided by qsize(),
empty() and full().
2008-01-15 03:40:20 +00:00
Andrew M. Kuchling f15ff46be5 Markup fix 2008-01-15 01:29:44 +00:00
Andrew M. Kuchling 7ce9b18460 Typo fixes 2008-01-15 01:29:16 +00:00
Christian Heimes c94e2b5c12 Now that I've learnt about structseq objects I felt like converting sys.float_info to a structseq. It's
readonly and help(sys.float_info) explains the attributes nicely.
2008-01-14 04:13:37 +00:00
Christian Heimes f31b69f9db Applied patch #1816: sys.flags patch 2008-01-14 03:42:48 +00:00
Georg Brandl 9f1e2ecb48 Clarify the effect of text mode. 2008-01-13 09:36:18 +00:00
Georg Brandl fca4e1ffa1 Fix editing glitch. 2008-01-12 16:11:09 +00:00
Georg Brandl 57fe0f2902 Move OSError docs to exceptions doc, remove obsolete descriptions
from os docs, rework posix docs.
2008-01-12 10:53:29 +00:00
Mark Dickinson 59bc20bb27 Issue 1780: Allow leading and trailing whitespace in Decimal constructor,
when constructing from a string. Disallow trailing newlines in
Context.create_decimal.
2008-01-12 01:56:00 +00:00
Raymond Hettinger bed4dd459d Update the opcode docs for STORE_MAP and BUILD_MAP 2008-01-11 23:25:18 +00:00
Andrew M. Kuchling de68037202 Bug #1790: update link; remove outdated paragraph 2008-01-11 19:33:24 +00:00
Georg Brandl e3c3db59b5 Documentation for r5990[3567]. 2008-01-11 09:55:53 +00:00
Raymond Hettinger d1ef85420f Run doctests on the collections module 2008-01-11 00:23:13 +00:00
Raymond Hettinger 15b5e55b48 Neaten-up the named tuple docs 2008-01-10 23:00:01 +00:00
Amaury Forgeot d'Arc d08a8ebf2a Closing issue1761.
Surprising behaviour of the "$" regexp: it matches the
end of the string, AND just before the newline at the end
of the string::

    re.sub('$', '#', 'foo\n') == 'foo#\n#'

Python is consistent with Perl and the pcre library, so
we just document it.
Guido prefers "\Z" to match only the end of the string.
2008-01-10 21:59:42 +00:00
Raymond Hettinger e850c466c7 Clarify how to add a field to a named tuple. 2008-01-10 20:37:12 +00:00
Raymond Hettinger e1655088ca Examples for named tuple subclassing should include __slots__ 2008-01-10 19:15:10 +00:00
Raymond Hettinger dc1854dec4 Fix typo 2008-01-09 03:13:20 +00:00
Raymond Hettinger e11230e11b Syntax highlighting only works when >>> lines are accompanied by ... lines 2008-01-09 03:02:23 +00:00
Georg Brandl 502d6312db Fix markup errors from r59857 and clarify key.__enter__/__exit__ docs 2008-01-08 16:18:26 +00:00
Christian Heimes b39a756afd Added __enter__ and __exit__ functions to HKEY object
Added ExpandEnvironmentStrings to the _winreg module.
2008-01-08 15:46:10 +00:00
Andrew M. Kuchling e0a49b6e05 Patch 1137: allow assigning to .buffer_size attribute of PyExpat.parser objects 2008-01-08 14:30:55 +00:00
Raymond Hettinger ac5742e0fe Docs on named tuple's naming conventions and limits of subclassing 2008-01-08 02:24:15 +00:00
Raymond Hettinger f6b769b464 Documentation nits. 2008-01-07 21:33:51 +00:00
Raymond Hettinger f5e8af1bb7 Use get() instead of pop() for the optimized version of _replace(). 2008-01-07 20:56:05 +00:00
Raymond Hettinger fb3ced663d Minor markup fix 2008-01-07 20:17:35 +00:00
Raymond Hettinger 9a359210aa Cleanup named tuple subclassing example. 2008-01-07 20:07:38 +00:00
Vinay Sajip aa0665ba17 Added section about adding contextual information to log output. 2008-01-07 19:40:10 +00:00
Georg Brandl 61d2886491 Fix two further doc build warnings. 2008-01-07 18:57:03 +00:00
Georg Brandl 62416bcf5a #467924, patch by Alan McIntyre: Add ZipFile.extract and ZipFile.extractall. 2008-01-07 18:47:44 +00:00
Georg Brandl 62647653eb Restructure urllib doc structure. 2008-01-07 18:23:27 +00:00
Georg Brandl 2da0fceba7 Patch #602345 by Neal Norwitz and me: add -B option and PYTHONDONTWRITEBYTECODE envvar to skip writing bytecode. 2008-01-07 17:09:35 +00:00
Georg Brandl b3255ed8c9 Restore "somenamedtuple" as the "class" for named tuple attrs. 2008-01-07 16:43:47 +00:00
Mark Summerfield 86dfee5c45 Added a hyperlink from sequence types to mutable sequence types. 2008-01-07 16:42:08 +00:00
Christian Heimes fb2d25a154 Issue #1646: Make socket support TIPC. The socket module now has support
for TIPC under Linux, see http://tipc.sf.net/ for more information.
Thanks to Alberto Bertogli for the patch
2008-01-07 16:12:44 +00:00
Vinay Sajip e28fa297e9 Updated docs for basicConfig to indicate it's a no-op if handlers have been defined for the root logger. 2008-01-07 15:30:36 +00:00
Georg Brandl 503f2935c9 Clean up markup. 2008-01-07 09:18:17 +00:00
Georg Brandl 3c403b2370 Consistency nit. 2008-01-07 09:16:08 +00:00
Georg Brandl 66502c11e9 Change virtual class name of __iter__ to "object" in order to make it linkable. 2008-01-07 09:07:38 +00:00
Raymond Hettinger dc55f35f38 Add another named tuple subclassing example. 2008-01-07 09:03:49 +00:00
Raymond Hettinger 1db6f80cd5 Cleanup subclassing example to more clearly show fixed-width print format. 2008-01-07 05:50:35 +00:00
Raymond Hettinger b8e0072fec Add subclassing example to docs for named tuples. 2008-01-07 04:24:49 +00:00
Georg Brandl 4273222a68 Remove latex trace. 2008-01-06 23:22:27 +00:00
Georg Brandl 27a2d1332b Fix introductory sentence. 2008-01-06 17:21:00 +00:00
Georg Brandl e260ba2d33 #1325: Add docs and tests for zipimporter.archive and zipimporter.prefix. 2008-01-06 16:49:50 +00:00
Georg Brandl 516787dd98 #1499: Document compile() exceptions. 2008-01-06 16:22:56 +00:00
Georg Brandl 81de0d24d5 #1582: document __reversed__, patch by Mark Russell. 2008-01-06 16:17:56 +00:00
Georg Brandl ec32b6bce7 #1559684: document that shutil.copy* doesn't copy all metadata on Posix and Windows too. 2008-01-06 16:12:39 +00:00
Georg Brandl 14aaee143d #1686390: add example for csv.Sniffer use. 2008-01-06 16:04:56 +00:00
Georg Brandl 2cb103ffa9 #1727024: document that Popen.returncode is set by Popen.poll/wait. 2008-01-06 16:01:26 +00:00
Georg Brandl c4768a4a98 #1615275: clarify return object types of different tempfile factories. 2008-01-06 15:55:26 +00:00
Georg Brandl 91a4808aa8 #759525: document that dir() doesn't return metaclass attrs when given a class as arg. 2008-01-06 15:48:20 +00:00
Georg Brandl db210dfba2 #1501: document that 0**0 == 1. 2008-01-06 15:41:50 +00:00
Georg Brandl a8cbad3b83 #1755097: document default values for [].sort() and sorted(). 2008-01-06 15:34:57 +00:00
Georg Brandl 437e15d42b #1680: fix context manager example function name. 2008-01-06 15:30:34 +00:00
Raymond Hettinger 1166872006 Small code simplification. Forgot that classmethods can be called from intances. 2008-01-06 09:02:24 +00:00
Georg Brandl 165010834a #1719: capitalization error in "UuidCreate". 2008-01-05 20:46:29 +00:00
Georg Brandl 2fa2f5d3e5 Revert socket.rst to unix-eol. 2008-01-05 20:29:13 +00:00
Georg Brandl f725b9587c Doc patch #1730 from Robin Stocker; minor corrections mostly to os.rst. 2008-01-05 19:44:22 +00:00
Georg Brandl 9749e15e2f Remove with_statement future imports from 2.6 docs. 2008-01-05 19:28:16 +00:00
Jeffrey Yasskin 9871d8fe22 Continue rolling back pep-3141 changes that changed behavior from 2.5. This
round included:
 * Revert round to its 2.6 behavior (half away from 0).
 * Because round, floor, and ceil always return float again, it's no
   longer necessary to have them delegate to __xxx___, so I've ripped
   that out of their implementations and the Real ABC. This also helps
   in implementing types that work in both 2.6 and 3.0: you return int
   from the __xxx__ methods, and let it get enabled by the version
   upgrade.
 * Make pow(-1, .5) raise a ValueError again.
2008-01-05 08:47:13 +00:00
Raymond Hettinger 1b50fd7cb3 Add error-checking to namedtuple's _replace() method. 2008-01-05 02:17:24 +00:00
Raymond Hettinger 02740f73ff Improve namedtuple's _cast() method with a docstring, new name, and error-checking. 2008-01-05 01:35:43 +00:00
Andrew M. Kuchling 54966a5f94 Fix markup 2008-01-04 18:25:05 +00:00
Christian Heimes 04ae916fa2 Added interface to Windows' WSAIoctl and a simple example for a network sniffer. 2008-01-04 15:23:30 +00:00
Raymond Hettinger e0734e7dc0 Minor fix-ups to named tuples:
* Make the _replace() method respect subclassing.

* Using property() to make _fields read-only wasn't a good idea.
  It caused len(Point._fields) to fail.

* Add note to _cast() about length checking and alternative with the star-operator.
2008-01-04 03:22:53 +00:00
Andrew M. Kuchling 7ef1ce69d0 Markup fixes; grammar tweaks 2008-01-04 01:15:50 +00:00
Christian Heimes eebb79cc69 Added copysign(x, y) function to the math module 2008-01-03 22:32:26 +00:00
Christian Heimes e2ca4245c9 Added math.isinf() and math.isnan() 2008-01-03 20:23:15 +00:00
Jeffrey Yasskin 2f3c16be73 Backport PEP 3141 from the py3k branch to the trunk. This includes r50877 (just
the complex_pow part), r56649, r56652, r56715, r57296, r57302, r57359, r57361,
r57372, r57738, r57739, r58017, r58039, r58040, and r59390, and new
documentation. The only significant difference is that round(x) returns a float
to preserve backward-compatibility. See http://bugs.python.org/issue1689.
2008-01-03 02:21:52 +00:00
Raymond Hettinger 81a885af05 Improve docs for itertools.groupby(). The use of xrange(0) to create a unique object is less obvious than object(). 2007-12-29 22:16:24 +00:00
Raymond Hettinger 5d332bbdee Simpler documentation for itertools.tee(). Should be backported. 2007-12-29 22:09:34 +00:00
Georg Brandl b19be571e0 Some cleanup in the docs. 2007-12-29 10:57:00 +00:00
Guido van Rossum 02de8979cc Patch #1583 by Adam Olsen.
This adds signal.set_wakeup_fd(fd) which sets a file descriptor to
which a zero byte will be written whenever a C exception handler runs.

I added a simple C API as well, PySignal_SetWakeupFd(fd).
2007-12-19 19:41:06 +00:00
Raymond Hettinger 85dfcf3530 Users demand iterable input for named tuples. The author capitulates. 2007-12-18 23:51:15 +00:00
Christian Heimes 0a8143f646 Applied patch #1635: Float patch for inf and nan on Windows (and other platforms).
The patch unifies float("inf") and repr(float("inf")) on all platforms.
2007-12-18 23:22:54 +00:00
Raymond Hettinger 8777bcae27 Simplify and speedup _asdict() for named tuples. 2007-12-18 22:21:27 +00:00
Raymond Hettinger 88880b2dd6 Add more namedtuple() test cases. Neaten the code and comments. 2007-12-18 00:13:45 +00:00
Georg Brandl 1bd51e3eec Remove curious space-like characters. 2007-12-16 16:00:36 +00:00
Georg Brandl 6dfe956bfc Remove another unnecessary Unicode character. 2007-12-16 15:59:19 +00:00
Georg Brandl 459744cc71 Remove gratuitous unicode character. 2007-12-16 15:53:49 +00:00
Georg Brandl 05df69b2ea Remove orphaned footnote reference. 2007-12-16 15:47:46 +00:00
Raymond Hettinger e846f38c77 Add usage note 2007-12-14 21:51:50 +00:00
Raymond Hettinger 07ae83f840 Faster and simpler _replace() method 2007-12-14 19:19:59 +00:00
Raymond Hettinger 48eca67ab9 Add line spacing for readability 2007-12-14 18:08:20 +00:00
Raymond Hettinger 42da874cdd Cleaner method naming convention 2007-12-14 02:49:47 +00:00
Raymond Hettinger 04a9a0e904 Simplify implementation of __replace__() 2007-12-13 22:55:52 +00:00
Christian Heimes 7c7f6afa92 Added wide char api variants of getch and putch to msvcrt module. The wide char methods are required to fix #1578 in py3k. I figured out that they might be useful in 2.6, too. 2007-12-10 15:12:41 +00:00
Brett Cannon 338d41850a Use a versionchanged directive. 2007-12-09 05:09:37 +00:00
Skip Montanaro 546624609e correct email address 2007-12-08 15:26:16 +00:00
Georg Brandl e40a6a85ee Add examples to the datetime documentation. Written for GHOP by "h4wk.cz". 2007-12-08 11:23:13 +00:00
Raymond Hettinger ba9eea5aaa Don't have the docs berate themselves. Keep a professional tone.
If a todo is needed, put it in the tracker.
2007-12-07 01:53:01 +00:00
Georg Brandl d6b20dc54f Better re.split examples. 2007-12-06 09:45:39 +00:00
Georg Brandl 2b92f6bab3 Diverse markup fixes. 2007-12-06 01:52:24 +00:00
Georg Brandl b8df156ab5 Add examples to re docs. Written for GHOP by Dan Finnie. 2007-12-05 18:30:48 +00:00
Georg Brandl 722e1011c9 Add examples to csv, pprint and traceback docs.
Written by Ross for GHOP.
2007-12-05 17:56:50 +00:00
Georg Brandl c37f288ec6 Add tutorial and examples to logging docs, from GHOP student "oscar8thegrouch". 2007-12-04 17:46:27 +00:00
Georg Brandl 0a0cf16de9 Add examples to the xmlrpclib docs.
Written for GHOP by Josip Dzolonga.
2007-12-03 20:03:46 +00:00
Christian Heimes 44eeaec173 Patch #1537 from Chad Austin
Change GeneratorExit's base class from Exception to BaseException
(This time I'm applying the patch to the correct sandbox.)
2007-12-03 20:01:02 +00:00
Martin v. Löwis 6b449f4f2b Issue #1727780: Support loading pickles of random.Random objects created
on 32-bit systems on 64-bit systems, and vice versa. As a consequence
of the change, Random pickles created by Python 2.6 cannot be loaded
in Python 2.5.
2007-12-03 19:20:02 +00:00
Georg Brandl 584265b001 Add more entries to the glossary.
Written by Jeff Wheeler for GHOP.
2007-12-02 14:58:50 +00:00
Georg Brandl b15a8df519 Convert bdb.rst line endings to Unix style. 2007-12-02 14:37:29 +00:00
Georg Brandl fefcd4ec40 Add example to mmap docs.
Written for GHOP by Rafal Rawicki.
2007-12-02 14:34:34 +00:00
Georg Brandl 87983f24cf Add "Using Python on Windows" document, by Robert Lehmann.
Written for GHOP.
2007-12-01 23:12:45 +00:00
Georg Brandl 39bd059e42 Add examples to the ElementTree documentation.
Written by h4wk.cz for GHOP.
2007-12-01 22:42:46 +00:00
Christian Heimes 3e76d9346b Added one more missing versionadded tag 2007-12-01 15:40:22 +00:00
Christian Heimes dfdfaab1c5 Feature #1534
Added PyFloat_GetMax(), PyFloat_GetMin() and PyFloat_GetInfo() to the float API.
Added a dictionary sys.float_info with information about the internal floating point type to the sys module.
2007-12-01 11:20:10 +00:00
Georg Brandl 81ddc1a69b Move lchmod() docs to correct place, and add versionadded tags. 2007-11-30 22:04:45 +00:00
Christian Heimes 3628187b66 Fix for feature request #1528 Add os.fchmod
Georg Brandl has added fchmod() and fchown(). I've contributed lchown but I'm not able to test it on Linux. However it should be available on Mac and some other flavors of Unix.
I've made a quick test of fchmod() and fchown() on my system. They are working as expected.
2007-11-30 21:11:28 +00:00
Georg Brandl 82225b7737 Add more examples to the wsgiref docs.
From GHOP by Josip Dzolonga.
2007-11-29 23:00:03 +00:00
Georg Brandl 430e3620b6 Add examples to the ConfigParser documentation.
Credits go to Thomas Lamb, who wrote this as a task in the GHOP contest.
2007-11-29 17:02:34 +00:00
Georg Brandl 9d83daa03d Fix reference target. 2007-11-29 17:01:20 +00:00
Christian Heimes d7b333779a Added py3kwarning to the documentation of the sys module. 2007-11-28 08:02:36 +00:00
Christian Heimes 28104c58d2 Expose Py_Py3kWarningFlag as sys.py3kwarning as discussed in #1504
Also added a warning.warnpy3k() as convenient method for Python 3.x related deprecation warnings.
2007-11-27 23:16:44 +00:00
Martin v. Löwis c8dfd588c2 Bug #1494: Document that appendChild removes first. 2007-11-24 18:33:40 +00:00
Georg Brandl b67da6ed2b #1735632: add O_NOATIME constant to os module.
Also document a few other O_ constants that were missing from documentation.
2007-11-24 13:56:09 +00:00
Georg Brandl f8b6abd972 #1355: remove mention of PyXML from xml.dom docs. 2007-11-24 11:42:14 +00:00
Georg Brandl 586edab279 #1467: fix documentation for TestResult.add{Error,Failure}. 2007-11-24 11:39:13 +00:00
Georg Brandl 439f250c00 #1344: document that you need to open std{in,out,err} with PIPE if you want
communicate() to work as described.
2007-11-24 11:31:46 +00:00
Facundo Batista c0458830fb Fixed detail in add_type() explanation (issue 1463). 2007-11-19 16:30:24 +00:00
Raymond Hettinger 8465ae8cea Fix signature in example 2007-11-17 01:51:22 +00:00
Raymond Hettinger bc693491eb Add example for use cases requiring default values. 2007-11-15 22:39:34 +00:00
Raymond Hettinger 7c3738e11c Example of multiple replacements. 2007-11-15 03:16:09 +00:00
Raymond Hettinger 213ae014db Fixup example in docs. 2007-11-15 02:58:20 +00:00
Raymond Hettinger 5681cbce81 Small improvement to the implementation of __replace__(). 2007-11-15 02:55:42 +00:00
Raymond Hettinger eeeb9c4445 Accept Issac Morland's suggestion for __replace__ to allow multiple replacements
(suprisingly, this simplifies the signature, improves clarity, and is comparably fast).
Update the docs to reflect a previous change to the function name.
Add an example to the docs showing how to override the default __repr__ method.
2007-11-15 02:44:53 +00:00
Georg Brandl b5b6f3c46e Remove dead link from random docs. 2007-11-14 13:59:09 +00:00
Georg Brandl 07c19eaa20 Fix seealso link to sets docs. Do not merge to Py3k. 2007-11-09 12:31:43 +00:00
Raymond Hettinger 1760c8a017 Add set.isdisjoint() 2007-11-08 02:52:43 +00:00
Raymond Hettinger 12e94200c0 Fix marshal's incorrect handling of subclasses of builtin types (backport candidate). 2007-11-07 01:13:09 +00:00
Gregory P. Smith e1ac4f1930 Fixes Issue 1385: The hmac module now computes the correct hmac when using
hashes with a block size other than 64 bytes (such as sha384 and sha512).
2007-11-06 00:19:03 +00:00
Mark Summerfield 91f9429bc3 Clarified the fact that you can have comments for individual archive
members even though comments to the archive itself aren't currently
supported.
2007-11-05 14:38:50 +00:00
Mark Summerfield aea6e5913b Added cross-references between the various archive file formats. 2007-11-05 09:22:48 +00:00
Georg Brandl 9c466baa01 Fix syntax for versionchanged markup. 2007-11-04 17:43:49 +00:00
Skip Montanaro d469ff1e6a Note change to get_dialect semantics in 2.5. Will backport to 2.5. 2007-11-04 15:56:52 +00:00
Georg Brandl 7c3e79f67f Make "hashable" a glossary entry and clarify docs on __cmp__, __eq__ and __hash__.
I hope the concept of hashability is better understandable now.
Thanks to Tim Hatch for pointing out the flaws here.
2007-11-02 20:06:17 +00:00
Mark Summerfield ac3d429edc Added more file-handling related cross-references. 2007-11-02 08:24:59 +00:00
Georg Brandl 744b32a544 Fix markup glitch. 2007-11-01 20:37:02 +00:00
Georg Brandl 03b15c67ff #1364: os.lstat is available on Windows too, as an alias to os.stat. 2007-11-01 17:19:33 +00:00
Raymond Hettinger 405884cd62 Sets are marshalable. 2007-10-31 22:15:49 +00:00
Raymond Hettinger 84e26b6d5d Clarify the reasons why pickle is almost always better than marshal 2007-10-31 21:57:58 +00:00
Georg Brandl 1a94ec2664 Bug #1287: make os.environ.pop() work as expected. 2007-10-24 21:40:38 +00:00
Neal Norwitz 530042816c Bug #1313, fix typo (wrong variable name) in example. 2007-10-23 05:44:27 +00:00
Travis E. Oliphant 8feafab346 Add phuang patch from Issue 708374 which adds offset parameter to mmap module. 2007-10-23 02:40:56 +00:00
Georg Brandl a739503881 Add :term:s for "new-style class". 2007-10-21 12:15:05 +00:00
Georg Brandl e7a0990113 Add :term:s for iterator. 2007-10-21 12:10:28 +00:00
Georg Brandl cf3fb25932 Add :term: for generators. 2007-10-21 10:52:38 +00:00
Georg Brandl bb75e4e5d2 Unify "file-descriptor" to "file descriptor". 2007-10-21 10:46:24 +00:00
Georg Brandl 5e52db035d Add :term:s for descriptors. 2007-10-21 10:45:46 +00:00
Georg Brandl 5c174bbd84 Add markup to new function descriptions. 2007-10-21 10:32:54 +00:00
Georg Brandl 63fa168326 Unify "byte code" to "bytecode". Also sprinkle :term: markup for it. 2007-10-21 10:24:20 +00:00
Andrew M. Kuchling 529b1a91ce Fix protocol name 2007-10-20 19:25:37 +00:00
Georg Brandl ff27e0cd10 Fix code being interpreted as a target. 2007-10-20 13:22:53 +00:00
Georg Brandl a2ba6ea9aa #1284: "S" means "seen", not unread. 2007-10-19 17:38:49 +00:00
Mark Summerfield 0752d20a34 Added a cross-ref to each other. 2007-10-19 12:48:17 +00:00
Georg Brandl c4ed9713a7 Clarify wording for apply(). 2007-10-19 12:32:39 +00:00
Facundo Batista d97110dd1b Issue 1289, just a typo. 2007-10-18 03:44:48 +00:00
Brett Cannon 1f67a677d0 Remove ``:const:`` notation on None in parameter list. Since the markup is not
rendered for parameters it just showed up as ``:const:`None` `` in the output.
2007-10-16 23:24:06 +00:00