Commit Graph

12555 Commits

Author SHA1 Message Date
Andrew Svetlov 2c184c6d75 Reword set docs to use *proper subset/superset* terminology. 2012-11-01 21:47:05 +02:00
Andrew Svetlov 8a9b401a7d Issue #14900: document added sort keys for profile stats. 2012-10-31 21:54:45 +02:00
Mark Dickinson 89e8f54045 Issue #16348: Fix incorrect documentation for Decimal.remainder_near. 2012-10-31 19:44:09 +00:00
R David Murray c454fe4509 #16371: fix up the English. 2012-10-31 10:53:13 -04:00
Andrew Svetlov 6e96e5e966 Issue #16370: Mention Py_SetProgramName in example for very high level embedding. 2012-10-31 16:01:09 +02:00
Andrew Svetlov 1625d88709 Issue #16341: convert examples to use except ... as ... syntax. 2012-10-30 21:56:43 +02:00
Chris Jerdonek 64c0b2ca3d Backport from 3.2: remove "Release" and "Date" markers from index pages. 2012-10-28 11:16:36 -07:00
Andrew Svetlov 41c25ba451 Issue #14570: Document json sort_keys parameter properly.
Patch by Chris Rebert.
2012-10-28 14:58:52 +02:00
Georg Brandl f4712d4a82 Remove confusing "Release" and "Date" markers from whatsnews. 2012-10-28 13:35:56 +01: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
Georg Brandl 0685e14645 Update current version of the "dailybuild" script. 2012-10-28 10:12:47 +01:00
Georg Brandl b70290a7d4 Update current version of the "dailybuild" script. 2012-10-28 08:18:52 +01:00
Georg Brandl 5fb657dfab Add a autobuild-quick target that only rebuilds HTML. 2012-10-28 08:09:02 +01:00
Georg Brandl 819574a226 merge with 2.6 2012-10-28 08:06:11 +01:00
Georg Brandl 55f23c4233 #8040: port versionswitcher patch to 2.6. 2012-10-28 08:04:38 +01:00
Ezio Melotti fd3d102af8 #8040: fix the version. 2012-10-27 23:12:48 +03:00
Ezio Melotti 8645890f8b #8040: enable the versionswitcher for the autobuild-dev target. 2012-10-27 22:28:48 +03:00
Ezio Melotti 3d072066c7 #8040: add a version switcher to the documentation. Patch by Yury Selivanov. 2012-10-27 22:04:56 +03: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
Chris Jerdonek 32473e73f4 Backport from 3.2: fix formatting of syntax description of function definition. 2012-10-25 17:26:10 -07:00
Ezio Melotti b8fbff889f #16210: combine the two type() docs. Patch by Pete Sevander. 2012-10-24 23:01:30 +03:00
Jesus Cea 3dd8cbea9b Closes #16294: 8 space indent in tutorial 2012-10-22 13:14:20 +02: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 f892597eb5 Issue #9583: Document startup option/environment interaction.
Patch by Todd Rovito.
2012-10-17 17:14:28 +03: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 0cffd6be56 Issue #16225: Backport from 3.2: Add additional note to tutorial about looping. 2012-10-15 20:01:38 -07:00
Chris Jerdonek d7d9a44226 Issue #16227: Add to 2.x Unicode HOWTO a link to the Python 3 version. 2012-10-15 17:12:17 -07: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
Raymond Hettinger d9edd82b7f String exceptions aren't just deprecated, they are gone. 2012-10-12 19:44:35 -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
Senthil Kumaran 7c06801638 Fix Issue 15922: make howto/urllib2.rst doctests pass.
Patch by Chris Jerdonek. Address Ezio's review comment.
2012-10-09 01:03:35 -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
Georg Brandl 2fbe856dc6 Commit current version of the doc "dailybuild" script. 2012-09-30 09:03:09 +02:00
Georg Brandl e8b2b67950 Doc sidebar: point to 3.4 as dev. 2012-09-30 08:59:31 +02: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
Jesus Cea 9662b84913 Closes #15953: Incorrect some fields declaration in the PyTypeObject documentation 2012-09-28 16:33:38 +02: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
Chris Jerdonek 3dec449a7c Issue #16015: Fix NameError doctest example in tutorial introduction. 2012-09-24 19:33:32 -07:00
Mark Dickinson 5a53a41bbc Issue #14167: restore statement about breaks in finally clauses; remove statement about exception chaining. 2012-09-24 20:25:24 +01:00
Ezio Melotti 9c1c52b777 #16019, #16020: fix syntax highlight. 2012-09-24 17:30:39 +03:00
Ezio Melotti 4baf480088 #16017: capitalize URLs. 2012-09-24 17:06:11 +03:00
Ezio Melotti fe11e81136 #16014: fix broken link. 2012-09-24 16:56:59 +03: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 0b6f255e4b #15920: fix doctests in Doc/howto/regex.rst. Patch by Chris Jerdonek. 2012-09-17 05:36:56 +03: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
Ezio Melotti 7d85760c02 #15437, #15439: merge Doc/ACKS.txt with Misc/ACKS and modify Doc/about.rst accordingly. 2012-09-14 01:58:33 +03:00
Senthil Kumaran 769798363d Fix issue #15899 - howto/unicode.rst doctest corrections for 2.7 branch. 2012-09-11 22:14:23 -07: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 2cc49745a5 Fix typo in tutorial 2012-08-18 09:51:37 +03: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
R David Murray 85307b46d1 #15355: Mention already-executing Exception in generator docs.
Patch by Chris Jerdonek.
2012-08-17 20:49:51 -04: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
Sandro Tosi 4ffe9a0640 clarify in/not in in case of infinite iterators; thanks to Sergey Skovorodkin from docs@ 2012-08-15 21:37:19 +02: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
Sandro Tosi 6ce21a3b84 fix typo 2012-08-14 19:51:31 +02:00
Andrew Svetlov 6bcd00afa9 Issue #14167: Document return statement in finally blocks.
Patch by Yury Selivanov.
2012-08-14 15:44:53 +03: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
Senthil Kumaran 2f76f73d73 Issue #15630: Add an example for "continue" statement in the tutorial. Patch by
Daniel Ellis.
2012-08-12 11:58:53 -07: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 6c625e6024 update Geany URL; thanks to Karl Tarbet from docs@ 2012-08-12 11:01:50 +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
Georg Brandl eb068f9fa1 Fix casing of SocketServer module in 2.7. 2012-08-11 11:12:55 +02:00
Andrew Svetlov 774c8a39dc fix docs for c-api memory functions 2012-08-09 21:32:11 +03: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
Sandro Tosi 7687f3fb80 add missing period; thanks to Gaston Fiore from docs@ 2012-08-04 19:42:06 +02: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
Eli Bendersky 4c36aa4108 Issue #15231: update PyPI upload doc to say --no-raw passed to rst2html.py 2012-08-02 03:00:33 +03:00
Vinay Sajip 4f947dd970 Improved cookbook entry and fixed typo. 2012-07-27 10:52:18 +01: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
Jesus Cea 0f9b8ee21b Rollback an incorrect Doc/ACKS.txt entry 2012-07-23 18:39:51 +02:00
Jesus Cea fde7890f48 Better test for Issue #15402: Add a __sizeof__ method to struct.Struct 2012-07-23 18:14:45 +02: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
Ezio Melotti e608e3141e #15345: fix SyntaxError in argparse tutorial example. Patch by Simon Hayward. 2012-07-13 21:40:25 +02: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
Éric Araujo 3cf202e957 Ignore .nfs* files in distutils (#7719).
These files are created by some NFS clients a file is edited and removed
concurrently (see added link in doc for more info).  If such a file is
removed between distutils calls listdir and copy, it will get confused.
Other special files are ignored in sdist (namely VCS directories), but
this has to be filtered out earlier.
2012-07-03 01:12:42 -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
Ezio Melotti f637920652 #14840: Add a bit on the difference between tuples and lists. Initial patch by Zachary Ware. 2012-06-17 14:10:59 +02:00
Antoine Pitrou 5ec84cd69e Issue #14933: fix misleading doc about weakref support in extension types. 2012-06-15 19:11:31 +02: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
R David Murray 1eda5c9a83 #8652: update errors tutorial.
The tutorial had some outdated examples.  The patch also adds a caution
about the meaning of parens in the except statement.

Patch by Marien Zwart.
2012-06-07 21:46:44 -04:00
Nick Coghlan 0a09f3e2c3 Nudge readers towards a more accurate mental model for loop else clauses (Backport from 3.x) 2012-06-07 22:57:35 +10:00
Sandro Tosi fd4c4b1e01 backport c4bd68be5fc6 to 2.7 2012-06-02 23:40:59 +02: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