Commit Graph

2761 Commits

Author SHA1 Message Date
Andrew Svetlov 41c25ba451 Issue #14570: Document json sort_keys parameter properly.
Patch by Chris Rebert.
2012-10-28 14:58:52 +02:00
Andrew Svetlov 61822667df Issue #14616: Document pipes.quote and mention this one in subprocess docs.
Patch by Chris Rebert.
2012-10-28 11:48:02 +02:00
Ezio Melotti e793f44abe #16332: use "except OSError as e" in subprocess docs. Patch by Berker Peksag. 2012-10-26 23:10:07 +03:00
Ezio Melotti 8221f86513 #16206: Improve examples about dict construction. 2012-10-26 19:14:16 +03:00
Ezio Melotti b8fbff889f #16210: combine the two type() docs. Patch by Pete Sevander. 2012-10-24 23:01:30 +03:00
Ned Deily c859bd2b28 Issue #10405: Document IDLE context menus in Standard Library document
and IDLE Help file.  (Thanks to Nick ODell and Todd Rovito for suggestions.)
Update Debug menu options in docs to match current code plus various other
minor IDLE doc and help edits.
2012-10-20 13:23:25 -07:00
Andrew Svetlov ae1d185750 Issue #15936: Reformat text for os.random to follow Larry Hastings suggestion 2012-10-16 13:51:26 +03:00
Andrew Svetlov 8a9d370a2b Issue #15936: Add link from os.urandom to random.SystemRandom 2012-10-16 13:23:15 +03:00
Chris Jerdonek def5df6c53 Issue #16206: Backport dict documentation improvements from 3.2.
Improve the documentation of the dict constructor.  This change includes
replacing the single-line signature documentation with a more complete
multiple-line signature.
2012-10-13 03:49:30 -07:00
Chris Jerdonek 2aa5afab4e Issue #16199: Backport 2to3 typo fix from 3.2. 2012-10-11 16:15:46 -07:00
Chris Jerdonek 1e65159b34 Backport from 3.2: Fix placement of shell=True warning in subprocess.Popen() docs. 2012-10-10 22:58:57 -07:00
Chris Jerdonek 2a6672b100 Issue #16115: Backport subprocess.Popen() documentation improvements from 3.2. 2012-10-10 17:55:41 -07:00
Chris Jerdonek cfb01a5ad0 Issue #12947: Backport doctest documentation change from 3.3. 2012-10-10 08:39:34 -07:00
Georg Brandl a11c1fcd20 Missed one instance of code-block:: text highlighting to revert. 2012-10-10 16:56:15 +02:00
Georg Brandl 7495456ffc Issue #12947: revert earlier workaround and use a monkey-patch to enable showing doctest directives only in the doctest docs. 2012-10-10 16:45:11 +02:00
Chris Jerdonek d469c400ed Issue #12947: Backport doctest documentation improvements from 3.3. 2012-10-10 07:13:56 -07:00
Chris Jerdonek 1906c0c992 Issue #16115: Backport subprocess.Popen() documentation improvements from 3.2. 2012-10-08 23:18:17 -07:00
Chris Jerdonek ad4b000179 Issue #14783: Backport changes from 3.2. 2012-10-07 20:37:54 -07:00
R David Murray fefd3ac04c #9957: document that SpooledTemporaryFile.truncate does not take size arg 2012-10-06 18:26:40 -04:00
Andrew Svetlov 8c4419304d Issue #16025: Minor corrections to the zipfile documentation.
Patch by Serhiy Storchaka.
2012-10-06 18:01:05 +03:00
Nick Coghlan 7c0a87f211 Issue #12947: Better workaround for the problem with doctest directives being stripped from code examples that are intended to illustrate those directives 2012-10-03 13:48:17 +05:30
Nick Coghlan a42709e6bb Issue #12947: Add a note to doctest until the example rendering is fixed 2012-10-03 12:18:23 +05:30
Ezio Melotti 31a9e83d7d #15979: improve timeit documentation. 2012-10-02 05:34:38 +03:00
Chris Jerdonek 71d74b0c4e Close #16036: Backport 3.x documentation improvement.
See changeset 6ccb04c4cbae for the corresponding 3.3 change.
2012-09-30 21:07:56 -07:00
R David Murray 95d7cdfd7b Fix sqlite3 class markup. 2012-09-30 21:04:46 -04:00
Chris Jerdonek fab57ccd13 Close issue #16077: fix code example in documentation of reduce() built-in (from docs@). 2012-09-29 11:51:37 -07:00
R David Murray 3e09b14026 #16085: Don't promote shadowing builtins in the configparser example. 2012-09-29 14:44:16 -04:00
R David Murray 9faaf1b43e #16071: fix email.message links in the mailbox docs. 2012-09-28 15:21:32 -04:00
Andrew Svetlov 0c68c5ddb2 Update docs for string.zfill 2012-09-28 16:32:27 +03:00
Andrew Svetlov 9ac20231e0 Update documentation for string.replace. Thanks to docs@ 2012-09-28 16:31:06 +03:00
Raymond Hettinger 1b43274d12 Show how to close a connection 2012-09-25 19:57:50 -04:00
Barry Warsaw 0dea936e78 - Issue #15935: Clarification of argparse docs, re: add_argument() type and
default arguments.  Patch contributed by Chris Jerdonek.
2012-09-25 10:32:53 -04:00
Mark Dickinson 39e0fb01ef Issue 15985: fix round argument names in documentation. Thanks Chris Jerdonek. 2012-09-20 20:57:37 +01:00
Ezio Melotti a8e49638d1 Fix a few quotes/backslashes. 2012-09-20 09:48:07 +03:00
Ezio Melotti aea83f53ee Fix rst markup in timeit docs. 2012-09-20 06:02:50 +03:00
Ezio Melotti b3b32fbd69 #11643: fix rst markup error in site.rst. 2012-09-17 08:59:36 +02:00
Ezio Melotti eab4df5830 #15789: mention shell-like parts of the stdlib in the subprocess docs. Patch by Chris Rebert. 2012-09-15 08:33:12 +03:00
Ezio Melotti a733d814be #15932: use with statement in csv doc examples. 2012-09-15 05:46:24 +03:00
Ezio Melotti 714e64ebd1 #15831: avoid using 3.x syntax for keyword-only args. 2012-09-15 04:45:57 +03:00
Ezio Melotti ed3f5900d4 #15831: document multiple signatures on different lines. Patch by Chris Jerdonek. 2012-09-14 06:48:32 +03:00
R David Murray 8d580539f0 #14649: clarify DocTestSuite error when there are no docstrings.
Also adds tests to verify the documented behavior (which is probably a bug, as
indicated in the added comments).

Patch by Chris Jerdonek.
2012-09-10 10:17:13 -04:00
R David Murray b9495c78a1 closes #5088: document behavior of optparse defaults with 'append' action. 2012-09-08 16:47:24 -04:00
R David Murray 1b6e7c47f2 #15510: clarify textwrap's handling of whitespace, and add confirming tests.
Patch by Chris Jerdonek.
2012-09-08 13:42:01 -04:00
Petri Lehtinen f9e1f1128b #13769: Enhance docs for ensure_ascii semantics in JSON decoding functions 2012-09-01 07:29:06 +03:00
Andrew Svetlov 2b326e4c2b Issue #15825: fix typo in OrderedDict docs.
Patch by Mike Hoy.
2012-08-31 13:53:30 +03:00
Ezio Melotti 6bb9c73b06 Add missing comma. 2012-08-29 17:50:42 +03:00
Vinay Sajip 3d212e6ee5 Closes #15807: Removed incorrect directive from help. 2012-08-29 14:25:42 +01:00
Hynek Schlawack 7d978902d0 #14880: Fix kwargs notation in csv.reader, .writer & .register_dialect
Patch by Chris Rebert.
2012-08-28 12:33:46 +02:00
Ezio Melotti 8662c84ac8 #15788: fix broken links in subprocess doc. Patch by Chris Rebert. 2012-08-27 10:00:05 +03:00
Antoine Pitrou 85ede8da00 Add glossary references 2012-08-24 19:49:08 +02:00
Antoine Pitrou f3e0a69d88 Issue #14674: Add a discussion of the json module's standard compliance.
Patch by Chris Rebert.
2012-08-24 19:46:17 +02:00
Georg Brandl e565cf805d Remove patch artifacts. 2012-08-21 19:44:00 +02:00
R David Murray 07f6ea5506 #15742: clarify sqlite parameter substitution example. 2012-08-20 14:17:22 -04:00
R David Murray d928b6a965 #13579: minimize code base drift for 'a' string.Formatter change.
2.7 doesn't support 'a'.  This changeset ports the doc change
and clause-reording portions of Francisco Martín Brugué patch
in order to minimize code base drift.
2012-08-19 17:57:29 -04:00
Eli Bendersky 6ee2187cdc Issue #15586: porting ET's new documentation bits to 2.7. Patch by Daniel Ellis 2012-08-18 05:40:38 +03:00
Terry Jan Reedy 73b19d0b00 Issue 15660: Clarify 0 prefix for width field in str.format doc. 2012-08-17 15:37:52 -04:00
Richard Oudkerk 3c3ab22d36 Issue #15412: Remove erroneous note about weakrefs 2012-08-17 15:00:58 +01:00
R David Murray c7b8f809e7 #15543: reflow paragraphs. 2012-08-15 11:22:58 -04:00
R David Murray 5618aaaafe #15543: glossary entry for and 'universal newlines', and links to it.
Patch by Chris Jerdonek.
2012-08-15 11:15:39 -04:00
R David Murray becfcc0a6b #15269: document dircmp.left and right.
Based on patch by Chris Jerdonek.
2012-08-14 21:50:38 -04:00
Andrew Svetlov 33f87a59b8 Issue #15497: Correct characters in TextWrapper.replace_whitespace docs.
Patch by Chris Jerdonek.
2012-08-13 23:26:28 +03:00
Sandro Tosi 614e44a0fa complete cgi.parse() signature; thanks to Aaron Bingham from docs@ 2012-08-12 18:47:45 +02:00
Sandro Tosi eca4006b1f add usage example from cli; thanks to Christian Clauss from docs@ 2012-08-12 17:33:41 +02:00
Sandro Tosi 106c25034a it's getstatus() not setstatus(); thanks to Shaddi Hasan from docs@ 2012-08-12 15:11:58 +02:00
Sandro Tosi 018e14dfe9 add missing quote in splitlines() example; thanks to Yevgen Yampolskiy from docs@ 2012-08-12 12:34:57 +02:00
Sandro Tosi 682100e46a add missing parenthesis to 'action' argparse doc; thanks to kishkin from docs@ 2012-08-12 10:49:07 +02:00
Andrew Svetlov 8afcec41f4 Issue #15501: Document exception classes in subprocess module.
Initial patch by Anton Barkovsky.
2012-08-09 15:23:49 +03:00
Benjamin Peterson 359b5032f6 make documented file() kw names and actual ones agree (closes #15572)
Patch by Daniel Ellis.
2012-08-07 11:57:47 -07:00
R David Murray decdb74227 #15554: clarify splitlines/split differences.
Patch by Chris Jerdonek.
2012-08-06 16:09:09 -04:00
Antoine Pitrou 76370f4977 Make TextIOWrapper's documentation clearer by copying the newline argument's description from open(). 2012-08-04 00:55:38 +02:00
Andrew Svetlov 15fc22011d Issue #15041: Update "see also" list in tkinter documentation. 2012-07-26 17:19:40 +03:00
Antoine Pitrou b37f14c70e Mention the *limit* argument of TextIO.readline(). 2012-07-25 22:38:33 +02:00
Vinay Sajip 34e992d451 Issue #15445: Updated logging configuration documentation to highlight potential security risk posed by listen() in certain scenarios. 2012-07-25 19:12:35 +01:00
Senthil Kumaran 0c472c3271 Issue #15250: Document that filecmp.dircmp compares files shallowly. Patch contributed by Chris Jerdonek. 2012-07-22 19:36:03 -07:00
Vinay Sajip bee739baa7 Issue #15399: Added versionchanged for processName. 2012-07-20 09:48:46 +01:00
R David Murray 59488d233b Closes #9254: backport __import__ docstring/doc mentions of importlib.
Patch by Éric Araujo.
2012-07-18 19:44:08 -04:00
R David Murray fc095202af #15375: remove duplicated word 'child' 2012-07-16 22:31:32 -04:00
Terry Jan Reedy 45ed012433 Issue #13557: Clarify effect of giving two different namespaces to exec or
execfile().
2012-07-08 17:35:26 -04:00
Georg Brandl 5356af8c48 Fix leftover quote. 2012-07-06 21:36:48 +02:00
Éric Araujo 9e06e37be0 Branch merge 2012-07-03 01:13:40 -04:00
Raymond Hettinger e16c882584 Make it easier to search for the grouper() recipe. 2012-07-02 21:08:45 -07:00
Éric Araujo 96534689a8 Use source role to get links to files 2012-07-02 17:46:56 -04:00
Éric Araujo 06176a89ff Adapt mentions of future changes in doc 2012-07-02 17:46:40 -04:00
Raymond Hettinger 2aa8519f07 The StopIteration API applies to both tokenize() and generate_tokens() 2012-07-01 20:00:09 -07:00
Georg Brandl e683ef55fc Make call of os.getppid() conditional: it is not available on Windows. 2012-07-01 09:47:54 +02:00
Georg Brandl 1014686d76 Remove an unneeded footnote. 2012-07-01 09:40:16 +02:00
Senthil Kumaran 9d5d507322 urlparse docs clean up 2012-06-28 21:07:32 -07:00
Antoine Pitrou d9a5137742 Issue #5067: improve some json error messages.
Patch by Serhiy Storchaka.
2012-06-29 01:58:26 +02:00
Senthil Kumaran 189bd91255 issue13666 - Fixing datetime documentation example when using tzinfo 2012-06-26 20:05:12 +08:00
Sandro Tosi 771d98d694 Issue #15060: better fix, thanks to review on #python-dev 2012-06-14 00:36:54 +02:00
Sandro Tosi 89539e8268 Issue #15060: fix typo in socket doc; Patch by anatoly techtonik 2012-06-13 23:58:35 +02:00
Raymond Hettinger 491f7070f1 Code cleanups 2012-06-08 13:24:12 -07:00
Sandro Tosi 5fae78c09d refer to time.strftime 2012-06-02 18:21:06 +02:00
R David Murray de738a1b82 #14957: fix doc typo. 2012-06-02 11:21:31 -04:00
R David Murray 4fbf7c61fe #14957: clarify splitlines docs.
Initial patch by Michael Driscoll, I added the example.
2012-06-01 16:21:06 -04:00
R David Murray b42b6eba63 #11785: fix the :mod: references in email package submodule titles. 2012-05-27 17:13:54 -04:00
Hynek Schlawack d68ffdb45a Restore [] where default arguments are not keywords
Reverts some changes of a36666c52115.

In the case of os's `mknod(filename[, mode=0600[, device=0]])`, I have nested
the [] as setting mode doesn't require to set device (but setting device
requires to set mode).
2012-05-22 15:22:14 +02:00
Hynek Schlawack e58ce01f30 #14804: Remove [] around optional arguments with default values
Mostly just mechanical removal of []. In some rare cases I've pulled the
default value up into the argument list.
2012-05-22 10:27:40 +02:00
Vinay Sajip 5f045ea440 Fixes #14864: Added documentation on how to undo the effects of a logging.disable() call. 2012-05-20 15:35:00 +01:00
Hynek Schlawack 897b278cf0 Document when json.load's parse_constant behaviour changed
It doesn't get called on 'null', 'true', 'false' since f686aced02a3.
2012-05-20 11:50:41 +02:00