Commit Graph

12361 Commits

Author SHA1 Message Date
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
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
Petri Lehtinen 5f39706b07 #14494: Document that absolute imports became default in 3.0 instead of 2.7. 2012-05-19 18:36:04 +03:00
Petri Lehtinen 491ef97f75 Fix time.time() references in the time module docs
Closes #14842.
2012-05-18 21:19:18 +03:00
R David Murray 1bddab7f0c #14823: Simplify threading.Lock.acquire argument discussion. 2012-05-17 09:15:02 -04:00
Hynek Schlawack 019935f615 #14692 Fix json docs to reflect changes in json.load
The behaviour of the parse_constant callback changed insofar that 'null',
'true', 'false' don't trigger its call anymore.

Patch by Serhiy Storchaka
2012-05-16 18:02:54 +02:00
R David Murray e3d8ab6d38 #1440472: reflow 2012-05-15 22:12:56 -04:00
R David Murray af707234c6 #1440472: Explain that email parser/generator isn't *quite* "idempotent" 2012-05-15 22:12:09 -04:00
R David Murray 8349bc2ba9 #14766: Reflow the altered paragraphs. 2012-05-14 22:33:36 -04:00
R David Murray 089d4d4f7c #14766: Add correct algorithm for when a 'time' object is naive.
This patch also clarifies the definition of Naive and Aware.

Original patch by Greg Weller, I modified the first hunk
somewhat to make the exposition even clearer (I hope).
2012-05-14 22:32:44 -04:00
Ezio Melotti ace9261558 #14405: remove outdated/broken/duplicate links. 2012-05-14 13:26:45 +03:00
Ezio Melotti e710c996ab #14770: backport a couple of changes from 3.x. 2012-05-13 20:19:41 +03:00
Ezio Melotti 6176db5aac #14770: improve the library FAQ. 2012-05-13 19:49:00 +03:00
Sandro Tosi 334be84540 correctly define what 'fill' could be; thanks to Leland Hulbert from docs@ 2012-05-12 23:29:06 +02:00
Raymond Hettinger 56f5c38320 Additional example of using decimal.localcontext(). 2012-05-11 12:50:11 -07:00
Ezio Melotti 35d03ed832 #14763: document default maxsplit value for str.split. 2012-05-10 15:30:42 +03:00
Ezio Melotti 95f42a86dd #14763: fix documentation for string.split/rsplit. 2012-05-09 14:59:24 +03:00
R David Murray 5ec0340ce1 Improve the grammar of a non-sentence. 2012-05-08 21:29:36 -04:00
Sandro Tosi 1d710b6a84 backport 7a05cb3beddf to 2.7 2012-05-07 21:56:24 +02:00
Georg Brandl c5288e60f3 Fix document title for Sphinx. 2012-05-06 21:39:35 +02:00
Ezio Melotti 1c96f946cf #14034: adapt to Python 2 and fix indentation. 2012-05-06 17:03:19 +03:00
Ezio Melotti e48daea2a6 #14034: added the argparse tutorial. Patch by Tshepang Lekhonkhobe. 2012-05-06 16:15:35 +03:00
Ezio Melotti 510ff54324 Use Python 3 instead of 3.0. 2012-05-03 19:21:40 +03:00
Ned Deily d811e150f5 Issue #10433: Document unique behavior of 'os.getgroups' on Mac OS X. 2012-04-30 11:13:16 -07:00
Ezio Melotti 30abb3a6a8 #14558: document the module, argv, and testLoader args of unittest.main. 2012-04-30 19:05:57 +03:00
Raymond Hettinger 524bc3993f Fix typo 2012-04-29 09:25:25 -07:00
Ezio Melotti 8950019283 #14519: fix the regex used in the scanf example. 2012-04-29 11:47:28 +03:00
Ezio Melotti 217e6a66db Fix markup in unittest doc. 2012-04-29 10:52:18 +03:00
Senthil Kumaran fb5aebc1cc Fix issue6085 - Remove the delay caused by fqdn lookup while logging in BaseHTTPRequestHandler 2012-04-29 13:39:16 +08:00
Ezio Melotti 1142773084 #14461: fix wording. 2012-04-29 07:34:22 +03:00
Senthil Kumaran 429d311c2b issue14427 - Document Request.get_header and Request.header_items 2012-04-29 11:52:59 +08:00
Ezio Melotti 48d886b725 #14155: add a note about \b. 2012-04-29 04:46:34 +03:00
Sandro Tosi f8ece8d777 refer to file.readline() in stdtypes doc; thanks to Mihai Capotă from docs@ 2012-04-28 12:50:42 +02:00
Sandro Tosi 2d0bcd7ca9 Issue #14676: DeprecationWarning is ignored too; patch by Peter Eisentraut 2012-04-28 12:20:57 +02:00
Sandro Tosi aa31d52b80 Issue #14448: add reference to IANA timezone database; thanks to Georg/Nick suggestions 2012-04-28 11:19:11 +02:00
Raymond Hettinger 9aa1395916 Make the example cut and pasteable. 2012-04-27 09:55:31 -07:00
Sandro Tosi 51a5ad43b5 fix footnote reference; thanks to Fizz from docs@ 2012-04-25 19:55:30 +02:00
Sandro Tosi 13c598b1d8 Issue #14448: mention pytz; patch by Andrew Svetlov 2012-04-24 19:43:33 +02:00
Sandro Tosi 466a5f20f1 Issue #14554: correct example for captured_stdout() 2012-04-24 18:38:59 +02:00
Sandro Tosi 3f0f5776cd Issue #13478: document timeit.default_timer() 2012-04-24 18:11:29 +02:00
Sandro Tosi 45c6a3cae7 Issue #13587: use the right RFC2617 name for WWW-Authenticate; patch by Aaron Maenpaa 2012-04-24 17:36:14 +02:00
Raymond Hettinger e65753e09e merge 2012-04-23 21:26:58 -07:00
Raymond Hettinger ce0e0c7671 Improve section heading for better discoverability. 2012-04-23 21:26:35 -07:00
Raymond Hettinger 4c8d392bc1 Reorder the entries to put the type specific technique last. 2012-04-23 21:24:15 -07:00
R David Murray 393b7b59a4 #14640: Fix typos/syntax in pyporting.rst.
Patch by Dionysios Kalofonos.
2012-04-23 14:46:39 -04:00
Sandro Tosi da999d29ab Issue #14641: minor fixes to sockets Howto; patch by Dionysios Kalofonos 2012-04-23 19:44:51 +02:00
Raymond Hettinger 016878aea6 merge 2012-04-23 00:22:48 -07:00
Senthil Kumaran ea17082c25 Update 2.7 docs about legal characters allowed in Cookie name 2012-04-22 10:27:22 +08:00
Ned Deily 9b5952d7cd Remove webbrowser doc reference to the previously removed internet-config option. 2012-04-18 12:48:09 -07:00
Raymond Hettinger 094c33f047 Minor fixups. 2012-04-18 00:25:32 -04:00
Raymond Hettinger 33c66301ee Clean-up the SQLite introduction. 2012-04-17 22:48:06 -04:00
Raymond Hettinger 0e15a6e244 Clarify that a new connection needs to be made after the close. 2012-04-17 15:03:20 -04:00
Vinay Sajip 8085f44844 Tweaked format of cookbook example. 2012-04-16 15:45:11 +01:00
Vinay Sajip 4e646aaf93 Added cookbook example for log insertion. 2012-04-16 15:27:55 +01:00
R David Murray 142ab32ecd #14552: remove redundant wording in 'test' docs.
Original patch by Tshepang Lekhonkhobe.
2012-04-11 20:38:45 -04:00
Senthil Kumaran dc0b324a0f Fix closes Issue14258 - Clarify the re.LOCALE and re.UNICODE flags for \S class 2012-04-11 03:22:58 +08:00
Vinay Sajip 2a1c13bb2d Updated logging reference and HOWTO. 2012-04-10 19:52:06 +01:00
Senthil Kumaran 3661473ae0 minor .rst fix 2012-04-10 19:50:08 +08:00
Sandro Tosi ceeb47d0c3 Issue #14502: release() and unlocked lock generates a ThreadError 2012-04-05 22:51:00 +02:00
Georg Brandl b45c5e2d0e Closes #14489: correct link target. 2012-04-05 09:04:40 +02:00
R David Murray 5fc56eb1ca #14481: fix formatting of example in subprocess docs. 2012-04-03 08:46:05 -04:00
Sandro Tosi d987c0221c fix typo; thanks to Robert Bardos from docs@ 2012-04-01 01:49:46 +02:00
Sandro Tosi 6ca845c66a use unittest.skip; thanks to Chang Min Jeon from docs@ 2012-03-31 18:34:42 +02:00
Sandro Tosi 04cd09552a add 'safari' to webbrowser browsers table; thanks to Jonathan Eunice from docs@ 2012-03-31 17:22:47 +02:00
R David Murray 5080cad646 #10423: clarify options vs args in argparse discussion of optparse
Patch by Sandro Tosi.
2012-03-30 18:09:07 -04:00
R David Murray de294ec02e #14416: add missing LOG_SYSLOG facility to syslog docs. 2012-03-29 06:47:59 -04:00
Sandro Tosi 48a88953cc Issue #14410: fix typo in argparse doc; patch by Tshepang Lekhonkhobe 2012-03-26 19:35:52 +02:00
Vinay Sajip 49d5fbab87 Minor documentation tweak. 2012-03-26 17:06:44 +01:00
Georg Brandl 99c1f594b3 Closes #14401: fix typos in curses howto. 2012-03-25 08:43:22 +02:00
Martin v. Löwis fcf37c1896 Issue #14400: Fix typo. 2012-03-24 17:38:29 +01:00
Georg Brandl 94a105705f Closes #14250: regex.flags has not only explicit flags but also those from the pattern 2012-03-17 17:31:32 +01:00
Georg Brandl 5a607b06d6 Closes #14343: avoid shadowing builtin input() in example code. 2012-03-17 17:26:27 +01:00
Georg Brandl ce54617260 Closes #14342: remove out-of-date section about avoiding recursion errors. 2012-03-17 17:25:47 +01:00
Georg Brandl f354f8e369 Closes #14306: clarify expensiveness of try-except and update code snippet 2012-03-17 16:58:05 +01:00
Senthil Kumaran e3d73544ad explain json.dumps for non-string keys in dicts. closes issue6566. Patch contributed Kirubakaran Athmanathan 2012-03-17 00:37:38 -07:00
R David Murray bee24df3a7 #11780: s/throw/raise/ 2012-03-16 22:11:22 -04:00
R David Murray 0cc4e53d1d #11780: document that email.encoders throw TypeError on multipart messages. 2012-03-16 22:06:08 -04:00
R David Murray 32a3b147b2 #12758: removing confusing mention of UTC from time.time description
Patch by Dylan Sarber.
2012-03-15 03:05:01 -04:00
Georg Brandl f590e0458e Closes #14289: put a link to the CHM download page on the docs download page. 2012-03-14 08:18:47 +01:00
Senthil Kumaran c768d4caa8 closes issue14257 - Grammatical fix 2012-03-12 10:05:04 -07:00
Senthil Kumaran 814d316888 closes issue14257 minor error in glossary wording regarding __hash__ 2012-03-11 21:04:05 -07:00
Senthil Kumaran 15b6f3f825 Fix closes issue14258 - added clarification to \W and \S flags 2012-03-11 20:37:39 -07:00
Mark Dickinson 5081957642 Closes #9574: Note that complex constructor doesn't allow whitespace around central operator. 2012-03-10 16:09:35 +00:00
Jason R. Coombs d6a80ee2c7 Use PEP-8 style in logging example 2012-03-07 10:24:04 -05:00
Éric Araujo d2e19b5173 Move xml.etree higher and xml.parsers.expat lower in the markup ToC.
I assume that most users looking at this page are looking for a library
to process XML, not a low-level parser.  First proposed in #11379.
2012-03-05 16:44:49 +01:00
Éric Araujo 76c6aa860c Use source reST role instead of file where it makes sense.
source generates a nifty link to the Mercurial web viewer.
2012-03-05 16:43:41 +01:00
Éric Araujo 47546e6e3d Remove mention of defunct file.
Misc/COPYRIGHT was renamed twelve years ago to LICENSE and later copied
to the main docs, to which there is already a link.
2012-03-05 16:30:46 +01:00
Georg Brandl 21ccb7318d Fix link to global module index. 2012-03-03 21:25:42 +01:00
Eli Bendersky 2b65408dec Issue #11379: add a note in xml.dom.minidom suggesting to use etree in some cases 2012-03-02 07:45:55 +02:00
Petri Lehtinen a15a8d2a0c sqlite3: Port relevant documentation changes from 3.2
Initial patch by Johannes Vogel. Issue #13491.
2012-03-01 21:48:30 +02:00