f90ea1f0a0
#14840 : Add a bit on the difference between tuples and lists. Initial patch by Zachary Ware.
2012-06-17 14:10:59 +02:00
13775221e0
Issue #14933 : fix misleading doc about weakref support in extension types.
2012-06-15 19:11:31 +02:00
27b130e702
Issue #15060 : better fix, thanks to review on #python-dev
2012-06-14 00:37:09 +02:00
56692f5722
Issue #15060 : fix typo in socket doc; Patch by anatoly techtonik
2012-06-13 23:58:54 +02:00
a3a164a03c
Nudge readers towards a more accurate mental model for loop else clauses
2012-06-07 22:41:34 +10:00
7f671338de
backport c4bd68be5fc6 to 3.2
2012-06-02 23:41:19 +02:00
964f205a34
refer to time.strftime
2012-06-02 18:22:02 +02:00
554b3481fa
#14957 : fix doc typo.
2012-06-02 11:20:29 -04:00
ae1b94b6e4
#14957 : clarify splitlines docs.
...
Initial patch by Michael Driscoll, I added the example.
2012-06-01 16:19:36 -04:00
3f7d1d3303
Issue #14968 : set 'Inplace Operators' as subsection; patch by Lars Buitinck
2012-06-01 20:23:20 +02:00
13c70345ca
Fix #14943 . Update the proper default value and list the proper argument names in the explanation.
2012-05-29 18:34:45 -05:00
e1398f77ea
#11785 : fix the :mod: references in email package submodule titles.
2012-05-27 17:17:53 -04:00
1a01ebc41c
#14863 : Update the documentation of os.fdopen()
...
There's no bufsize argument anymore, and os.fdopen() is only a very
thin wrapper around open() anymore. Change the documentation to
reflect that.
2012-05-24 21:46:36 +03:00
979f37afd2
Restore [] where default arguments are not keywords
...
Reverts some changes of d13fdd97cc8e.
2012-05-22 16:12:18 +02:00
dfa465243c
#14804 : Remove [] around optional arguments with default values
2012-05-21 11:01:54 +02:00
f54c0604c8
Fix `versionchanged` tags for json.load
...
`versionchanged` tags about 2.7 are useless in 3.x branches.
2012-05-20 18:32:53 +02:00
69d8493899
Fixes #14864 : Added documentation on how to undo the effects of a logging.disable() call.
2012-05-20 15:36:17 +01:00
1203e83d28
Document when json.load's parse_constant behaviour changed
...
It doesn't get called on 'null', 'true', 'false' since f686aced02a3.
2012-05-20 12:03:17 +02:00
079bfc962d
#14494 : Document that absolute imports became default in 3.0 instead of 2.7.
2012-05-19 18:36:33 +03:00
1033b310a3
Fix time.time() references in the time module docs
...
Closes #14842 .
2012-05-18 21:22:47 +03:00
f7a6615719
#14823 : Simplify threading.Lock.acquire argument discussion.
2012-05-17 09:13:30 -04:00
9729fd4427
#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 19:01:04 +02:00
28e68ea6ea
#1440472 : reflow
2012-05-15 22:13:29 -04:00
ea1badbfef
#1440472 : Explain that email parser/generator isn't *quite* "idempotent"
2012-05-15 22:07:52 -04:00
539f239e88
#14766 : Reflow the altered paragraphs.
2012-05-14 22:17:23 -04:00
9075d8b771
#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:14:46 -04:00
e768b06f16
#14405 : remove outdated/broken/duplicate links.
2012-05-14 13:26:45 +03:00
ba3b0d84bd
Issue #14245 : Improve floating-point entry in FAQ. Thanks Zbyszek Jędrzejewski-Szmek for some of the wording.
2012-05-13 21:00:35 +01:00
b35480e1d2
#14770 : improve the library FAQ.
2012-05-13 20:14:04 +03:00
3918b1ebfb
Issue #14793 : fix grammar in bytes object paragraph; patch by Tshepang Lekhonkhobe
2012-05-13 11:01:20 +02:00
38b86b4cf5
correctly define what 'fill' could be; thanks to Leland Hulbert from docs@
2012-05-12 23:29:32 +02:00
a9494f6c53
Some nits in the pickle docs.
2012-05-10 15:38:30 +02:00
cc6c673a69
Removed outdated statement about pickle's and marshal's relative performance.
2012-05-10 15:18:20 +02:00
bf3165b971
#14763 : document default maxsplit value for str.split.
2012-05-10 15:30:42 +03:00
b98b37f101
Improve the grammar of a non-sentence.
2012-05-08 21:28:24 -04:00
0958a4d63d
Fix document title for Sphinx.
2012-05-06 21:39:35 +02:00
9ab3fdd8cb
#14034 : fix indentation.
2012-05-06 17:05:16 +03:00
6cc7a41c2f
#14034 : added the argparse tutorial. Patch by Tshepang Lekhonkhobe.
2012-05-06 16:15:35 +03:00
2e20968feb
Issue #10433 : Document unique behavior of 'os.getgroups' on Mac OS X.
2012-04-30 11:14:02 -07:00
3d6d7a5e15
#14558 : document the module, argv, and testLoader args of unittest.main.
2012-04-30 19:10:28 +03:00
290416f364
Issue11352 - Update cgi module docs
2012-04-30 22:43:13 +08:00
99a56386f1
Issue 14688: Fix typo
2012-04-29 09:32:30 -07:00
a0b1d1eea2
#14519 : fix the regex used in the scanf example.
2012-04-29 11:47:28 +03:00
b8e336b974
Fix markup in unittest doc.
2012-04-29 10:52:18 +03:00
db727b4a77
Fix issue6085 - Remove the delay caused by fqdn lookup while logging in BaseHTTPRequestHandler
2012-04-29 13:41:03 +08:00
0a6b5419b0
#14461 : fix wording.
2012-04-29 07:34:46 +03:00
8dc500476a
issue14427 - Document Request.get_header and Request.header_items
2012-04-29 11:50:39 +08:00
285e51b7e0
#14155 : add a note about \b.
2012-04-29 04:52:30 +03:00
100b889ccd
Issue #14448 : add reference to IANA timezone database; thanks to Georg/Nick suggestions
2012-04-28 11:19:37 +02:00
d11d0d6343
Issue #14448 : mention pytz; patch by Andrew Svetlov
2012-04-24 19:46:06 +02:00
3e29d93007
Issue #14554 : correct example for captured_stdout(); patch by Tshepang Lekhonkhobe
2012-04-24 18:39:24 +02:00
e6c3462607
Issue #13478 : document timeit.default_timer()
2012-04-24 18:11:46 +02:00
08ccbf4be9
Issue #13587 : use the right RFC2617 name for WWW-Authenticate; patch by Aaron Maenpaa
2012-04-24 17:36:41 +02:00
790e005669
#14640 : Fix typos/syntax in pyporting.rst.
...
Patch by Dionysios Kalofonos.
2012-04-23 14:44:00 -04:00
cfdba61c3c
Issue #14641 : minor fixes to sockets Howto; patch by Dionysios Kalofonos
2012-04-23 19:45:07 +02:00
a42665f4d4
issue2193 - Update 3.2 docs about legal characters allowed in Cookie name
2012-04-22 10:30:17 +08:00
cc19140607
Remove webbrowser doc reference to the previously removed internet-config option.
2012-04-18 12:48:52 -07:00
62930e1cc5
Corrected version numbers in cookbook example.
2012-04-17 00:40:48 +01:00
59b9a79a5a
Tweaked format of cookbook example.
2012-04-16 15:46:18 +01:00
b00e8f108d
Added cookbook example for BOM insertion.
2012-04-16 15:28:50 +01:00
1ee17198c8
fix typo; thanks to Jérôme Mainka from docs@
2012-04-14 16:01:17 +02:00
84e59aa989
Fix highlight and spacing in json example.
2012-04-13 21:02:18 -06:00
f86b28e3d2
#14535 : fix code highlight in multiprocessing examples. Patch by Tshepang Lekhonkhobe.
2012-04-13 20:50:48 -06:00
d46d69c279
3.2 sidebar: link to 3.3, not 3.1
2012-04-12 19:41:10 +02:00
e7bade568e
#14553 : fix word order.
...
Patch by Tshepang Lekhonkhobe.
2012-04-11 20:13:25 -04:00
644cabed4b
#14552 : remove redundant wording in 'test' docs.
...
Original patch by Tshepang Lekhonkhobe.
2012-04-11 20:11:53 -04:00
f6cd9b2d46
Improve the threading.Condition docs.
2012-04-11 19:37:56 +02:00
2c5807572f
Closes #14545 : make clearer what was added.
2012-04-11 18:33:17 +02:00
b96a354556
Small improvements to the threading docs: better publicize support for the with statement.
2012-04-10 22:47:55 +02:00
2c9f1042c6
Fix some markup in the threading docs.
2012-04-10 22:35:53 +02:00
126aef768d
Issue #8799 : Fix and improve the threading.Condition documentation.
2012-04-10 22:24:05 +02:00
074faff925
Updated logging reference and HOWTO.
2012-04-10 19:59:50 +01:00
cc4979092f
minor .rst fix
2012-04-10 19:51:00 +08:00
838e638a96
Corrected comment in cookbook example script.
2012-04-09 19:46:24 +01:00
0292fa99ef
Added multiprocessing example to logging cookbook.
2012-04-08 01:49:12 +01:00
3abebca780
Closes #14511 : fix wrong opensearch link for 3.2 docs.
2012-04-07 19:22:17 +02:00
fee3fc748e
Issue #14502 : release() and unlocked lock generates a ThreadError
2012-04-05 22:51:54 +02:00
28b8b94760
#14481 : fix formatting of example in subprocess docs.
2012-04-03 08:46:48 -04:00
165a2c2e27
fix typo; thanks to Robert Bardos from docs@
2012-04-01 01:50:00 +02:00
6afd11c762
Issue #14456 : improve documentation of the signal module w.r.t. threads.
2012-03-31 20:56:21 +02:00
317075de29
use unittest.skip; thanks to Chang Min Jeon from docs@
2012-03-31 18:34:59 +02:00
9ee65f1f92
add 'safari' to webbrowser browsers table; thanks to Jonathan Eunice from docs@
2012-03-31 17:23:10 +02:00
5e0c57142d
#10423 : clarify options vs args in argparse discussion of optparse
...
Patch by Sandro Tosi.
2012-03-30 18:07:42 -04:00
07cf1d8085
#14416 : add missing LOG_SYSLOG facility to syslog docs.
2012-03-29 06:47:35 -04:00
99e7d0706e
Issue #14410 : fix typo in argparse doc; patch by Tshepang Lekhonkhobe
2012-03-26 19:36:23 +02:00
8ece80faae
Minor documentation tweak.
2012-03-26 17:09:58 +01:00
d34fc8b275
Add missing files for new doc theme.
2012-03-25 20:40:57 +02:00
ab7121430e
Switch to new "lighter" doc design.
2012-03-25 20:31:57 +02:00
11ee31ab08
Closes #14401 : fix typos in curses howto.
2012-03-25 08:43:22 +02:00
2dee394af9
Issue #14400 : Fix typo.
2012-03-24 17:39:57 +01:00
1623afff67
#14355 : remove obsolete doc reference to previously removed init_frozen.
...
Patch by Eric Snow.
2012-03-18 20:50:03 -04:00
3a19e542ff
Closes #14250 : regex.flags has not only explicit flags but also implicit flags and those from the pattern
2012-03-17 17:29:27 +01:00
557a3ec9bb
Closes #14343 : avoid shadowing builtin input() in example code.
2012-03-17 17:26:27 +01:00
5ec6fdb0f6
Closes #14342 : remove out-of-date section about avoiding recursion errors.
2012-03-17 17:25:47 +01:00
12c3cd7c1f
Closes #14306 : clarify expensiveness of try-except and update code snippet
2012-03-17 16:58:05 +01:00
f2123d2db5
3.2 explain json.dumps for non-string keys in dicts. closes issue6566. Patch contributed Kirubakaran Athmanathan
2012-03-17 00:40:34 -07:00
41914349ad
#11780 : s/throw/raise/
2012-03-16 22:10:00 -04:00
69ebfe43b0
#11780 : document that email.encoders throw TypeError on multipart messages.
2012-03-16 22:03:17 -04:00
969b8daf5a
Issue #14202 : some additional doc fixes
2012-03-16 16:49:58 +02:00
3fb05a90ce
Issue #14202 : Greatly enhance the documentation of xml.dom.pulldom.
...
Patch by Florian Mladitsch
2012-03-16 14:37:14 +02:00
604c4ff43d
Issue #9257 : clarify the events iterparse accepts
2012-03-16 08:41:30 +02:00
6b3434ae04
Explain the use of charset parameter with Content-Type header. Issue11082
2012-03-15 18:11:16 -07:00
38c2754652
#12758 : removing confusing mention of UTC from time.time description
...
Patch by Dylan Sarber.
2012-03-15 03:06:15 -04:00
87684e6eea
Fix the wrong urllib exampls which use str for POST data. Closes Issue11261
2012-03-14 18:08:13 -07:00
300a691026
Closes #14305 : fix typo.
2012-03-14 22:40:08 +01:00
525fd5447d
Closes #14289 : put a link to the CHM download page on the docs download page.
2012-03-14 08:18:47 +01:00
69c7a69cbe
Closes #14283 : match() and search() are regex methods, not match methods.
2012-03-14 08:02:43 +01:00
21c71bac5f
closes Issue12365 - Add an example explaining the context manager use case of urllib.urlopen
2012-03-13 19:47:51 -07:00
6080db7606
closes issue14257 - Grammatical fix
2012-03-12 10:05:34 -07:00
a7fccd8b14
closes issue14257 - 3.2 minor error in glossary wording regarding __hash__
2012-03-11 21:04:56 -07:00
328dd0d5f3
Closes #9574 : Note that complex constructor doesn't allow whitespace around central operator.
2012-03-10 16:09:35 +00:00
64a40949cf
Closes #14186 : add link to PEP 3107 (function annotations) to the function definition section.
2012-03-10 09:22:47 +01:00
065dedaf47
Fix closes Issue: 14217 - 3.2 branch
2012-03-08 20:56:52 -08:00
30b8e5461d
Use PEP-8 style in logging example
2012-03-07 10:26:08 -05:00
e5eec7e198
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:01:41 +01:00
fdfaf0aba2
Use source reST role instead of file where it makes sense.
...
source generates a nifty link to the Mercurial web viewer.
2012-03-05 15:50:37 +01:00
d3899e320f
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 15:47:32 +01:00
b2b18632ce
merge 3.2 heads
2012-03-02 07:43:08 +02:00
20293441da
Issue #11379 : add a note in xml.dom.minidom suggesting to use etree in some cases
2012-03-02 07:37:13 +02:00
4d2bfb5e08
sqlite3: Port documentation changes from the 2.7 branch
...
Issue #13491 .
2012-03-01 21:48:38 +02:00
443f000bdd
#14155 : remove duplication about search vs match in re doc.
2012-02-29 13:39:05 +02:00
5a045b9f54
#10713 : Improve documentation for \b and \B and add a few tests. Initial patch and tests by Martin Pool.
2012-02-29 11:48:44 +02:00
62417a0354
Propagate changes for issues #13053 and #13086 from 2.7 to 3.2. (Doc only.)
2012-02-28 16:21:47 -08:00
83c48822c5
s/div/truediv/; thanks to Félix-Antoine Fortin from docs@
2012-02-28 22:28:28 +01:00
39b83ac772
Improved logging cookbook example.
2012-02-28 08:05:23 +00:00
e998386442
Fix markup errors.
2012-02-28 08:21:40 +01:00
982f534fab
Updated cookbook with information on customising LogRecords.
2012-02-27 11:56:29 +00:00
6b883a2c4d
Updated logging cookbook with info on alternative format styles.
2012-02-27 11:02:45 +00:00
3bbdc8e822
Issue #14123 : Explicitly mention that old style % string formatting has caveats
...
but is not going away any time soon.
2012-02-26 01:54:07 -08:00
f527277b67
Branch merge
2012-02-26 04:00:43 +01:00
a6091998af
Use const markup instead of a misleading string literal
2012-02-26 02:13:30 +01:00
4342722f40
#14114 : don't include copybutton.js in the htmlhelp output.
2012-02-25 19:24:24 +02:00
e578021696
Add 3.2.3 to license.
2012-02-23 21:19:18 +01:00
eb25fb7af7
Fix markup errors.
2012-02-23 21:12:39 +01:00
7ef825fdab
merge with 3.2
2012-02-21 22:36:37 +01:00
c9a42070a6
Remove reST markup from --help output. Also: O(n**2) is dict construction, not single insertion.
2012-02-21 22:36:27 +01:00
09a7c72cad
Merge from 3.1: Issue #13703 : add a way to randomize the hash values of basic types (str, bytes, datetime)
...
in order to make algorithmic complexity attacks on (e.g.) web apps much more complicated.
The environment variable PYTHONHASHSEED and the new command line flag -R control this
behavior.
2012-02-20 21:31:46 +01:00
2daf6ae249
Issue #13703 : add a way to randomize the hash values of basic types (str, bytes, datetime)
...
in order to make algorithmic complexity attacks on (e.g.) web apps much more complicated.
The environment variable PYTHONHASHSEED and the new command line flag -R control this
behavior.
2012-02-20 19:54:16 +01:00
fee358b0df
logging: clarified documentation for Handler.handleError.
2012-02-20 18:35:26 +00:00
c3ef037ee1
Add missing “::” markup.
...
Also wrap two looong lines.
2012-02-20 01:44:55 +01:00
0467686e07
Issue #13605 : use print() in argparse nargs example
2012-02-19 19:54:00 +01:00
f06d444f5a
don't split 'Hye-Shik Chang' name; thanks to Sergey from docs@
2012-02-19 12:30:28 +01:00
76dea27421
Indent 'File' in memoryview example, so it is correctly highlighted
2012-02-19 12:28:01 +01:00
c33ae06cbf
fix error in memoryview example; thanks to kan lianlian from docs@
2012-02-18 16:05:34 +01:00
ead1de2f03
Issue 14023 Revert edit to 2.7 version. (I suspect edit is from when we thought
...
to to makes bytes mutable, before deciding to add bytearrays.)
2012-02-17 19:56:58 -05:00
4279bc7aef
#14020 : improve HTMLParser documentation.
2012-02-18 02:01:36 +02:00
b3890226b3
sqlite3: Fix documentation errors concerning Cursor.rowcount
...
Closes #13995 .
2012-02-16 21:39:03 +02:00
5cb522cb32
Issue #11836 : document multiprocessing.queues.SimpleQueue
2012-02-15 23:14:21 +01:00
1ca93954e1
Issue #13491 : Fix many errors in sqlite3 documentation
...
Initial patch by Johannes Vogel.
2012-02-15 22:21:01 +02:00
ccddc474c3
Improve doc for atexit.register and unregister ( #12297 )
2012-02-15 17:07:49 +01:00
7f728c1e1a
shutil copy module reference doc fix.
2012-02-13 23:30:47 +08:00
58f23ffb21
Issue #13930 : Adds ability for 2to3 to write its output to a different
...
directory tree instead of overwriting the input files. Adds three command
line options: -o/--output-dir, -W/--write-unchanged-files and --add-suffix.
Feature backports into stable release branches for 2to3 are allowed by
a special exemption:
http://mail.python.org/pipermail/python-dev/2011-December/115089.html
2012-02-12 15:50:21 -08:00
01a2215727
Update mention of Subversion in the FAQ.
...
If I grepped correctly, this was the last outdated place.
2012-02-12 04:49:45 +01:00
30d94b7aea
Issue #13989 : Document that GzipFile does not support text mode.
...
Also, give a more helpful error message when opened with an invalid mode string.
2012-02-11 23:45:10 +02:00
5b14d732d8
Issue #9021 - Introduce copy module better. Doc changes suggested by Terry
...
Reedy.
2012-02-09 18:26:59 +08:00
6e13f130a9
Fix Issue #6005 : Examples in the socket library documentation use sendall,
...
where relevant, instead send method.
2012-02-09 17:54:17 +08:00
cd2a6033ac
Branch merge
2012-02-05 13:41:47 +01:00
bd249c1bae
Clarify note in BZ2File docs about lack of multi-stream support (issue #1625 ).
2012-02-05 14:29:00 +02:00
9701eb6e14
Closes #13944 : fix capitalization of class name.
2012-02-05 09:25:22 +01:00
8f50912f87
Issue #1625 : Document BZ2File's lack of support for multi-stream inputs.
2012-02-04 23:44:49 +02:00
f51ebf94bb
threading primitives now have timeouts
2012-02-04 09:55:52 -05:00
9713321f46
Document absoluteness of sys.executable
...
Closes #13402 .
2012-02-02 20:59:50 +02:00
090ec3c7fc
merge. again.
2012-02-01 15:24:10 -06:00
10dda6e029
Add a hint that CSD == Service Pack.
...
People searcing for the way to get a "service pack" will never find that we
provide it here, and people that find this function won't know what CSD is
until they run the function. On top of this, they won't know what the value
means unless they really have a service pack installed.
CSD, or Customer Service Diagnostics, is apparently no longer used, and was
rarely used term at that. Most references to it online are from
universities making Windows 2000 and XP service packs available to students.
2012-02-01 15:14:00 -06:00
fc3ba6b8fc
Add usage note
2012-02-01 09:07:40 -08:00
c875d2032b
Fix #13900 : resolve self-referential description of a parameter.
2012-01-29 15:38:47 +01:00
871b9d169d
note that get() is not affected by default_factory ( closes #13887 )
2012-01-27 09:14:01 -05:00
04707c032e
Fix error handling in examples of C API use.
2012-01-27 14:07:29 +01:00
9f6b02ecde
Clarify that ssl.OP_ALL can be different from OpenSSL's SSL_OP_ALL.
2012-01-27 10:02:55 +01:00
722db7bdba
merge
2012-01-26 18:36:08 -05:00
1740afded1
Issue #13883 : Document all platforms PYTHONCASEOK works on.
2012-01-26 18:29:06 -05:00
65992c1c01
- Issue #13840 : Fix ctypes.create_string_buffer exception message and docs.
2012-01-26 08:44:00 -06:00
6c89a79d55
#13852 : some small doc fixes.
2012-01-25 22:36:25 +01:00
b4b0b354dd
kill extra word
2012-01-25 16:30:18 -05:00
e9fca253d0
say bitwise (because I have no idea what a bit-string is)
2012-01-25 16:29:03 -05:00
5311c1d7ab
Issue #13772 : In os.symlink() under Windows, do not try to guess the link
...
target's type (file or directory). The detection was buggy and made the
call non-atomic (therefore prone to race conditions).
2012-01-24 08:59:28 +01:00
3b65fd7e97
#13816 : fix two minor style issues. Thanks to Justin Wehnes for the patch.
2012-01-23 20:19:33 +01:00
f49d152ab2
Issue #12922 : fix the TextIOBase documentation to include a description of seek() and tell() methods.
2012-01-21 20:20:49 +01:00
41b2404dab
fix typo; thanks to Justin Watt from docs@
2012-01-21 10:59:37 +01:00
a3443d985e
Issue #12949 : Document the kwonlyargcount argument for the PyCode_New C API function.
2012-01-19 22:06:31 -06:00
da8e11ac71
Issue #13605 : more meaningful example + fixes
2012-01-19 22:23:00 +01:00
16bd0b4463
Issue #13605 : add documentation for nargs=argparse.REMAINDER
2012-01-19 21:59:55 +01:00
f0229aa51c
Issue #11948 : clarify modules search path
2012-01-19 11:29:26 +01:00
972cfb9169
Issue #2134 : Clarify token.OP handling rationale in tokenize documentation.
2012-01-19 00:22:22 -06:00
c77bb65deb
Remove "documenting" latex document.
2012-01-16 21:40:12 +01:00
32ee44ffb4
Issue: #12409 : remove obsolete susp-entries
2012-01-16 18:02:09 +01:00
f2fbb9cf42
Improve interlinking of archiving/compression modules docs.
...
- Remove duplicated list of links to the other modules from each
module’s doc (people can already go up to library/archiving and
there they can see the list).
- Link to shutil high-level operations.
Reviewed by Nadeem Vawda in #6715 .
2012-01-16 16:55:55 +01:00
6f7aa00c1e
Document json.dump ensure_ascii parameter ( #13770 )
2012-01-16 10:09:20 +01:00
01b34afb3a
#13715 : fix typo in unicodedata doc. Patch by Eli Collins.
2012-01-16 08:42:32 +02:00
9ecb6beb8c
#13695 : fix a couple of typos in the doc.
2012-01-16 08:28:54 +02:00
9c7b9190c3
Markup improvements for the embedding CPython doc patch from #1040439
2012-01-15 02:31:58 +01:00
9cff42736d
Hide or remove user-visible XXX notes from distutils doc ( #13716 ).
...
Requested by Florent Xicluna with the rationale that they make the docs
look unfinished. I’ve also removed a few XXX notes that were not
visible in the HTML but could waste contributors’ time by suggesting
improvements that are never going to happen for distutils.
2012-01-15 02:25:31 +01:00
515687a7ed
remove 'Documenting Python' and its references, it's now on devguide
2012-01-14 22:23:27 +01:00
c1f079f317
Mention the additional way to use the lvl parameter and when it changed.
2012-01-14 12:46:17 -08:00
a931463fea
#13730 grammar fix
2012-01-13 23:43:13 -05:00
a3d1e2e342
#11633 At least 2 people prefer earlier revision.
2012-01-12 14:49:02 -05:00
889a5101c2
Issue #13724 : improve documentation for socket.create_connection.
2012-01-12 08:06:19 +01:00
ea868d32a1
Minor correction. #11418
2012-01-11 14:54:34 -05:00
e247928fed
Closes #11633 Clarify print buffering.
2012-01-11 14:09:49 -05:00
f4ec3c5a92
#13754 String returned if less than *or equal to* x 3
...
Close *13753 'seq' now 'iterable'
2012-01-11 03:29:42 -05:00
19d85c2762
Issue9637 - Explain in getproxies_environment that <scheme>_proxy environ variable case does not matter.
2012-01-11 01:29:08 +08:00
ac8bfcacfc
Issue #13747 : fix SSL compatibility table.
2012-01-09 21:43:18 +01:00
84a2edcdf7
Issue #13747 : fix documentation error about the default SSL version.
2012-01-09 21:35:11 +01:00
645a0dd6f7
Py_SetPythonHome() can be called before Py_Initialize(); thanks to Cody Smith from docs@
2012-01-07 18:34:07 +01:00
ded0348c08
Issue #13502 : threading: Fix a race condition in Event.wait() that made it
...
return False when the event was set and cleared right after.
2012-01-07 18:24:56 +01:00
b52e7a9a36
clarify recv* are blocking operations; thanks to Chris Kogelnik from docs@
2012-01-07 17:56:58 +01:00
441ae043df
Update printout of SSL certificate examples for 3.2+.
2012-01-06 20:06:15 +01:00
f57674713a
Issue #12042 : a queue is only used to retrive results; preliminary patch by Jordan Stadler
2012-01-05 19:48:56 +01:00
ba232dfc83
Issue #11984 : remove reference to parser, it's not showing symbol usage anymore
2012-01-05 19:06:25 +01:00
98492a50ea
Issue #10772 : add count and help argparse action; patch by Marc Sibson
2012-01-04 23:25:04 +01:00
b7ffed8a50
Add a subsection explaning cipher selection.
2012-01-04 02:53:44 +01:00
d204934ee3
exception support is correct now ( closes #13705 )
2012-01-03 16:30:37 -06:00
753b79c073
Issue #6031 : improve serve_forever() description
2012-01-03 22:35:54 +01:00
ea320abcae
Issue #9349 : add argparse.SUPPRESS to help doc
2012-01-03 18:37:03 +01:00
da785fd527
Issue #13690 : add re.DEBUG; patch by Filip Gruszczyński
2012-01-01 12:55:20 +01:00
b2794c842f
Issue #13683 : raise with no exception in scope throws a RuntimeError; fix by Ramchandra Apte
2012-01-01 12:17:15 +01:00
c40d362a1c
merge heads
2011-12-31 22:42:45 -06:00
f606e682a4
add another year to glorious PSF IP
2011-12-31 22:42:26 -06:00
1abde3628b
fix some broken URLs
2011-12-31 18:46:50 +01:00
d08effe287
Some formatting & grammar fixes for the multiprocessing doc
2011-12-31 07:20:26 +02:00
a6c4a10d4e
indicate msg is an argument
2011-12-30 23:08:09 -06:00
79ed84c7f2
use booleans
2011-12-30 13:47:25 -06:00
1532c8f9a7
I do not think we will ever have auto-indent at the prompt, that is for IPython and the like.
2011-12-25 19:03:07 +01:00
7386662699
use list() to wrap range() in itertools.permutations() example; thanks to Romain MORLEVAT from docs@
2011-12-25 17:25:45 +01:00
3e6c814b9d
fix "Title underline too short" sphinx warning
2011-12-25 17:14:11 +01:00
2b373b0146
use double-quote char instead of unicode ones; thanks to tomo cocoa from docs@
2011-12-25 17:07:22 +01:00
44f568c21f
fix to sent/send typo
2011-12-25 11:44:38 +01:00
1526ad166e
fix Constuctor/Constructor typo; thanks to Anthon van der Neut from docs@
2011-12-25 11:27:37 +01:00
3721fbc5de
point IronPython to ironpython.net; thanks to Lazar Pancic from docs@
2011-12-24 23:13:19 +01:00
75c71ccf2a
fix Rather that/Rather than; thanks to Reuben Thomas from docs@
2011-12-24 19:56:04 +01:00
baf30da240
remove spurious dot from string formatting example; thanks to Anthon van der Neut from docs@
2011-12-24 15:53:35 +01:00
0b7e5369f1
correct syslog.openlog() argument name to logoption; thanks to Arnaud Gomes-do-Vale from docs@
2011-12-24 14:51:49 +01:00
ac007ba686
Issue #13632 : Update token documentation to reflect actual token types
2011-12-23 22:30:16 -06:00
57f97f400b
parameter_list was meant here
2011-12-23 20:01:43 -06:00
ad17358a2f
kill superfluous 'comprehension' case ( closes #13658 )
2011-12-23 20:00:56 -06:00
016c6d5341
Issue12798 - Update mimetypes documentation. Correct the doc section where
...
common_types was mentioned under MimeTypes class, move it to helper function
category and other documentation improvements contributed by Sandro Tosi.
2011-12-23 10:52:42 +08:00
08c08eb93c
Issue #13597 : Fix the documentation of the "-u" command-line option, and wording of "What's new in Python 3.0" about standard streams.
2011-12-21 11:24:15 +01:00
0f1e3ac897
note the blinding speed of these functions
2011-12-20 10:12:41 -06:00
1c92cfea4a
don't mention implementation detail
2011-12-19 16:41:11 -05:00
80a61e8d4c
#13387 : rephrase unclear sentence.
2011-12-19 07:04:48 +02:00
6fbd525ef5
Issue #13617 : Document that the result of the conversion of a Unicode object to
...
wchar*, Py_UNICODE* and bytes may contain embedded null characters/bytes.
Patch written by Arnaud Calmettes.
2011-12-18 19:22:31 +01:00
a94a0e92b8
Issue #13522 : Fix _Py_co_pow() documentation
...
Patch written by Arnaud Calmettes.
2011-12-18 02:56:18 +01:00
07b1c877b2
Issue #13522 : document error return values of some float and complex C API functions.
2011-12-18 01:25:27 +01:00
e83f899364
Issue #13530 : Document os.lseek() result
...
Patch written by Jérémy Anger.
2011-12-17 23:15:09 +01:00
e5b2ac8987
#13613 : fix example in re doc.
2011-12-17 01:17:17 +02:00
7158e06212
Issue #13597 : Improve documentation of standard streams.
2011-12-15 16:25:34 +01:00
7b7e39a61f
#6570 : clarify tutorial section about keyword arguments.
2011-12-13 15:49:22 +02:00
91621e2c16
#13549 : improve tutorial section about listcomps.
2011-12-13 15:36:19 +02:00
0c6cbbd632
Fix doc typo.
2011-12-10 12:45:45 +01:00
432259feea
Issue #13528 : rework the performance question in the programming FAQ
2011-12-09 23:10:31 +01:00
5b73ca4b3d
s/SOCKSTREAM/TCP/
2011-12-05 01:46:35 +01:00
8e644f0e7c
Reword IPC section
2011-12-05 01:43:32 +01:00
8345451170
Use www.python.org instead of a hostname pointing to a parked (or squatted) domain.
...
Also, reformat a bit.
2011-12-05 01:37:34 +01:00
fa03f6c863
Remove the outdated notion that multithreading doesn't work well on Unices.
2011-12-05 01:32:29 +01:00
534e253cb6
Remove reference to the base64 encoding.
2011-12-05 01:21:46 +01:00
48a7cbf7c2
The functional module hasn't been maintained since 2006 and doesn't work with Python 3.
...
Remove section about it from the functional programming FAQ.
2011-12-05 01:05:32 +01:00
ae44b7a099
Remove obsolete references to bsddb
2011-12-05 00:41:19 +01:00
c1bd4896cf
Issue #13527 : remove mention of Python megawidgets and Tkinter3000 WCK
...
from the doc. These two projects appear dead.
2011-12-04 23:56:30 +01:00
6a96a2e1f8
Fix typo.
2011-12-04 11:51:21 +01:00
dec0f21efc
Streamline mention of sorted()
2011-12-03 23:08:57 +01:00
c561a9adac
Break down and refine memory management question
2011-12-03 23:06:50 +01:00
17bd792cd3
Reformulate answer, and remove off-topic discussion of bytecode in a question about compiling to C.
2011-12-03 22:56:02 +01:00
cc809a286a
Fix compatibility statement.
2011-12-03 22:39:13 +01:00
748799a0a6
Remove outdated question (the bsddb module isn't included anymore)
2011-12-03 22:37:14 +01:00
d4ddec5988
Refine FAQ entry for catching stdout
2011-12-03 22:35:31 +01:00
48383bfc67
Advocate PyTuple_Pack instead of manual building of tuples
2011-12-03 22:30:19 +01:00
f35204055e
Remove outdate FAQ content
2011-12-03 22:19:55 +01:00
c5b266efb5
Streamline FAQ entry about the ternary operator, and suggest using io.StringIO for a mutable unicode container.
2011-12-03 22:11:11 +01:00
9cb41dfbaa
Remove references to psyco, which is mostly unmaintained and doesn't work with Python 3.
2011-12-03 21:21:36 +01:00
5dd95d6f2d
Mention PySide in the "other GUIs" page.
2011-12-03 21:07:01 +01:00
7462e87134
Mention the new GTK+ 3 bindings.
2011-12-03 20:59:24 +01:00
777bebb0ef
Issue #13513 : IOBase docs incorrectly link to the readline module
2011-12-03 12:29:54 -06:00
a90e364ea5
Issue #12666 : Added section about map changes.
2011-12-03 08:24:21 -05:00
df9a5f5ecf
Issue #12666 : Clarifying changes in map for Python 3
2011-08-01 17:51:34 -04:00
c1f26f6fc1
#13494 : s/cast/convert/. Also add a link.
2011-12-02 19:47:24 +02:00
b1b3fd23b7
#13499 : fix example adding >>> before the comments.
2011-12-02 19:28:36 +02:00
71bca3495d
Issue #1040439 : better document how to compile and link an embedded Python interpreter.
...
Still lacks docs for Windows (anyone?).
2011-11-30 21:19:21 +01:00
c4d7d8c49d
Mark up constants in sockets docs as such
2011-11-29 16:46:38 +01:00
2bddc53cb9
Fix typo ( #13467 )
2011-11-29 16:34:58 +01:00
fd9ebd4a36
Clarify concatenation behaviour of immutable strings, and remove explicit
...
mention of the CPython optimization hack.
2011-11-25 16:33:53 +01:00
5a53f368e6
fix some typos in Doc/c-api/memoryview.rst
2011-11-25 15:07:50 +02:00
631a7e23c5
Added a configuration dictionary example to the logging cookbook.
2011-11-23 14:27:54 +00:00
287f24691d
Closes #13459 : Clarified documentation on Logger.propagate. Thanks to Mike Fogel for the patch.
2011-11-23 08:54:22 +00:00
3b1acf11e9
bytes() can't be used to get a representation of an object.
2011-11-22 19:34:08 +01:00
b1e58fe43f
Issue #12245 : Document sys.float_info.rounds better.
2011-11-19 16:26:45 +00:00
fabf0275a9
#13387 : add note about checking the exact type in assertIsInstance doc.
2011-11-18 18:59:36 +02:00
e62aad3073
#13426 : fix typos in pickle doc.
2011-11-18 13:51:10 +02:00
eeae1498aa
fixing typos in optparse doc
2011-11-16 06:02:21 +02:00
04e6909845
Fix markup
2011-11-14 18:00:48 +01:00
d44af82e62
Issue #12767 : documenting threading.Condition.notify
2011-11-12 20:44:25 +02:00
599d76b275
Reformat paragraphs.
2011-11-11 19:56:26 +01:00
45c6c3eb71
Few typos in the documentation.
2011-11-11 19:55:21 +01:00
a7795dbe9a
Issue #13191 : typo in argparse docs
2011-11-11 10:57:01 +02:00
c2c896093b
Issue #13365 : correct an error in the documentation of str.expandtabs
2011-11-11 10:40:14 +02:00
32e4a58c06
Issue #13237 : Fix formatting error - the legacy shell commands weren't meant to be under the Notes heading
2011-11-08 21:50:58 +10:00
69ce0d8602
Issue #13237 : Remove duplicate data value descriptions from the subprocess docs
2011-11-08 21:39:07 +10:00
c29248f232
Issue #13237 : Forward port subprocess module updates and explicitly document UTF-8 encoding assumption when universal_newlines=True
2011-11-08 20:49:23 +10:00
06c42a3fca
Document that shutil.make_archive does not typecheck its logger argument
2011-11-07 17:31:07 +01:00
395ca72380
Issue #3067 : Enhance the documentation and docstring of locale.setlocale()
2011-11-05 10:21:16 +02:00
9c2f42f253
Branch merge
2011-11-03 16:27:57 +01:00
a083823a85
Avoid relying on the default reST role in logging library doc
2011-11-03 04:35:20 +01:00
3bb1a6f990
State explicitely that PYTHONDONTWRITEBYTECODE is equivalent to -B
2011-11-03 03:20:43 +01:00
2662133a05
Issue #10570 : curses.tigetstr() is now expecting a byte string, instead of a
...
Unicode string.
This is an incompatible change, but the previous behaviour was completly wrong.
2011-11-02 23:45:29 +01:00
7de56f6a04
#670664 : Fix HTMLParser to correctly handle the content of ``<script>...</script>`` and ``<style>...</style>``.
2011-11-01 14:12:22 +02:00
4bfe03a42e
correct signature for tzinfo.dst() in examples; thanks to Daniil Shved from docs@
2011-11-01 10:32:05 +01:00
53bcd66012
use diveintopython.net now that DIP.org returns 410; thanks to Josh Gachnang from docs@
2011-10-31 17:46:04 +01:00
69e59a17dd
remove confusing paragraph (as part of r87523); thanks to AJ Hill from docs@
2011-10-31 17:15:39 +01:00
e348455f5f
document turtle done() function; thanks to Csaba Szepesvari from docs@
2011-10-31 10:12:43 +01:00
567493fe26
caught is the right pp of catch; thanks to Don Bennett from docs@
2011-10-31 02:41:06 +01:00
6f45d18c24
Improve itertools docs with clearer examples of pure python equivalent code.
2011-10-30 15:06:14 -07:00
f54f6f520d
Add a button to the code examples in the doc to show/hide the prompts and output.
2011-10-30 09:20:19 +02:00
305bb662a9
Documentation typo
2011-10-28 22:14:41 +02:00
83386dac8b
I should be someone
2011-10-28 22:03:55 +02:00
f99e4b5dbe
Improve HTMLParser example in the doc and fix a couple minor things.
2011-10-28 14:34:56 +03:00
0b85cd0680
Merge heads.
2011-10-28 12:32:53 +03:00
d3cf0db3ee
#13278 : fix typo.
2011-10-28 12:22:25 +03:00
74e6495a20
Fixes #13270 : obsolete reference to old-style/new-style classes.
2011-10-28 11:21:19 +02:00
6187664fa7
Added lost documentation cross-reference.
2011-10-27 17:50:55 +01:00
fbb39815d4
Refactor a bit the codecs doc.
2011-10-25 10:40:38 +03:00
963004d1d8
Fix typo.
2011-10-25 09:41:13 +03:00
1fafc1a11f
document __bytes__ special method ( closes #13259 )
2011-10-25 00:03:51 -04:00
d6ca6c2b32
note callable is back in 3.2
2011-10-24 08:51:15 -04:00
023611f34e
Issue 13141: Demonstrate recommended style for socketserver examples.
2011-10-23 22:40:37 +02:00
ce77037503
Add the green "New reference" note to the doc of PyException_GetTraceback()
2011-10-23 21:03:33 +03:00
cd1d3ef77b
#13233 : fix typo.
2011-10-20 19:51:18 +03:00
81231d9379
#13219 : clarify section about character sets in the re documentation.
2011-10-20 19:38:04 +03:00
af37b89240
Issue 12668: Fix wording in Whatsnew3.2
2011-10-19 14:16:18 -07:00
5768e0c788
Issue 11931: Minor punctuation/grammar/wording fixups to the regex docs
2011-10-19 14:10:07 -07:00
29fa9d4d68
3.2 - Fix closes Issue6090 - Raise a ValueError, instead of failing with unrelated
...
exceptions, when a document with timestamp earlier than 1980 is provided to
zipfile. Patch contributed by Petri Lehtinen.
2011-10-20 01:46:00 +08:00
e130a52d8a
Remove duplication.
2011-10-19 10:58:56 +03:00
67494f2224
#12277 : add missing comma.
2011-10-18 12:59:39 +03:00
9be57231dd
Update dead references from py.org/dev/faq to the devguide ( #13176 )
2011-10-14 17:37:45 +02:00
f1ab47ebc4
Issue #13145 . Fix incorrect documentation for PyNumber_ToBase. Thanks Sven Marnach.
2011-10-11 18:06:36 +01:00
4e15828640
Fix/improve markup in whatsnew/2.7.
2011-10-10 00:30:14 +03:00
138fc896c8
#13138 : add missing versionadded.
2011-10-10 00:02:03 +03:00
df7c4cde48
Clean-up and improve the priority queue example in the heapq docs.
2011-10-09 17:28:14 +01:00
47a4521ece
Fix distutils byte-compilation to comply with PEP 3147 ( #11254 ).
...
Patch by Jeff Ramnani. Tested with -B, -O and -OO.
2011-10-08 00:34:13 +02:00
35a502b324
Fix a typo and a broken link (part of #10536 ).
...
Found by Franz Glasner in #2504 .
2011-10-07 22:02:58 +02:00
f394e47851
Issue #12823 : remove broken link and replace it with another resource.
2011-10-07 16:58:07 +02:00
bb2095f1e2
Branch merge
2011-10-06 13:10:34 +02:00
ad87fa6719
Issue #13073 - Address the review comments made by Ezio.
2011-10-05 23:26:49 +08:00
58a9153c9f
Fix markup used in the documentation of sys.prefix and sys.exec_prefix.
...
- Using the file role with {placeholders} is IMO clearer than fake
Python code.
- The fact that sys.version[:3] gives '3.2' is a CPython detail and
should not be advertised (see #9442 ), even if some stdlib modules
currently rely on that detail.
2011-10-05 01:28:24 +02:00
da27263b4a
Move doc of sys.dont_write_bytecode to make all attributes sorted again
2011-10-05 01:17:38 +02:00
5d0de3fbaa
Document message_body arg in HTTPConnection.endheaders
2011-10-03 07:27:06 +08:00
35ec7f771b
#13076 : fix links to datetime.time and datetime.datetime.
2011-10-02 12:44:50 +03:00
17dac4c0e2
Fix closes issue13005 - Remove the mention of 'repeat' method in the operator module documentation.
2011-09-22 02:09:17 +08:00
1d678f8413
Fix bug in heapq priority queue example.
2011-09-18 07:40:05 +02:00
73dd7c71f6
Add info from the docstring for random.gammavariate() to the docs.
2011-09-17 20:36:28 +02:00
755460694e
Fix typo.
2011-09-17 20:20:04 +02:00
4165bfb6e9
#12940 : fix cmd example. Patch by Tim Chase.
2011-09-10 10:06:01 +03:00
eb933de807
Fix current name of the Python 3 binary on Unix ( #12896 ).
...
Also fix some markup and typos.
2011-09-09 19:03:41 +02:00
4eb0e73ff2
Closes #12906 : Fixed bug in YAML configuration.
2011-09-06 14:07:23 +01:00
e969a2117c
Fix closes Issue11155 - Correct the multiprocessing.Queue.put's arg (replace 'item' with 'obj') in the docs. Patch by Westley Martínez.
2011-09-06 00:21:30 +08:00
3484a8771c
Merge with release clone.
2011-09-04 08:35:54 +02:00
7335e6f3e8
removed misleading editing leftovers
2011-09-02 23:17:39 +02:00
fbd4fe2195
Give credit to Adam
2011-09-02 21:24:40 +02:00
172f374a63
#12781 : Mention SO_REUSEADDR flag near socket examples
2011-09-02 20:06:31 +02:00
d9e1789364
Branch merge
2011-09-02 17:30:36 +02:00
18ddf826e7
Add links from library/functions to other docs.
...
Suggested by Terry J. Reedy in #12298 .
2011-09-01 23:10:36 +02:00
9edd9f035b
Fix a few links in the table of built-in functions ( #12298 )
2011-09-01 23:08:55 +02:00
29cf58c9d5
Document that format string don’t support arbitrary dictonary keys.
...
Text adapted from the PEP. Addition requested by Terry J. Reedy on
2011-02-23 on python-dev.
2011-09-01 18:59:06 +02:00
8ab3a1d735
Document that True/False/None don’t use :keyword: in doc.
...
This was discussed some months ago on python-dev. Having tons of links
to the definition of True would be annoying, contrary to links to e.g.
the nonlocal or with statements doc.
2011-09-01 18:45:50 +02:00
222b20844f
From RFC 3629 5- and 6-bytes UTF-8 sequences are invalid, so remove them from the doc.
2011-09-01 08:11:28 +03:00
a9353db2cd
Remove duplicate text in os documentation.
2011-09-01 06:58:52 +02:00
ec9a5f6399
Add version number for versionchanged directive (backport from 3.3)
2011-09-01 05:55:26 +02:00
7af8ebb6ce
Adapt/remove mentions of functions gone in 3.x
2011-09-01 03:20:13 +02:00
37b5f9eebc
Fix some misuses of Sphinx roles and one typo
2011-09-01 03:19:30 +02:00
941afedd74
Avoid using the default reST role. Makes Doc/tools/rstlint.py happy.
2011-09-01 02:47:34 +02:00
be573e7d17
Remove outdated pointer to optparse ( fixes #11360 ).
...
The doc already points to argparse.
2011-08-26 16:38:40 +02:00
77443824f5
Document the "optional" argument of distutils’ Extension class
2011-08-26 00:45:18 +02:00
3f5e958a3f
Fix type information in distutils API reference ( #9302 ).
...
Initial patch by Yue Shuaijie.
2011-08-26 00:44:37 +02:00
cc42ebe450
Make the list of docs contributors sorted again
2011-08-26 00:10:12 +02:00
e1eef41a18
Close #12838 : fix range() call.
2011-08-25 11:52:26 +02:00
13d2895dbf
Issue #12213 : make it clear that BufferedRWPair shouldn't be called with the
...
same object as reader and writer, and deemphasize it in document order.
2011-08-20 19:48:43 +02:00
9daf98d32a
#12787 : link original MultiCall proposal to webarchive and in a footnote
2011-08-20 17:05:56 +02:00
2513123d66
Update suspicious ignore file.
2011-09-03 09:28:05 +02:00
a47e53e42e
Update sys.platform doc for #12326 .
2011-09-03 09:26:09 +02:00
987b188615
removed misleading editing leftovers
2011-09-02 23:17:39 +02:00
335f204977
#12781 : Mention SO_REUSEADDR flag near socket examples
2011-09-02 20:06:31 +02:00
d86ac4cd4e
Document that format string don’t support arbitrary dictonary keys.
...
Text adapted from the PEP. Addition requested by Terry J. Reedy on
2011-02-23 on python-dev.
2011-09-01 18:59:06 +02:00
7bb769c092
Add version number for versionchanged directive (backport from 3.3)
2011-09-01 05:55:26 +02:00
f3c7822ee5
Adapt/remove mentions of functions gone in 3.x
2011-09-01 03:20:13 +02:00
43ba354599
Fix some misuses of Sphinx roles and one typo
2011-09-01 03:19:30 +02:00
217607ecde
Remove outdated pointer to optparse ( fixes #11360 ).
...
The doc already points to argparse.
2011-08-26 16:38:40 +02:00
72dde45dc6
Document the "optional" argument of distutils’ Extension class
2011-08-26 00:45:18 +02:00
852eea20ef
Close #12838 : fix range() call.
2011-08-25 11:52:26 +02:00
dc42beb55e
Issue #12213 : make it clear that BufferedRWPair shouldn't be called with the
...
same object as reader and writer, and deemphasize it in document order.
2011-08-20 19:48:43 +02:00
6a633bb878
fix description of \r; thanks to Thomas Waldmann from docs@
2011-08-19 22:54:50 +02:00
e1043fc230
fix description of \r; thanks to Thomas Waldmann from docs@
2011-08-19 22:54:50 +02:00
2f394f6666
mention RFC1123 as origin of 4-year digit; thanks to John Haxby from docs@
2011-08-19 18:40:21 +02:00
f693810f69
mention RFC1123 as origin of 4-year digit; thanks to John Haxby from docs@
2011-08-19 18:40:21 +02:00
57bee66c03
Branch merge
2011-08-19 14:22:28 +02:00
355d48ad83
Typo
2011-08-19 09:28:46 +02:00
04ac59a22a
Mention virtual subclasses in the glossary entry for ABCs ( #12256 ).
...
I added a link from the term “virtual subclass” to the glossary entry
for ABCs but this was not enough, now the glossary briefly defines
“virtual” and links to the abc module doc which contains more mentions
of virtual subclasses.
2011-08-19 09:07:46 +02:00
f6854cb0f0
Issue #12672 : remove confusing part of sentence in documentation
2011-08-19 06:29:51 +03:00
729a42f263
Issue #12672 : remove confusing part of sentence in documentation
2011-08-19 06:29:51 +03:00
4d71a66a01
Fix typo in command name
2011-08-19 03:44:36 +02:00
a2d26182e2
Fix instance I missed in 59f7bbe1236c ( #1626300 )
2011-08-19 03:12:38 +02:00
e197df06fb
Remove obsolete term + indicate how to find the program ( #1626300 ).
...
Suggested by Terry J. Reedy.
2011-08-19 02:30:15 +02:00
e8b7eb07e1
Link isinstance/issubclass to the ABC glossary entry ( #12256 )
2011-08-19 02:17:03 +02:00
543edbdab8
Don’t quote characters twice.
...
``code`` markup is enough to mark command-line fragments or to talk
about a character. ``'c'`` is still used for actual Python string
objects. I did a similar change in optparse.rst in r86521.
I’ve also ported two minor changes from the 3.3 version of the file
(removing an unnecessary module name in a class directive, adding a
comma).
2011-08-19 01:45:12 +02:00
fde9242631
Don’t use “arg” for “argument”
2011-08-19 01:30:26 +02:00
19f9b71ffe
Add a few missing source links from 2.7 and harmonize lib docs headers
2011-08-19 00:49:18 +02:00
d001ffe745
Minor improvements to BadZipFile and BadZipfile docs.
...
I made the doc for the compat alias BadZipfile shorter and used a
directive to document deprecation.
I figured there was no point of talking about zipfile.error (“the old
name” that’s older than the other old name BadZipfile) in the 3.x docs
so I just removed it.
2011-08-19 00:44:31 +02:00
5eada94163
Fix markup to get a target instead of a comment
2011-08-19 00:41:23 +02:00
889a7dcb3a
Fix a typo and touch up blank lines
2011-08-19 00:40:46 +02:00
6e7d0ba309
Add missing reST target for one section of this file
2011-08-19 00:39:57 +02:00
0519b09936
Avoid splitting a word between a link and text
2011-08-19 00:39:19 +02:00
b2761186af
#12761 : fix wording of zlib license section
2011-08-16 20:03:11 +02:00
f6b25b9e35
#12761 : fix wording of zlib license section
2011-08-16 20:03:11 +02:00
0656a56214
#12204 : document that str.upper().isupper() might be False and add a note about cased characters.
2011-08-15 14:27:19 +03:00
f42121f27e
#12725 : fix working. Patch by Ben Hayden.
2011-08-14 08:28:57 +03:00
388c945e97
#12725 : fix working. Patch by Ben Hayden.
2011-08-14 08:28:57 +03:00
96d237c40a
Update versions in LICENSE files.
2011-08-13 11:59:12 +02:00
1db1d14e11
Update pydoc topics and suspicious ignore.
2011-08-13 11:33:35 +02:00
7bf4363f77
let PySequence_Check me a link; thanks to tomo cocoa from docs@
2011-08-13 00:39:46 +02:00
8a3b657f9e
it's 'rather than'; reported by James Bateman on docs@
2011-08-12 19:31:32 +02:00
28d39a0c08
Branch merge
2011-08-12 17:40:25 +02:00
817495a631
Issue #12718 : Add documentation on using custom importers.
2011-08-11 13:45:48 +01:00
d9d7bca6da
Use real word in English text (i.e. not code)
2011-08-10 04:19:03 +02:00
77c4fd01dd
note mutating tp_dict is bad ( closes #12719 )
2011-08-09 16:07:01 -05:00
da3f4ae34b
Branch merge
2011-08-09 18:01:38 +02:00
bdbdfb1978
Confirm that the prime example is actually correct. We get so many complaints about a "buggy example" on docs@python, let us hope this cuts them in half at least.
2011-08-08 21:45:13 +02:00
54a1d05877
Branch merge
2011-08-08 16:56:00 +02:00
db79e95195
#12709 : add error_callback argument to map_async documentation
2011-08-08 16:38:13 +02:00
61baee0ee7
#10741 : add documentation for PyGILState_GetThisThreadState()
2011-08-08 00:16:54 +02:00
2a389e4601
#12677 : correct turtle orientation in doc
2011-08-07 17:12:19 +02:00
6ef038e78c
Add documentation for PEP 370 features in distutils ( #10745 ).
...
This started out as an easy task, just add a section describing this
alternate scheme, but I found a lot of cleanup to do along the way:
- fixed inverted reST targets
- fixed entries for modules (hi abiflags!) or data files
- avoided duplicating the same options listing five or six times
- added missing entries for C headers locations
- added documentation for --install-lib
- fixed a few misuses of the option role (see #9312 ), but not all (not
worth the time, but will do it in packaging docs)
- fixed some markup
The paths fixes were done with an eye on the source code in the install
command, so they really describe what’s actually done. The situation on
Mac OS X is rather messy: the fix for #8084 touched site and sysconfig,
but distutils doesn’t use these files. I suspect we have a mismatched
stdlib at the moment, and the fix is not even clear (see the bug report
for further discussion).
2011-08-06 16:30:42 +02:00
ebd4805df0
Fix grammar
2011-08-06 09:31:09 +03:00
2e0153550c
Fix closes Issue12697 - Update the usage syntax of timeit module in the docs.
2011-08-06 13:37:04 +08:00
a3b2316a1b
merge from 2.7 - Fix closes issue11047 - Correct the 2.7 whatsnew description for issue 7902.
2011-08-06 12:54:23 +08:00
de4f05b741
Improve documentation for PEP 370 support in site module ( #8617 ).
...
site.USER_BASE and site.USER_SITE are now fully documented. PEP 370 is
outdated with respects to the Mac framework situation, but the code in
sysconfig and the example in the 3.2 What’s New document helped me find
the right values to document for Mac OS X.
The command-line interface of the site module, partly documented in the
3.2 What’s New, is fully described in the module docs.
The purpose of the usercustomize module is explained in the site docs,
with a gentle introduction in the tutorial (right after the section that
talks about PYTHONSTARTUP; a comment mentions it should be moved from
the tutorial to another file, but that will be another bug).
Various markup and wording improvements were made along the way in the
site module docs. Duplicate and incomplete declarations of environment
variables have also been removed (the original bug report was actually
about these entries :). The site module docs are still a bit messy;
I’ll see about improving them for #11553 .
All these sections are copiously interlinked and findable from the doc
indexes.
2011-08-06 01:51:07 +02:00
86a1a8974d
Fix closes issue12663 - Correcting the ArgumentParser.error description. Patch by Sandro Tosi.
2011-08-03 07:42:18 +08:00
2a8d195328
#12665 : Dictionary view example has error in set operation
2011-08-02 18:42:04 +02:00
692dba244b
#12670 : Fix struct code after forward declaration on ctypes doc
2011-08-02 16:17:14 +02:00
ef5c716176
Fix closes Issue12183 - Explain the Symlink copy behavior in shutil.copytree. Patch by Petri Lehtinen.
2011-08-02 18:52:28 +08:00
aa71583f09
Use attribute access instead of index access for namedtuple.
2011-08-01 22:58:53 +02:00
2ffea0e8d7
Branch merge
2011-08-01 14:43:45 +02:00
952595696a
Closes #12667 : Added documentation for SMTPHandler secure argument.
2011-08-01 11:31:52 +01:00
222e61e444
Fix typo reported by Sandro Tosi.
2011-07-31 22:49:18 +03:00
ab7c1b3f11
Fix regression with distutils MANIFEST handing ( #11104 , #8688 ).
...
The changed behavior of sdist in 3.1 broke packaging for projects that
wanted to use a manually-maintained MANIFEST file (instead of having a
MANIFEST.in template and letting distutils generate the MANIFEST).
The fixes that were committed for #8688 (76643c286b9f by Tarek and
d54da9248ed9 by me) did not fix all issues exposed in the bug report,
and also added one problem: the MANIFEST file format gained comments,
but the read_manifest method was not updated to handle (i.e. ignore)
them. This changeset should fix everything; the tests have been
expanded and I successfully tested the 2.7 version with Mercurial, which
suffered from this regression.
I have grouped the versionchanged directives for these bugs in one place
and added micro version numbers to help users know the quirks of the
exact version they’re using.
Initial report, thorough diagnosis and patch by John Dennis, further
work on the patch by Stephen Thorne, and a few edits and additions by
me.
2011-07-31 04:06:12 +02:00
592563292c
#12531 : Fix spaces and markup.
2011-07-30 21:25:22 +03:00
497cd65cec
add space
2011-07-30 09:59:50 -05:00
50211fa0f9
document NotImplemented
2011-07-30 09:57:24 -05:00
b603b27775
merging Georg's revision
2011-07-30 11:36:41 +03:00
e250358062
Issue #11699 : fix documentation of OptionParser.get_option_group. Patch by Petri Lehtinen
2011-07-30 11:14:32 +03:00
eea6cda91a
Change test.support docs to be more specific about the nature of this module.
2011-07-30 09:00:48 +02:00
7bd081c117
Issue #12531 : add index entries to documentation of * and ** in function calls
2011-07-30 07:05:16 +03:00
fe1e298d8b
Document that atexit execution order is undefined ( #9788 )
2011-07-29 18:04:24 +02:00
63b18a4445
Add a link target for argparse.Namespace ( #8982 )
2011-07-29 17:59:17 +02:00
e801aa2a1d
Let the doc of __import__ link to importlib ( #9254 ).
...
importlib.import_module eschews a number of issues that __import__ has.
Reviewed by Brett Cannon. (The docstring of __import__ was already
updated in 3d490c3a019e, for #7397.)
2011-07-29 17:50:58 +02:00
158d7696f3
Branch merge
2011-07-29 14:24:08 +02:00
ef4902af87
Issue #12644 : document the '%a' conversion in the old string formatting operations. Patch prepared together with Ezio Melotti
2011-07-29 09:30:42 +03:00
cf534817ad
Branch merge
2011-07-28 23:08:11 +02:00
fc662ddda2
Merge profile docs followup ( #12417 ) from 3.1
2011-07-28 23:00:14 +02:00
ee19c772cb
Remove mentions of previous license in profile module docs ( #12417 followup).
...
Also remove an extra docstring.
2011-07-28 22:56:24 +02:00
f5e10d1f70
Turn raw URI into real link
2011-07-28 22:50:18 +02:00
14382dc887
Update documentation for shutil.move ( #12043 ) and fix a few typos.
...
Adding Sandro Tosi to Doc/ACKS for this patch and all his work on the
docs mailing list and on the bug tracker.
2011-07-28 22:49:11 +02:00
72db3459e4
Make indentation comply with our style guide and the rest of the file
2011-07-26 16:54:24 +02:00
59e387eb40
Fix “anyways” (following R. David Murray in 4d5a546b6186)
2011-07-26 16:53:17 +02:00
7c12bae717
Fix reST references
2011-07-26 15:14:35 +02:00
59c01edcaa
Issue #12102 : Document that buffered files must be flushed before being used
...
with mmap. Patch by Steffen Daode Nurpmeso.
2011-07-25 07:12:43 +02:00
06ad13ee7c
Fix function name: open -> urlopen.
2011-07-23 08:04:40 +02:00
bca31b5d1f
#11435 : link to the correct branch.
2011-07-21 09:35:19 +03:00
96c84a4c7d
Fix closes issue12524 - update http.client POST example with a working example.
2011-07-20 21:56:24 +08:00
ae4a78b0a8
Fix closes issue12577 - clarify shutil.move documentation. Patch suggestion by Catalin Iacob
2011-07-19 08:03:02 +08:00
0e752dd3f8
Issue #6476 : Document that os.spawnle and os.spawnve are not thread-safe under Windows.
2011-07-19 01:26:58 +02:00
b899007268
Better English.
2011-07-18 12:38:03 -04:00
3e7f33fc82
fix whitespace nit.
2011-07-18 07:17:20 +08:00
0215d09ca9
Fix closes Issue12478 - HTTPErrorProcess 's methods are http_response and https_response.
2011-07-18 07:12:40 +08:00
ed270fab64
Fix closes Issue12479 - Add HTTPErrorProcessor class definition - Patch by Sandro Tosi
2011-07-18 06:42:46 +08:00
023c6f703d
Fix Issue10403 - datetime documentation clarification based on review in the reitveld by Alexendar belopolsky.
2011-07-17 19:01:14 +08:00
ad3882a2b0
Fix closes Issue11436 - Minor clarification to struct documentation for 's' format character.
2011-07-17 17:29:17 +08:00
58e3350bd4
Issue #12549 : Correct test_platform to not fail when OS X returns 'x86_64'
...
as the processor type on some Mac systems. Also fix NameError in fallback
_mac_ver_gestalt function. And remove out-of-date URL in docs.
2011-07-13 15:07:04 -07:00
fd060474e3
Make it clear that PyNumber_AsSsize_t() returns -1 on error.
2011-07-13 21:02:22 +02:00
325eb470b7
Clarify that PyErr_NewException creates an exception *class*, not instance.
2011-07-13 15:59:24 +02:00
b3593cada2
Use infinitive, not 3rd person of present tense.
2011-07-11 01:39:19 +02:00
6f5dcb1ee2
Issue #12343 : Add some notes on behaviour of non-blocking SSL sockets.
2011-07-11 01:35:48 +02:00
cdddf2b875
Mention logging.captureWarnings in the warnings module doc.
2011-07-09 21:29:36 +02:00
462d1b39a4
Move sys.subversion at the right place in alphabetical order, and informally deprecate it.
2011-07-09 16:02:19 +02:00
a83cdaae89
Issue #12326 : document the recommended idiom for checking sys.platform on Unix systems.
...
Also, point to the various alternatives.
2011-07-09 15:54:23 +02:00
6e2e3b9e81
Issue #12423 : Fix os.abort() documentation
...
The Python signal handler for SIGABRT is not called on os.abort() (only if the
signal is raised manually or sent by another process). Patch by Kamil Kisiel.
2011-07-08 02:26:39 +02:00
3aac179498
Fix whitespace nit in datetime and os rst files.
2011-07-04 11:43:51 -07:00
a6bac95a3c
issue10403 - Let's not use members anymore. Use 'attribute' where it denotes attribute and 'methods' where it denotes methods. Context should clarify usage.
2011-07-04 11:28:30 -07:00
bfd1edd155
Merge 3.2.1 release clone changes into main 3.2 branch after 3.2.1rc2 release.
2011-07-04 19:55:22 +02:00
946eb865a3
reST indentation fix in sqlite3 docs. rst uses 3 space indentation.
2011-07-03 10:17:22 -07:00
f069100d0d
Fix bad markup.
2011-07-03 09:39:49 +02:00
7f3cd98beb
Fix target path in message.
2011-07-03 09:30:42 +02:00
40d9ebe031
Issue #12228 : Fix exchanged flag descriptions in stat.rst. Thanks Sandro Tosi.
2011-06-25 12:03:33 +02:00
fe9230aac6
Fix closes issue12261 - Minor documention changes in the urllib.parse.rst
2011-06-19 13:52:49 -07:00
ac4e5abc78
#12147 : make send_message correctly handle Sender and Resent- headers.
...
Original patch by Nicolas Estibals. My tweaks to the patch were mostly
style/cosmetic, and adding more tests.
2011-07-02 21:03:19 -04:00
3eb67d58d6
Issue #8746 : Correct faulty configure checks so that os.chflags() and
...
os.lchflags() are once again built on systems that support these
functions (*BSD and OS X). Also add new stat file flags for OS X
(UF_HIDDEN and UF_COMPRESSED). Also add additional tests for
os.chflags() and os.lchflags(). (Tests by Garrett Cooper)
2011-06-28 00:00:28 -07:00
b34705ff37
Issue #8890 : Remove /tmp from examples.
2011-06-26 15:29:06 +02:00
4850d52b4d
#11363 : add missing functions from curses doc. Patch by Sandro Tosi.
2011-06-26 13:34:56 +03:00
b6b7371329
#11363 : clean up curses doc.
2011-06-26 13:38:11 +03:00
fc3db8a91e
#11669 : rephrase footnote in the Compound Statements page.
2011-06-26 11:25:28 +03:00
54cc5fd72d
Use correct markup in zipimport.rst. Patch by Sara Magliacane.
2011-06-25 19:40:06 +03:00
6ddefd7916
Issue 12086: add example showing how to use name mangling.
2011-06-25 16:30:39 +02:00
9d3df6d508
Issue 11889: Clarify docs for enumerate.
2011-06-25 15:00:14 +02:00
7e4b5c6773
Merge #12228
2011-06-25 12:04:08 +02:00
Ezio Melotti
Antoine Pitrou
Sandro Tosi
Nick Coghlan
R David Murray
Brian Curtin
Petri Lehtinen
Hynek Schlawack
Vinay Sajip
Mark Dickinson
Georg Brandl
Ned Deily
Senthil Kumaran
Raymond Hettinger
Martin v. Löwis
Eli Bendersky
Jason R. Coombs
Éric Araujo
Larry Hastings
Gregory P. Smith
Terry Jan Reedy
Nadeem Vawda
Benjamin Peterson
Brett Cannon
Meador Inge
Charles-François Natali
Victor Stinner
Lars Gustäbel
Amaury Forgeot d'Arc
Florent Xicluna
Łukasz Langa
Ross Lagerwall