Commit Graph

10655 Commits

Author SHA1 Message Date
Georg Brandl f4ffae2b2a #7035: improve docs of the various <method>_errors() functions, and give them docstrings. 2009-10-22 15:42:32 +00:00
Georg Brandl 030d65811f Reorder __slots__ fine print and add a clarification. 2009-10-22 15:27:24 +00:00
Georg Brandl c5026f8a7b #7088: document new functions in signal as Unix-only. 2009-10-22 15:04:09 +00:00
Georg Brandl 2eee1d4df1 #6324: membership test tries iteration via __iter__. 2009-10-22 15:00:06 +00:00
Georg Brandl 6c14e587f5 Use "impl-detail" directive where applicable. 2009-10-22 11:48:10 +00:00
Georg Brandl 3954d21cc5 Fix stylesheet for multi-paragraph impl-details. 2009-10-22 11:36:50 +00:00
Georg Brandl f5f7c66a01 Allow short form with text as argument. 2009-10-22 11:28:23 +00:00
Georg Brandl d032912ac1 Document new directive. 2009-10-22 11:28:06 +00:00
Georg Brandl a054722778 Make it more robust. 2009-10-22 11:01:46 +00:00
Georg Brandl 08be2e2f35 Add a new directive marking up implementation details and start using it. 2009-10-22 08:05:04 +00:00
Georg Brandl 4ebf80734d Fix duplicate target. 2009-10-22 07:56:56 +00:00
Georg Brandl ceb32af23f Fix markup. 2009-10-22 07:56:02 +00:00
Georg Brandl 0968fd679b Fix punctuation. 2009-10-22 07:05:48 +00:00
Benjamin Peterson ff81cb812d rewrite to be nice to other implementations 2009-10-22 02:36:47 +00:00
Georg Brandl cf842ad418 #7170: fix explanation about non-weakrefable builtin types. 2009-10-21 07:15:59 +00:00
Benjamin Peterson eb7c377659 clarify buffer arg #7178 2009-10-20 21:55:17 +00:00
Benjamin Peterson e047d7953f use property api 2009-10-20 03:14:10 +00:00
Eric Smith c12781abcb Issue #7169: Document PyFloat_AsString and PyFloat_AsReprString, and note that they are unsafe and deprecated. 2009-10-19 14:38:14 +00:00
Georg Brandl 11abfe640f Fix missing word. 2009-10-18 07:58:12 +00:00
Senthil Kumaran 83f1ef681f Fix a typo. 2009-10-18 01:58:45 +00:00
Senthil Kumaran 45a505f7e7 Fix for Issue7155 - urllib do not document default use of system proxy configuration 2009-10-18 01:24:41 +00:00
Georg Brandl 9b4e5820cb #7116: str.join() takes an iterable. 2009-10-14 18:48:32 +00:00
Georg Brandl 647e9d2652 #7126: os.environ changes *do* take effect in subprocesses started with os.system(). 2009-10-14 15:57:46 +00:00
Georg Brandl 5ffa146fde Fix markup. 2009-10-13 18:10:59 +00:00
Andrew M. Kuchling 5c4e6ebbf5 Various link, textual, and markup fixes 2009-10-13 16:11:49 +00:00
Andrew M. Kuchling 7fe65a0a94 Link to PEP 2009-10-13 15:49:33 +00:00
Benjamin Peterson 526bec21d0 platform we don't care about 2009-10-12 01:26:07 +00:00
Georg Brandl a4314c2b21 Fix broken links found by "make linkcheck". scipy.org seems to be done right now, so I could not verify links going there. 2009-10-11 20:16:16 +00:00
Georg Brandl 6728c5a762 Add the Python FAQ lists to the documentation. Copied from sandbox/faq. Many thanks to AMK for the preparation work. 2009-10-11 18:31:23 +00:00
Vinay Sajip 1c77b7f84c Issue #7086: Added TCP support to SysLogHandler and tidied up some anachronisms in the code. 2009-10-10 20:32:36 +00:00
Mark Dickinson d5a713ec30 Issue #7051: Clarify behaviour of 'g' and 'G'-style formatting. 2009-10-08 20:02:25 +00:00
Andrew M. Kuchling 85ea4bf781 Remove two notes 2009-10-05 22:45:39 +00:00
Andrew M. Kuchling fa6a4271c1 Backport r73983: Document the thousands separator. 2009-10-05 22:42:56 +00:00
Andrew M. Kuchling b6f0128c63 Use standard comma punctuation; reword some sentences in the docs 2009-10-05 22:32:48 +00:00
Andrew M. Kuchling 400054e59e Reword sentence 2009-10-05 22:31:11 +00:00
Andrew M. Kuchling 5a9c40b21c Add various items 2009-10-05 22:30:22 +00:00
Andrew M. Kuchling 915b1206f2 Note side benefit of socket.create_connection() 2009-10-05 21:25:35 +00:00
Andrew M. Kuchling f6e3d7d585 Document 'skip' parameter to constructor 2009-10-05 21:25:03 +00:00
Andrew M. Kuchling f5852f59d9 Fix narkup 2009-10-05 21:24:35 +00:00
Andrew M. Kuchling 3fab04078d Wording fix 2009-10-05 21:24:20 +00:00
Mark Dickinson 530df33eac Issue #7028: Add note to hex() builtin docs pointing to float.hex(). 2009-10-03 10:14:34 +00:00
Tarek Ziadé 1b48671ef1 #6516 added owner/group support for tarfiles in Distutils 2009-10-02 23:49:48 +00:00
Georg Brandl f895cf5d33 #7031: Add TestCase.assertIsInstance and negated method. 2009-10-01 20:59:31 +00:00
Antoine Pitrou c9062ca308 Sync the 2.x `io` docs with py3k, with a small note as to the distinction
between bytes streams and text streams.
2009-10-01 17:08:03 +00:00
Gregory P. Smith 657024cd26 Mention issue6972 in extractall docs about overwriting things outside of
the supplied path.
2009-09-29 21:56:31 +00:00
Philip Jenvey 8b9020458a #5329: fix os.popen* regression from 2.5: don't execute commands as a sequence
through the shell. also document the correct subprocess replacement for this
case
patch from Jean-Paul Calderone and Jani Hakala
2009-09-29 19:10:15 +00:00
Raymond Hettinger 13305f681b Issue 7008: Better document str.title and show how to work around the apostrophe problem. 2009-09-29 18:53:24 +00:00
Mark Dickinson b93fff0a57 Issue #3366: Add gamma function to math module.
(lgamma, erf and erfc to follow).
2009-09-28 18:54:55 +00:00
Michael Foord 17565e5b7b Documentation improvement for load_tests protocol in unittest. Issue 6515. 2009-09-27 20:08:23 +00:00
Vinay Sajip 4780c9a0e0 Tidied up name of parameter in StreamHandler 2009-09-26 14:53:32 +00:00
Ezio Melotti 9aac2455ab #7000: document "sep" in capwords. Add a few tests 2009-09-26 11:20:53 +00:00
Benjamin Peterson afdbe3d661 comment out ugly xxx 2009-09-26 02:57:59 +00:00
Ezio Melotti 2fd3592e70 improved phrasing, markup and example 2009-09-23 21:36:39 +00:00
Benjamin Peterson ca66cb5ce0 fix typos/rephrase 2009-09-22 22:15:28 +00:00
Brett Cannon 2f75572f44 Fix a minor doc syntax typo. 2009-09-22 20:04:24 +00:00
Vinay Sajip f778bec8ed Fixed a typo, and added sections on optimization and using arbitrary objects as messages. 2009-09-22 17:23:41 +00:00
Georg Brandl ac87077b37 Fix encoding name. 2009-09-22 10:55:08 +00:00
Doug Hellmann 1d18b5b929 Fix markup for external links. 2009-09-20 20:44:13 +00:00
Ronald Oussoren 9f20d9d0ee Issue 6877: this patch makes it possible to link the readline extension
to the libedit emulation of the readline API on OSX 10.5 or later.

This also adds a minimal testsuite for readline to check that the
history manipuation functions have the same interface with both
C libraries.
2009-09-20 14:18:15 +00:00
Ezio Melotti 4b017bbac0 #6881 - fixed wrong return type; improved the formatting 2009-09-20 07:10:39 +00:00
Georg Brandl f4da666880 Fix references to threading.enumerate(). 2009-09-19 12:04:16 +00:00
Georg Brandl 592c58d356 #6946: fix duplicate index entries for datetime classes. 2009-09-19 10:42:34 +00:00
Georg Brandl 579a358e61 #6930: clarify description about byteorder handling in UTF decoder routines. 2009-09-18 21:35:59 +00:00
Georg Brandl 54967d994a #6925: rewrite docs for locals() and vars() a bit. 2009-09-18 21:21:41 +00:00
Benjamin Peterson 332d721750 add keyword arguments support to str/unicode encode and decode #6300 2009-09-18 21:14:55 +00:00
Georg Brandl 4d94d31b6d #6936: for interactive use, quit() is just fine. 2009-09-18 07:22:41 +00:00
Georg Brandl b926ebb896 Make the optparse doc style a bit more standard: use standard description units for attrs/methods/etc., and use the correct referencing roles. 2009-09-17 17:14:04 +00:00
Georg Brandl 7842a41f5c Remove duplicate doc of enable/disable_interspersed_args. 2009-09-17 16:26:06 +00:00
Georg Brandl 304d3966ee #6932: remove paragraph that advises relying on __del__ being called. 2009-09-17 16:15:53 +00:00
Georg Brandl bc3777d85e String values should be shown with quotes, to avoid confusion with constants. 2009-09-17 10:23:02 +00:00
Benjamin Peterson 6fedc5252d rationalize a bit 2009-09-17 03:27:33 +00:00
Brett Cannon 2348eda37b Note in the intro to Extending... that ctypes can be a simpler, more portable solution than custom C code. 2009-09-17 03:24:45 +00:00
Benjamin Peterson fd1fcffced pep 8 defaults 2009-09-17 03:18:28 +00:00
Thomas Wouters c4dcb3801e Fix issue #1590864, multiple threads and fork() can cause deadlocks, by
acquiring the import lock around fork() calls. This prevents other threads
from having that lock while the fork happens, and is the recommended way of
dealing with such issues. There are two other locks we care about, the GIL
and the Thread Local Storage lock. The GIL is obviously held when calling
Python functions like os.fork(), and the TLS lock is explicitly reallocated
instead, while also deleting now-orphaned TLS data.

This only fixes calls to os.fork(), not extension modules or embedding
programs calling C's fork() directly. Solving that requires a new set of API
functions, and possibly a rewrite of the Python/thread_*.c mess. Add a
warning explaining the problem to the documentation in the mean time.

This also changes behaviour a little on AIX. Before, AIX (but only AIX) was
getting the import lock reallocated, seemingly to avoid this very same
problem. This is not the right approach, because the import lock is a
re-entrant one, and reallocating would do the wrong thing when forking while
holding the import lock.

Will backport to 2.6, minus the tiny AIX behaviour change.
2009-09-16 19:55:54 +00:00
Georg Brandl a50d20a5b1 Rewrap long lines. 2009-09-16 15:57:46 +00:00
Ezio Melotti 2e85f503b1 #6879 - fix misstatement about exceptions 2009-09-16 13:14:05 +00:00
Georg Brandl 718b221e06 #6892: fix optparse example involving help option. 2009-09-16 13:11:06 +00:00
Georg Brandl d7226ffe0b Remove strange trailing commas. 2009-09-16 13:06:22 +00:00
Georg Brandl f4e6b98b01 #5621: refactor description of how class/instance attributes interact on a.x=a.x+1 or augassign. 2009-09-16 10:12:06 +00:00
Georg Brandl 83130c3942 #6891: comment out dead link to Unicode article. 2009-09-16 09:30:48 +00:00
Georg Brandl b29709adc8 #6876: fix base class constructor invocation in example. 2009-09-16 09:24:57 +00:00
Georg Brandl 49bb9b7f0a #6880: add reference to classes section in exceptions section, which comes earlier. 2009-09-16 09:23:04 +00:00
Georg Brandl 076ca5a430 Make deprecation notices as visible as warnings are right now. 2009-09-16 09:05:11 +00:00
Ronald Oussoren 5d90029041 Finish support for --with-universal-archs=intel
and --with-universal-archs=3-way (issue6245)
2009-09-15 19:13:15 +00:00
Ezio Melotti 038f38d3ac #6917 - typo in method name 2009-09-15 18:41:43 +00:00
Benjamin Peterson ea7120c7c1 Py_SetPythonHome uses static storage #6913 2009-09-15 03:36:26 +00:00
Georg Brandl 58d23fbb6c #6908: fix association of hashlib hash attributes. 2009-09-14 14:50:47 +00:00
Georg Brandl 7eb43b7c70 #6574: list the future features in a table. 2009-09-14 14:08:54 +00:00
Ezio Melotti 2c7b4934ad #6904 - fix broken link 2009-09-14 00:48:31 +00:00
Michael Foord dc0460a309 Remove an extraneous space in unittest documentation. 2009-09-13 19:08:18 +00:00
Michael Foord e91ea56b30 Test discovery in unittest will only attempt to import modules that are importable; i.e. their names are valid Python identifiers. If an import fails during discovery this will be recorded as an error and test discovery will continue. Issue 6568. 2009-09-13 19:07:03 +00:00
Georg Brandl 6848d82a7c Typo fix. 2009-09-13 18:15:07 +00:00
Michael Foord 5a9719d627 unittest.TestLoader.loadTestsFromName honors the loader suiteClass attribute. Issue 6866. 2009-09-13 17:28:35 +00:00
Michael Foord ee2df03009 Tutorial tweaks. Issue 6849. 2009-09-13 17:07:46 +00:00
Michael Foord 668be589ef Note that sys._getframe is not guaranteed to exist in all implementations of Python, and a corresponding note in inspect.currentframe. Issue 6712. 2009-09-13 16:46:19 +00:00
Michael Foord c3f79373e8 Objects that compare equal automatically pass or fail assertAlmostEqual and assertNotAlmostEqual tests on unittest.TestCase. Issue 6567. 2009-09-13 16:40:02 +00:00
Michael Foord 60931a5a58 Change to tutorial wording for reading text / binary files on Windows. Issue #6301. 2009-09-13 16:13:36 +00:00
Lars Gustäbel 21121e64b4 Issue #6856: Add a filter keyword argument to TarFile.add().
The filter argument must be a function that takes a TarInfo
object argument, changes it and returns it again. If the
function returns None the TarInfo object will be excluded
from the archive.
The exclude argument is deprecated from now on, because it
does something similar but is not as flexible.
2009-09-12 10:28:15 +00:00
Georg Brandl d4c7eb1647 Move function back to its section. 2009-09-11 07:55:20 +00:00
Georg Brandl ffdde9e959 Properly document copy and deepcopy as functions. 2009-09-09 16:49:13 +00:00
Georg Brandl f01697014f #6843: add link from filterwarnings to where the meaning of the arguments is covered. 2009-09-05 16:47:17 +00:00
Georg Brandl 609910c210 #6841: remove duplicated word. 2009-09-05 09:04:09 +00:00
Georg Brandl 7d4f8fda49 #6777: dont discourage usage of Exception.args or promote usage of Exception.message. 2009-09-04 11:32:18 +00:00
Georg Brandl 601ee7f847 #6756: add some info about the "acct" parameter. 2009-09-04 11:25:37 +00:00
Georg Brandl af795e5eea #6757: complete the list of types that marshal can serialize. 2009-09-03 12:31:39 +00:00
Georg Brandl bf58d80123 #6828: fix wrongly highlighted blocks. 2009-09-03 07:27:26 +00:00
Georg Brandl eb4781c279 #6821: fix signature of PyBuffer_Release(). 2009-09-02 20:37:16 +00:00
Georg Brandl 8514b85edc #6638: fix wrong parameter name and markup a class. 2009-09-01 08:06:03 +00:00
Georg Brandl 86158fc4c7 #6810: add a link to the section about frame objects instead of just a description where to find it. 2009-09-01 08:00:47 +00:00
Georg Brandl 018ad1c949 #6765: hint that log(x, base) is not very sophisticated. 2009-09-01 07:53:37 +00:00
Georg Brandl a88fd7603b #6808: clarification. 2009-09-01 07:46:26 +00:00
Georg Brandl 254c17c758 #6813: better documentation for numberless string formats. 2009-09-01 07:40:54 +00:00
Senthil Kumaran 90161375c6 Doc fix for the issue2637. 2009-08-31 16:40:27 +00:00
Georg Brandl 4ea46a6614 other -> others where multiple arguments are accepted. 2009-08-31 06:38:29 +00:00
Georg Brandl 7d65fbfed4 #6801: fix copy-paste oversight. 2009-08-30 11:51:53 +00:00
Georg Brandl 6f8b99e868 #6803: fix old name. 2009-08-30 08:35:01 +00:00
Tarek Ziadé 3092ed977f fixed #6801: symmetric_difference_update also accepts pipe 2009-08-29 13:33:21 +00:00
Kristján Valur Jónsson e2a77980b6 issue 6275
Add an "exc_value" attribute to the _AssertRaisesContext context manager in the unittest package.  This allows further tests on the exception that was raised after the context manager exits.
2009-08-27 22:20:21 +00:00
Georg Brandl e746daa2cb #6787: reference fix. 2009-08-27 19:02:43 +00:00
Georg Brandl 185bd22564 Typo fix. 2009-08-27 18:59:02 +00:00
R. David Murray e7ba742efa Remove leftover text from end of sentence. 2009-08-27 01:04:59 +00:00
Georg Brandl 1b2695a4c2 #6677: note that rmdir only removes empty directories. 2009-08-24 17:48:40 +00:00
Benjamin Peterson 626c0aabe8 fix pdf building by teaching latex the right encoding package 2009-08-24 17:42:36 +00:00
Georg Brandl 7543997d74 #6677: mention "deleting" as an alias for removing files. 2009-08-24 17:24:27 +00:00
Georg Brandl e8ddbece0f #6718: fix example. 2009-08-24 17:22:05 +00:00
Georg Brandl 0cfbd65975 #6725: spell "namespace" consistently. 2009-08-24 17:20:40 +00:00
Georg Brandl 87296628f1 #6772: mention utf-8 as utf8 alias. 2009-08-24 17:14:29 +00:00
Tarek Ziadé f721666d33 Fixed #6556: Corrected doc on how Distutils looks for its user configuration file under Windows 2009-08-21 14:11:26 +00:00
Vinay Sajip 333c6e7d8f Added section on exceptions raised during logging. 2009-08-20 22:04:32 +00:00
Tarek Ziadé 764fc235a6 #6693: New functions in site.py to get user/global site packages paths. 2009-08-20 21:23:13 +00:00
Gregory P. Smith 4e63d54b36 Add weakref support to the thread.lock type. 2009-08-20 09:39:38 +00:00
Skip Montanaro 56366cc6eb missing module ref (issue6723) 2009-08-18 14:37:52 +00:00
R. David Murray 2c9e33f3a6 Issue 6685: 'toupper' -> 'upper' in cgi doc example explanation. 2009-08-17 19:26:49 +00:00
Vinay Sajip 5e7f645c16 Further refined section on logging to one file from multiple processes. 2009-08-17 13:14:37 +00:00
Vinay Sajip 1c0b24fb67 Refined section on logging to one file from multiple processes. 2009-08-15 23:34:47 +00:00
Vinay Sajip 3a0dc30947 Added section on logging to one file from multiple processes. 2009-08-15 23:23:12 +00:00
Vinay Sajip 59584c4bac Added versionchanged notices for optional 'delay' parameter to file handler classes. 2009-08-14 11:33:54 +00:00
Georg Brandl aa66a968d4 Remove potentially confusing sentence in __mangling description. 2009-08-13 12:57:25 +00:00
Georg Brandl fb69631af7 Use locale.format_string() for more than one specifier. 2009-08-13 12:05:52 +00:00
Georg Brandl 04fd324fe3 #6679: Remove mention that sub supports no flags. 2009-08-13 07:48:05 +00:00
Georg Brandl 4a46e1c4b3 #6658: fix two typos. 2009-08-06 17:43:55 +00:00
Georg Brandl 43161a51b8 Fix punctuation and one copy-paste error. 2009-08-06 17:23:21 +00:00
Georg Brandl 29bc2cd463 Fix base keyword arg name for int() and long(). 2009-08-06 15:06:25 +00:00
Jesse Noller 8497efeb40 Fix issue 4660: spurious task_done errors in multiprocessing, remove doc note for from_address 2009-08-06 02:05:56 +00:00
Georg Brandl 4809c737d3 Add donation link to docs footer. 2009-08-04 20:22:43 +00:00
Mark Dickinson 4326ad8f72 Issue #6595: Allow Decimal constructor to accept non-European decimal
digits, as recommended by the specification.  (Backport of r74279 from
py3k.)
2009-08-02 10:59:36 +00:00
Mark Dickinson 9ad0b365b3 Documentation fix for change introduced in r71832 2009-07-30 10:00:10 +00:00
Georg Brandl 4938fefce8 Rewrite the section about classes a bit; mostly tidbits, and a larger update to the section about "private" variables to reflect the Pythonic consensus better. 2009-07-29 17:50:25 +00:00
Georg Brandl 14bb28aa62 Fix a few markup glitches. 2009-07-29 17:15:20 +00:00
Georg Brandl ffefd5a8bb Fix some markup and small factual glitches found by M. Markert. 2009-07-29 17:07:21 +00:00