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