15251a99bb
Add glossary references
2012-08-24 19:49:08 +02:00
cbf9d5f6cd
Issue #14674 : Add a discussion of the json module's standard compliance.
...
Patch by Chris Rebert.
2012-08-24 19:39:47 +02:00
331624b67d
Issue #14674 : Add a discussion of the json module's standard compliance.
...
Patch by Chris Rebert.
2012-08-24 19:37:23 +02:00
83c0ae5de6
Address most of Ezio's comments. str/bytes/bytearray docs still need consolidation
2012-08-21 17:42:52 +10:00
609939e22f
Issue #14954 : Clarify the interaction of weak references and garbage collection.
...
Patch by Ethan Furman.
2012-08-21 00:07:35 +02:00
9439f04b9a
Issue #14954 : Clarify the interaction of weak references and garbage collection.
...
Patch by Ethan Furman.
2012-08-21 00:07:07 +02:00
1ea50f5608
Merge #15742 : clarify sqlite parameter substitution example.
...
Suggestion and patch by Mike Hoy.
2012-08-20 14:14:46 -04:00
f6bd1b0e0d
#15742 : clarify sqlite parameter substitution example.
...
Suggestion and patch by Mike Hoy.
2012-08-20 14:14:18 -04:00
bac9a53d00
Break up the 'someos' docs classification based on a more user-focused scheme, including creation of a separate 'Concurrent Execution' section
2012-08-20 18:05:46 +10:00
273069cf7d
Close #4966 : revamp the sequence docs in order to better explain the state of modern Python
2012-08-20 17:14:07 +10:00
a8517ad3d9
Issue #14814 : document the Interface APIs and fix various problems with the string representations (initial patch by Eli Bendersky).
2012-08-20 10:04:26 +10:00
749bd42072
Merge #13579 : teach string.Formatter about 'a'.
...
Patch by Francisco Martín Brugué.
2012-08-19 17:45:40 -04:00
e56bf97ef4
#13579 : teach string.Formatter about 'a'.
...
Patch by Francisco Martín Brugué.
2012-08-19 17:26:34 -04:00
a1b0f6d9be
Issue #15586 : fix prompts in some documentation examples
2012-08-18 05:42:22 +03:00
cd7128a549
Merge #15636 : add versionadded for decodebytes
2012-08-17 20:55:54 -04:00
75fd22519f
#15636 : add versionadded for decodebytes
2012-08-17 20:55:21 -04:00
ed7fb9c74d
Merge #15694 : reflow paragraph.
2012-08-17 20:40:03 -04:00
433ef3b5c3
#15694 : reflow paragraph.
2012-08-17 20:39:21 -04:00
8eac575e81
Merge #15694 : Link discussion of file objects to glossary entry.
...
This is analogous to the link for `flie objects` in the description of
'open' that exists in the 2.7 docs, and adds a similar link to the
io docs.
Patch by Chris Jerdonek.
2012-08-17 20:38:19 -04:00
9f0c9401d3
#15694 : Link discussion of file objects to glossary entry.
...
This is analogous to the link for `flie objects` in the description of
'open' that exists in the 2.7 docs, and adds a similar link to the
io docs.
Patch by Chris Jerdonek.
2012-08-17 20:33:54 -04:00
bbfe573d9d
Merge with 3.2 #15660
2012-08-17 15:42:12 -04:00
f6190c1463
Issue 15660: Clarify 0 prefix for width field in str.format doc.
2012-08-17 15:40:46 -04:00
1b79918641
Issue #15640 : Document importlib.abc.Finder as deprecated.
...
The code for the class itself isn't deprecated for
backwards-compatibility reasons, but the class shouldn't be directly
inherited by anyone anymore as the API is no longer as widely valid as
it used to be.
2012-08-17 14:08:24 -04:00
b391b24efe
Merge
2012-08-17 15:05:09 +01:00
d9c026fd77
Issue #15412 : Remove erroneous note about weakrefs
2012-08-17 15:02:47 +01:00
67a58cc515
Merge
2012-08-17 14:42:43 +01:00
264e9ac5f5
Issue #14501 : Clarify that authentication keys are byte strings
2012-08-17 14:39:18 +01:00
d9a7e70939
Update the getpeercert() example with a real-world cert showing non-trivial issuer, subject and subjectAltName.
2012-08-16 22:18:37 +02:00
b7c6c8105e
Update the getpeercert() example with a real-world cert showing non-trivial issuer, subject and subjectAltName.
2012-08-16 22:14:43 +02:00
0689ce4396
#15543 : reflow paragraph.
2012-08-15 11:13:31 -04:00
99d439afcf
#15543 : additional link in subprocess docs.
...
Patch by Chris Jerdonek.
2012-08-15 11:12:15 -04:00
27bbcfb8ff
Merge #15543 : glossary entry for and 'universal newlines', and links to it.
...
Patch by Chris Jerdonek.
2012-08-15 11:11:27 -04:00
ee0a945ae4
#15543 : reflow paragraphs.
2012-08-15 11:05:36 -04:00
1b00f25bf9
#15543 : glossary entry for and 'universal newlines', and links to it.
...
Patch by Chris Jerdonek.
2012-08-15 10:43:58 -04:00
3115f0d14b
Issue #15586 : typo fix. This commit is accompanied by an apology for all Liechtensteiners out there, and a thanks to Eric Araujo for noticing.
2012-08-15 14:26:30 +03:00
7f84833726
Merge #15269 : document dircmp.left and right, and add tests for them.
...
Patch by Chris Jerdonek.
2012-08-14 21:45:25 -04:00
2b209cd78d
#15269 : document dircmp.left and right, and add tests for them.
...
Patch by Chris Jerdonek.
2012-08-14 21:40:13 -04:00
e471772fff
Review of signature docs.
2012-08-14 09:45:28 +02:00
1487c931cb
merge with 3.2
2012-08-14 09:40:26 +02:00
296d1bea6a
Restore original line lengths.
2012-08-14 09:39:07 +02:00
0f4e934174
Issue #15586 : add some examples to ElementTree documentation. Patch by Daniel Ellis.
2012-08-14 07:19:33 +03:00
f334f740e4
Issue #15497 : Correct characters in TextWrapper.replace_whitespace docs.
...
Patch by Chris Jerdonek.
2012-08-13 23:23:02 +03:00
59db401667
Issue #15497 : Correct characters in TextWrapper.replace_whitespace docs.
...
Patch by Chris Jerdonek.
2012-08-13 23:22:23 +03:00
a86565465a
Push importlib ABC hierarchy chart.
2012-08-13 22:19:01 +03:00
4805fa862e
Issue #15561 : Update subprocess docs to reference io.TextIOWrapper.
...
Patch by Chris Jerdonek.
2012-08-13 22:11:14 +03:00
50be452e0f
Issue #15561 : Update subprocess docs to reference io.TextIOWrapper.
...
Patch by Chris Jerdonek.
2012-08-13 22:09:04 +03:00
eed1808dec
Minor update of docs for inspect module.
2012-08-13 18:23:54 +03:00
4e48bf929b
Issue #15151 : PEP 362 — document signature and related classes for inspect.py
...
Initial patch by Yury Selivanov
2012-08-13 17:10:28 +03:00
e4b1a189a7
Issue #15624 : clarify newline documentation for open and io.TextIOWrapper
...
Thanks to Chris Jerdonek
2012-08-13 12:59:00 +03:00
ecd78feb78
Issue #15624 : clarify newline documentation for open and io.TextIOWrapper
...
Thanks to Chris Jerdonek
2012-08-13 12:58:02 +03:00
2e64a0b6ff
merge with 3.2
2012-08-12 17:34:13 +02:00
c7b0e217e2
add usage example from cli; thanks to Christian Clauss from docs@
2012-08-12 17:34:00 +02:00
c254f640a7
merge with 3.2
2012-08-12 15:35:43 +02:00
6cbe405a20
escape '\'; thanks to Steve Holden from docs@
2012-08-12 15:35:25 +02:00
5bb665f00c
merge with 3.2
2012-08-12 15:12:32 +02:00
985104a20c
it's getstatus() not setstatus(); thanks to Shaddi Hasan from docs@
2012-08-12 15:12:15 +02:00
439e17fb0b
update doctests
2012-08-12 15:16:42 +03:00
199b78d41a
fix doctest for email.header docs
2012-08-12 14:49:59 +03:00
5a5e8dd931
merge with 3.2
2012-08-12 12:35:31 +02:00
82a509ca75
add missing quote in splitlines() example; thanks to Yevgen Yampolskiy from docs@
2012-08-12 12:35:14 +02:00
effb43bc38
merge with 3.2
2012-08-12 10:49:40 +02:00
ee903c5125
add missing parenthesis to 'action' argparse doc; thanks to kishkin from docs@
2012-08-12 10:49:26 +02:00
ea47530e14
update CodeTools link; thanks to Robert Kern from docs@
2012-08-12 10:37:23 +02:00
a6e8581449
Minor doc formatting cleanup.
2012-08-11 19:41:27 -04:00
a2fe334081
Issue #15527 : fix docs, remove double parens by changing markup.
...
Patch by Serhiy Storchaka.
2012-08-11 21:14:08 +03:00
b79be95dac
Issue #15444 : Use proper spelling for non-ASCII contributor names.
...
Patch by Serhiy Storchaka.
2012-08-11 16:54:27 +02:00
fbd4f80979
Issue #15444 : Use proper spelling for non-ASCII contributor names.
...
Patch by Serhiy Storchaka.
2012-08-11 16:51:50 +02:00
ac9f2f3de3
Issue #15576 : Allow extension modules to be a package's __init__
...
module again. Also took the opportunity to stop accidentally exporting
_imp.extension_suffixes() as public.
2012-08-10 13:47:54 -04:00
f4dc9204cc
Issue #15502 : Finish bringing importlib.abc in line with the current
...
state of the import system. Also make importlib.invalidate_caches()
work with sys.meta_path instead of sys.path_importer_cache to
completely separate the path-based import system from the overall
import system.
Patch by Eric Snow.
2012-08-10 12:21:12 -04:00
eec6420de4
Issue #15501 : Document exception classes in subprocess module.
...
Initial patch by Anton Barkovsky.
2012-08-09 15:20:45 +03:00
b4a09abfce
Issue #15501 : Document exception classes in subprocess module.
...
Initial patch by Anton Barkovsky.
2012-08-09 15:11:45 +03:00
e939f383c1
Fix documentation for inspect module to pass doctest
2012-08-09 13:25:32 +03:00
cb4996afe4
Issue #15471 : Don't use mutable object as default values for the
...
parameters of importlib.__import__().
2012-08-06 16:34:44 -04:00
638de338e6
Merge #15554 : clarify splitlines/split differences.
...
Patch by Chris Jerdonek.
2012-08-06 16:08:40 -04:00
05c35a6a6b
#15554 : clarify splitlines/split differences.
...
Patch by Chris Jerdonek.
2012-08-06 16:08:09 -04:00
222d473df4
Issue #15482 : Merge 78449:3fe01f7520e2 with a minor clarification.
2012-08-05 20:49:53 -04:00
9b000e7a68
Issue #15482 : Properly document the default 'level' parameter for
...
__import__().
To help explain why the -1 default value is typically not seen, a note
about how import statements only use values of >= 0 is also noted.
2012-08-05 20:46:25 -04:00
62bb394729
Close #13072 : Restore code before the PEP 393 for the array module
...
'u' format of the array module uses again Py_UNICODE type for backward
compatibility with Python 3.2.
The only change from Python 3.2 is that PyUnicode_AsUnicode() result is now
checked for NULL value.
2012-08-06 00:46:05 +02:00
69a6ca5260
os.unlinkat() has been removed, update os.fwalk() doc
2012-08-05 15:18:02 +02:00
31096a94e7
Issue #14814 : Attempt to clarify network address and broadcast address for less experienced users
2012-08-05 22:52:38 +10:00
7362c3efeb
Issue #14814 : Finish review of ipaddress network object docs (initial patch was by Eli Bendersky)
2012-08-05 22:32:37 +10:00
730f67f2fa
Issue 14814: Docs work showed some more cases of networks pretending to be addresses and highlighted the weird approach to implementing the 'is_whatever' properties. Impl now illustrates far more clearly that networks have a property if both their network and broadcast addresses have that property
2012-08-05 22:02:18 +10:00
15f3d1e266
Issue #12655 : Mention multiprocessing.cpu_count() in os.sched_getaffinity() doc
2012-08-04 20:57:48 +02:00
848698727f
Issue #12655 : Instead of requiring a custom type, os.sched_getaffinity and
...
os.sched_setaffinity now use regular sets of integers to represent the
CPUs a process is restricted to.
2012-08-04 16:16:35 +02:00
d1f9352bd4
(Merge 3.2) open() / TextIOWrapper doc: make it explicit than newline='\n'
...
doesn't translate newlines on output.
2012-08-04 01:22:07 +02:00
401e17d0f0
open() / TextIOWrapper doc: make it explicit than newline='\n' doesn't
...
translate newlines on output.
2012-08-04 01:18:56 +02:00
3c25dfbf13
Make TextIOWrapper's documentation clearer by copying the newline argument's description from open().
2012-08-04 00:56:19 +02:00
0c1c0d42dc
Make TextIOWrapper's documentation clearer by copying the newline argument's description from open().
2012-08-04 00:55:38 +02:00
077ef45a74
Update the What's New details for importlib based on doc/ABC changes.
2012-08-02 17:50:06 -04:00
773468f3a9
Ditch the 'self' argument in importlib docs since it's implied.
2012-08-02 17:35:34 -04:00
4941774f59
Issue #15502 : Bring the importlib.PathFinder docs and docstring more in line with the new import system documentation, and fix various parts of the new docs that weren't quite right given PEP 420 or were otherwise a bit misleading. Also note the key terminology problem still being discussed in the issue
2012-08-02 23:03:58 +10:00
ff79486bb5
Close #15519 : Properly expose WindowsRegistryFinder in importlib and bring the name into line with normal import terminology. Original patch by Eric Snow
2012-08-02 21:45:24 +10:00
8a9080feff
Issue #15502 : Bring the importlib ABCs into line with the current state of the import protocols given PEP 420. Original patch by Eric Snow.
2012-08-02 21:26:03 +10:00
9a5af1288d
merge
2012-07-31 16:03:25 -04:00
0e49749f31
Issue #14814 : reorganize ipaddress documentation and document all attributes of IPv[46]Address objects
2012-07-31 17:23:11 +03:00
1713f9ae5e
Update the string limit in the faulthandler documentations
2012-07-31 03:25:28 +02:00
60622ed12a
Minor markup tweak.
2012-07-30 19:31:00 -04:00
73df364ee6
Add a versionchanged mention to __import__ in regards to negative level values.
2012-07-30 18:35:17 -04:00
d7d2194ea1
Integration of importdocs from the features/pep-420 repo.
2012-07-29 16:36:17 -04:00
69f343941f
Issue #15041 : update "see also" list in tkinter documentation.
2012-07-26 17:16:24 +03:00
e708a8a4aa
Issue #15041 : update "see also" list in tkinter documentation.
2012-07-26 17:02:57 +03:00
c5618f039d
Mention the *limit* argument of TextIO.readline().
2012-07-25 22:40:05 +02:00
707bd4e385
Mention the *limit* argument of TextIO.readline().
2012-07-25 22:38:33 +02:00
f7dbb0f64e
Closes #15445 : Merged documentation update from 3.2.
2012-07-25 19:20:32 +01:00
393e23fbb5
Issue #15445 : Updated logging configuration documentation to highlight potential security risk posed by listen() in certain scenarios.
2012-07-25 19:19:25 +01:00
f7a54a0f12
Cleanup the doc a bit: remove useless example and sentence
2012-07-24 20:44:48 +03:00
e431ed2354
Clarify what happens if shallow is false. Also, the caching note is not really correct since the cache gets occasionally cleared; therefore I removed it.
2012-07-24 19:47:34 +03:00
d74062948d
- Issue #15250 : Document that filecmp.dircmp compares files shallowly. Patch contributed by Chris Jerdonek.
2012-07-22 19:31:36 -07:00
28a9f2193a
- Issue #15250 : Document that filecmp.dircmp compares files shallowly. Patch contributed by Chris Jerdonek.
2012-07-22 19:12:58 -07:00
4fb6b0a104
Merge #15429 : Fix invalid mention of types.NoneType from None docs.
2012-07-22 20:43:42 -04:00
e60e12b57a
#15429 : Fix invalid mention of types.NoneType from None docs.
2012-07-22 20:43:13 -04:00
5116704ec5
Issue #15410 : Fix the urllib.request.Request.is_unverifiable deprecation documentation.
2012-07-20 19:50:41 -05:00
5e1658c5d7
Closes #15399 : merged documentation fix from 3.2.
2012-07-20 09:51:20 +01:00
3be7a8bbcf
Issue #15399 : Added versionchanged for processName.
2012-07-20 09:50:18 +01:00
26fe37dd3f
#1492704 : Backout and wait for 3.4
2012-07-19 21:41:02 +02:00
77d3283370
#1492704 : Make shutil.copyfile() raise a distinct SameFileError
...
Patch by Atsuo Ishimoto.
2012-07-19 20:23:49 +02:00
c5afd42df8
Fix importlib.machinery.all_suffixes docs
2012-07-18 23:59:08 +10:00
76e077001d
Close #15387 : inspect.getmodulename() now uses a new importlib.machinery.all_suffixes() API rather than the deprecated inspect.getmoduleinfo()
2012-07-18 23:14:57 +10:00
90db661b43
Closes #15307 : symlinks now work on OS X with framework Python builds. Patch by Ronald Oussoren.
2012-07-17 17:33:46 +01:00
b22ba046ae
Fix typo
2012-07-16 02:07:41 -07:00
b2269baca3
Clean-up example
2012-07-15 23:53:32 -07:00
2a61c451f2
cm.parents is property, not a method
2012-07-15 22:37:20 -07:00
950b76ab1a
Doc fix: the text role is called "func", not "funk".
2012-07-15 17:32:36 -07:00
7aa2c8baae
Issue #15202 : Additional documentation fixes inadvertently omitted
...
from previous checkin.
2012-07-15 16:58:29 -07:00
b40380667c
Issue #15202 : Consistently use the name "follow_symlinks" for
...
new parameters in os and shutil functions. Patch by Serhiy Storchaka.
2012-07-15 10:57:38 -07:00
8ecf50474c
Issue #15343 : Handle importlib.machinery.FileFinder instances in pkgutil.walk_packages (et al)
2012-07-15 21:19:18 +10:00
85e729ec3b
Take the first step in resolving the messy pkgutil vs importlib edge cases by basing pkgutil explicitly on importlib, deprecating its internal import emulation and setting __main__.__loader__ correctly so that runpy still works (Affects #15343 , #15314 , #15357 )
2012-07-15 18:09:52 +10:00
f96cf911a0
Issue #9458 : clarify the documentation of ElementTree.write with regards to the type of the stream expected for a given encoding
2012-07-15 06:19:44 +03:00
00f402bfcb
Close #1767933 : Badly formed XML using etree and utf-16. Patch by Serhiy Storchaka, with some minor fixes by me
2012-07-15 06:02:22 +03:00
1191709b13
- Issue #15233 : Python now guarantees that callables registered with
...
the atexit module will be called in a deterministic order.
2012-07-14 18:20:37 -07:00
ad5ae0456e
- Issue #15238 : shutil.copystat now copies Linux "extended attributes".
2012-07-14 17:55:11 -07:00
15810673dc
Minor grammatical tweaks.
2012-07-14 14:30:48 -04:00
f877a7cce1
Some small fixes and clarifications to the io documentation
2012-07-14 21:22:25 +03:00
24711c4fac
Merge #15230 doc updates from 3.2
2012-07-15 00:38:43 +10:00
a3d1cac4b2
Issue #15230 : Update runpy docs to clarify a couple of points that came up in this issue
2012-07-15 00:36:39 +10:00
d104eef118
Issue #15053 : Make sure all functions related to the import lock have
...
the Python 3.3 change notice on them in case someone directly links to
the function(s).
2012-07-13 11:26:19 -04:00
52cc722ab8
Add c_size_t and c_ssize_t to the ctypes summary table.
2012-07-12 20:31:50 +02:00
921d1244c6
Show the proper way to exit a cmd shell
2012-07-12 11:26:01 -07:00
78da3bc0af
Additional fixes to multiprocessing docs (for issue #13686 )
2012-07-13 10:10:05 +03:00
8a80502d2c
Issue #15296 : Fix minidom.toxml/toprettyxml for non-unicode encodings. Patch by Serhiy Storchaka, with some minor style adjustments by me.
2012-07-13 09:52:39 +03:00
b674dcf53e
Some fixes for the documentation of multiprocessing (per issue #13686 )
2012-07-13 09:45:31 +03:00
e08824c300
Remove :noindex: for threading.Thread which killed all reference links to it
2012-07-13 09:01:57 +03:00
c128167318
Add c_size_t and c_ssize_t to the ctypes summary table.
2012-07-12 20:32:11 +02:00
77f7a9bcc9
merge
2012-07-12 11:26:56 -07:00
c4618e33b2
Factored out common venv documentation and added more information about Distribute/pip.
2012-07-10 08:21:07 +01:00
f07d949367
Fix markup
2012-07-09 12:43:57 -07:00
5c453ce3a4
Use the proper term.
2012-07-09 14:40:38 -04:00
b19449751f
Issue #15288 : Clarify that pkgutil.walk_packages() and friends will no
...
longer work as expected in Python 3.3 as importlib's loaders do not
implement the non-standard iter_modules() method. Also link to the
term "loader" in the requisite notes to help make it clearer what has
happened.
2012-07-09 14:10:23 -04:00
19a2f5961c
Issue #15056 : imp.cache_from_source() and source_from_cache() raise
...
NotimplementedError when sys.implementation.cache_tag is None.
Thanks to Pranav Ravichandran for taking an initial stab at the patch.
2012-07-09 13:58:07 -04:00
cd9b746b37
Added cross-references to venv definition.
2012-07-09 10:37:01 +01:00
a945ad1a12
Issue #15283 : Updated pyvenv documentation to expand on activation.
2012-07-09 09:24:59 +01:00
9ae9473389
Make it easier to search for the grouper() recipe.
2012-07-08 16:04:03 -07:00
86a20f834a
Issue 15265: document the exception raised for invalid sample sizes.
2012-07-08 16:01:53 -07:00
dd445e8ece
Merge 3.2 closes issue 13557
2012-07-08 17:52:58 -04:00
83efd6cbb6
Issue #13557 : Clarify effect of giving two different namespaces to exec or
...
execfile().
2012-07-08 17:36:14 -04:00
ac3f4f3133
Fix markup for versionchanged sphinx directive.
2012-07-08 01:32:57 -07:00
a5e0eaf2e1
Fix 5931 - Python runtime hardcoded in wsgiref.simple_server - Now it specifies an implementation specific term.
2012-07-07 14:29:58 -07:00
109d57358e
Issue #13248 : io: Remove obsolete argument "max_buffer_size" of BufferedWriter and BufferedRWPair.
2012-07-07 17:03:22 +02:00
2240ac1eae
Issue #15261 : Stop os.stat(fd) crashing on Windows when fd not open.
2012-07-06 12:05:32 +01:00
abd344cbab
Issue 15241: Improved site.py documentation relating to venvs.
2012-07-03 16:33:57 +01:00
1e331560ee
Closes #15030 : Make importlib.abc.PyPycLoader respect the new .pyc
...
file size header field.
Thanks to Marc Abramowitz and Ronan Lamy for helping out with various
parts of the patch.
2012-07-02 14:35:34 -04:00
c9d2fc390d
Merge with 3.2.
2012-07-01 09:56:07 +02:00
29feb1ffca
Make call of os.getppid() conditional: it is not available on Windows.
2012-07-01 09:47:54 +02:00
0b50bf3ffc
urlparse docs clean up - no reference to earlier draft
2012-06-28 21:08:27 -07:00
4a27d9fb46
urlparse docs clean up - no reference to earlier draft
2012-06-28 21:07:58 -07:00
802d669044
Issue #5067 : improve some json error messages.
...
Patch by Serhiy Storchaka.
2012-06-29 01:59:54 +02:00
2d24e94bbe
Issue #5067 : improve some json error messages.
...
Patch by Serhiy Storchaka.
2012-06-29 01:58:26 +02:00
5d2ecfb780
Fix typo in shutil doc
2012-06-27 17:53:22 +02:00
13c668229c
issue13666 - merge from 3.2
2012-06-26 20:01:06 +08:00
72a80e85a8
issue13666 - Fixing datetime documentation example when using tzinfo
2012-06-26 20:00:15 +08:00
ee0be40f29
Add yet another missing versionchanged.
2012-06-26 09:14:40 +02:00
9aae9e5e6b
Fix a few markup nits in zlib docs and add missing versionchanged tags.
2012-06-26 08:51:17 +02:00
93e3d3ac09
merge from 3.2 - Issue13685
2012-06-26 14:18:19 +08:00
f21804ad61
Issue #13685 - Update argparse help message for % sign usage.
2012-06-26 14:17:19 +08:00
c48fe98a7c
Issue #15177 : Added dir_fd parameter to os.fwalk().
2012-06-25 04:49:05 -07:00
fdaea06d3c
Issue #15176 : Clarified behavior, documentation, and implementation
...
of os.listdir().
2012-06-25 04:42:23 -07:00
77892dc1e3
More doc fixes: made it clear where to start reading when you click on <dir_fd>.
2012-06-25 03:27:33 -07:00
aceaf90804
Some tightening of the documentation for the new kwarg-style os module functionality.
2012-06-25 08:33:56 +02:00
48986d68c2
Minor grammar refinement for hmac.compare_digest().
2012-06-25 00:59:34 -07:00
4d399a4092
Grammar fix.
2012-06-25 07:40:32 +02:00
68386bc0b8
Issue #15164 : Change return value of platform.uname() from a
...
plain tuple to a collections.namedtuple.
2012-06-24 14:30:41 -07:00
61063cca6a
Fix a couple of versionadded/versionchanged related markup errors.
2012-06-24 22:48:30 +02:00
33369cf9a5
Fix a bunch of "versionchanged" related markup errors.
2012-06-24 22:48:03 +02:00
217aa554fa
Fix markup, for real this time.
2012-06-24 22:26:21 +02:00
b0f0895849
Fix indentation
2012-06-24 16:22:09 -04:00
46495182d0
#15156 : HTMLParser now uses the new "html.entities.html5" dictionary.
2012-06-24 22:02:56 +02:00
56261cff16
Branch merge
2012-06-24 13:54:22 -04:00
544e13d126
Fix markup
2012-06-24 13:53:48 -04:00
0a8f5f709a
Fix typos
2012-06-24 13:53:41 -04:00
19c4e5bb39
Fix test__locale on Mac; platform.uname() does not have a structseq-type interface (yet).
2012-06-24 19:29:49 +02:00
03b9ad05d6
Add a single versionadded for a whole section instead of repeating for every function.
2012-06-24 18:09:40 +02:00
96acb73dd5
Small whitespace fixes for shutil.rmtree() docs.
2012-06-24 17:39:05 +02:00
4a7e25f4df
#444582 : fix example and rewrap docs a bit.
2012-06-24 17:37:07 +02:00
dbab58fdeb
Refactor the venv API docs into a real API doc style.
2012-06-24 16:37:59 +02:00
5f762af3bc
Remove a detailed discussion of content-based short circuiting, off topic for library docs.
2012-06-24 16:23:54 +02:00
f61e7910ea
Simplify wording.
2012-06-24 16:21:10 +02:00
1524d7556d
Formatting
2012-06-24 16:18:48 +02:00
1729b8f45b
Fix doc of os.fwalk: example used now non-existing os.fstatat()
2012-06-24 16:11:08 +02:00
ae64b4d8e2
Merge heads.
2012-06-24 16:11:23 +02:00
3b44d81cf9
Merge heads.
2012-06-24 16:10:47 +02:00
a1bc35f07f
Improve hmac.compare_digest() docstring and documentation, courtesy of Larry H.
2012-06-24 16:07:33 +02:00
4f9946874b
The buffer protocol doesn't exist (in the glossary anyway).
2012-06-24 16:04:38 +02:00
9df73dac84
Larry's suggested rewording of the compare_digest() docs.
2012-06-24 16:03:50 +02:00
6cff9ffab0
Fix use of class markup.
2012-06-24 14:05:40 +02:00
6cea65555c
Issue #15061 : Re-implemented hmac.compare_digest() in C
2012-06-24 13:48:32 +02:00
605a62ddb1
Issue #15118 : Change return value of os.uname() and os.times() from
...
plain tuples to immutable iterable objects with named attributes
(structseq objects).
2012-06-24 04:33:36 -07:00
f62445ad30
Fix casing of Unix.
2012-06-24 13:31:20 +02:00
8a5555f792
Make the style of the "Availability" sections consistent.
2012-06-24 13:29:09 +02:00
a570e98e7b
Actually it is just one function.
2012-06-24 13:26:22 +02:00
b2462e2b8c
Minor clarification about fdopen().
2012-06-24 13:24:56 +02:00
b8f2d29ea9
Remove attribution; this is for the whatsnew.
2012-06-24 13:06:44 +02:00
306336bcda
Closes #15161 : add support for giving path as a fd for truncate() and pathconf().
2012-06-24 12:55:33 +02:00
8ccadaafe6
Restore mostly-alphabetic sorting of os functions.
2012-06-24 12:50:06 +02:00
b9df00cc00
Note that equivalents are valid for 3.3+ only.
2012-06-24 12:38:14 +02:00
b9831ab63c
Move Linux-only *xattr() functions to their own subheading.
2012-06-24 11:57:07 +02:00
7ac2af78a2
Fix typo.
2012-06-24 11:56:47 +02:00
b1a1ac0b67
Small nits in os doc.
2012-06-24 11:54:07 +02:00
50c4000685
"Refactor" docs for the new dir_fd, follow_symlinks, path-as-fd APIs: document the options at a central place and link to it.
2012-06-24 11:45:20 +02:00
97f43c019f
#15160 : Extend the new email parser to handle MIME headers.
...
This code passes all the same tests that the existing RFC mime header
parser passes, plus a bunch of additional ones.
There are a couple of commented out tests where there are issues with the
folding. The folding doesn't normally get invoked for headers parsed from
source, and the cases are marginal anyway (headers with invalid binary data)
so I'm not worried about them, but will fix them after the beta.
There are things that can be done to make this API even more convenient, but I
think this is a solid foundation worth having. And the parser is a full RFC
parser, so it handles cases that the current parser doesn't. (There are also
probably cases where it fails when the current parser doesn't, but I haven't
found them yet ;)
Oh, yeah, and there are some really ugly bits in the parser for handling some
'postel' cases that are unfortunately common.
I hope/plan to to eventually refactor a lot of the code in the parser which
should reduce the line count...but there is no escaping the fact that the
error recovery is welter of special cases.
2012-06-24 05:03:27 -04: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
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
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
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
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
Antoine Pitrou
Nick Coghlan
R David Murray
Eli Bendersky
Terry Jan Reedy
Brett Cannon
Richard Oudkerk
Georg Brandl
Andrew Svetlov
Sandro Tosi
Victor Stinner
Barry Warsaw
Vinay Sajip
Senthil Kumaran
Meador Inge
Hynek Schlawack
Raymond Hettinger
Larry Hastings
Florent Xicluna
Éric Araujo
Ezio Melotti
Christian Heimes
Brian Curtin
Petri Lehtinen
Ned Deily