Serhiy Storchaka
e4ba872543
Remove redundant leading zeroes in PEP references.
2016-03-31 15:30:54 +03:00
Berker Peksag
13b3acd13e
Fix typo in xml.dom.pulldom.rst
...
Reported by Matthew Cole on docs@p.o.
2016-03-30 16:28:43 +03:00
Andrew Svetlov
6f57424ae0
Document None as timeout for asyncio.timeout()
2016-03-29 09:39:02 +03:00
Raymond Hettinger
f9cddccf8c
Issue #25314 : store_true and store_false also create appropriate defaults.
2011-11-20 11:05:23 -08:00
Martin Panter
f6b1d66a3c
Issue #23804 : Fix SSL recv/read(0) to not return 1024 bytes
2016-03-28 00:22:09 +00:00
Berker Peksag
fa0f62d6ab
Issue #23758 : Improve num_params docs of create_{function,aggregate} functions
...
If you pass -1, the callable can take any number of arguments.
Added tests to verify the behavior.
Initial patch by Cédric Krier.
2016-03-27 22:39:14 +03:00
Berker Peksag
f70fe6f6cf
Document sqlite3.Cursor.close()
...
The behaviour of the close method is tested by ClosedCurTests
in Lib/sqlite3/test/dbapi.py.
This is basically a backport of https://github.com/ghaering/pysqlite/issues/73 .
2016-03-27 21:51:02 +03:00
Berker Peksag
557a06309c
sqlite3 documentation: Connection.iterdump() is a method
2016-03-27 18:46:18 +03:00
Victor Stinner
8a20851010
Issue #25654 :
...
* multiprocessing: open file with closefd=False to avoid ResourceWarning
* _test_multiprocessing: open file with O_EXCL to detect bugs in tests (if a
previous test forgot to remove TESTFN)
* test_sys_exit(): remove TESTFN after each loop iteration
Initial patch written by Serhiy Storchaka.
2016-03-25 09:29:50 +01:00
Terry Jan Reedy
01a9a958b6
Issue #26525 : Change chr example to match change in ord example.
2016-03-23 13:36:52 -04:00
Terry Jan Reedy
063d48d9c0
Issue #26525 : Change ord example from nu to more easily recognized Euro sign.
2016-03-20 21:18:40 -04:00
Terry Jan Reedy
4902c46bff
Issue #15660 : Further clarify 0 prefix for width specifier in formats.
2016-03-20 21:05:57 -04:00
Berker Peksag
563c949b11
Issue #26593 : Fix typo in logging HOWTO
...
Patch by Andrew Szeto.
2016-03-20 12:50:56 +02:00
Brett Cannon
adcb654519
Suggest people use feature detection in porting guide
2016-03-18 13:23:58 -07:00
Ezio Melotti
62564dbb4b
#26250 : document the sqlite3.Cursor.connection attribute. Initial patches by Aviv Palivoda and Varpu Rantala.
2016-03-18 20:10:36 +02:00
Serhiy Storchaka
774006232a
Fixed a typo.
2016-03-18 14:36:47 +02:00
Berker Peksag
42f8548c89
Issue #26580 : Remove outdated reference to ftpmirror
...
Patch by SilentGhost.
2016-03-18 14:26:08 +02:00
Martin Panter
ce911c3fed
Issue #26499 : Fixes to HTTPResponse.readline() and read1(), by Silent Ghost
2016-03-17 06:42:48 +00:00
Ezio Melotti
f2b9a39813
#24918 : fix CSS for code blocks when a side box is present. Patch by Manvi B.
2016-03-13 11:41:05 +02:00
Raymond Hettinger
a503f7092f
Minor recipe edit: convert "while 1" to "while True".
2016-03-13 00:12:31 -08:00
Ezio Melotti
8dea74f12a
#25687 : clarify that errors in tearDown increase the total number of reported errors. Initial patch by HyeSoo Park.
2016-03-13 09:40:09 +02:00
Raymond Hettinger
4d02896609
Issue #26548 : Minor fix to awkward wording in docs
2016-03-12 22:58:24 -08:00
Steve Dower
d669b6bd0a
Issue #23606 : Adds note to ctypes documentation regarding cdll.msvcrt.
2016-03-12 08:25:22 -08:00
Berker Peksag
eb2e02bed4
Issue #26542 : Fix markup of code example in difflib documentation
...
Patch by Dmitry Shachnev.
2016-03-11 23:19:48 +02:00
Victor Stinner
29bf27fe7f
Issue #26516 : Enhance Python mem allocators doc
...
* add link to PYTHONMALLOCSTATS env var
* add parameters to PyMem macros like PyMem_MALLOC()
* fix PyMem_SetupDebugHooks(): add Calloc functions
* add some newlines for readability
2016-03-09 14:49:52 +01:00
Serhiy Storchaka
cc2dbc5844
Issue #15068 : Got rid of excessive buffering in the fileinput module.
...
The bufsize parameter is no longer used.
2016-03-08 18:28:36 +02:00
Ned Deily
adbf8cecbe
Issue #26505 : Fix typos in getaddrinfo license text.
...
Patch by Alex Willmer.
2016-03-07 14:51:59 -05:00
Berker Peksag
b4f2f453e7
Issue #24852 : Remove outdated "HOWTO Use Python in the web" document
2016-03-07 19:00:47 +02:00
Berker Peksag
777d639a92
Issue #21034 : Remove outdated paragraph from venv documentation
...
Since Python 3.4, there is no need to install pip and setuptools
into a venv manually.
2016-03-07 18:50:49 +02:00
Raymond Hettinger
e525ee3b48
Document another recipe for itertools: all_equal(). Inspired by David Beazley.
2016-03-06 18:11:38 -08:00
Berker Peksag
ff47cfbc66
Issue #26246 : Set initial value of the hidden attr when creating copy button.
...
Patch by Liang-Bo Wang.
2016-03-02 19:40:30 +02:00
Berker Peksag
25c0ef518d
Issue #26246 : Set initial value of the hidden attr when creating copy button.
...
Patch by Liang-Bo Wang.
2016-03-02 19:40:08 +02:00
Georg Brandl
96421d6f11
Update susp-ignore file ( #25910 ).
2016-02-28 21:13:23 +01:00
Georg Brandl
76b2ee03c3
Fix typo.
2016-02-28 21:09:36 +01:00
Martin Panter
3263f6874a
Issue #22836 : Keep exception reports sensible despite errors
2016-02-28 03:16:11 +00:00
Ezio Melotti
738f88f688
#26246 : merge with 3.4.
2016-02-27 08:41:16 +02:00
Ezio Melotti
90ba2ca68a
#26246 : update copybutton.js after JQuery update. Patch by Liang-Bo Wang.
2016-02-27 08:39:36 +02:00
Georg Brandl
5d94134040
Closes #25910 : fix dead and permanently redirected links in the docs. Thanks to SilentGhost for the patch.
2016-02-26 19:37:12 +01:00
Georg Brandl
06871ef2b3
Fix version.
2016-02-26 19:17:39 +01:00
Georg Brandl
32fbd3a623
Closes #26442 : fix copy-paste.
2016-02-26 19:16:40 +01:00
Georg Brandl
adeffcc2f9
Closes #26444 : typo fixes.
2016-02-26 19:13:47 +01:00
Martin Panter
bc85e35fe6
Issue #26390 : Fix and test pbkdf2_hmac() parameter names
...
Based on patch by Daan Bakker.
2016-02-22 09:21:49 +00:00
Georg Brandl
8c16cb9f65
Closes #26435 : fix syntax in directives. Thanks to Jakub Stasiak.
2016-02-25 20:17:45 +01:00
Georg Brandl
2305b3cde3
Fix rstlint to also look for indented comments that should be directives.
2016-02-25 20:14:10 +01:00
Martin Panter
ee3074e1f4
Issue #22088 : Clarify base-64 alphabets and which characters are discarded
...
* There are only two base-64 alphabets defined by the RFCs, not three
* Due to the internal translation, plus (+) and slash (/) are never discarded
* standard_ and urlsafe_b64decode() discard characters as well
Also update the doc strings to clarify data types, based on revision
92760d2edc9e, correct the exception raised by b16decode(), and correct the
parameter name for the base-85 functions.
2016-02-23 22:30:50 +00:00
Georg Brandl
f1d371bde9
Update example; str(float) changed so there is difference now.
2016-02-22 14:52:55 +01:00
Martin Panter
1f0e1f3cbb
Issue #26261 : Clarify NamedTemporaryFile name attribute vs file.name
2016-02-22 10:10:00 +00:00
Martin Panter
1c5e715d8f
Fix errors in XML-RPC client example code
...
* http.client.HTTP (does not exist in Python 3) → HTTPConnection
* Server (deprecated) → ServerProxy
* Transport.send_request() grew a new “debug” parameter in Python 3 (revision
a528f7f8f97a)
2016-02-22 09:04:22 +00:00
Berker Peksag
0334c3c735
Issue #26401 : Fix compile() documentation
...
After 25032ec29315, compile() will raise a ValueError
if source contains null bytes.
Patch by SilentGhost.
2016-02-21 22:00:12 +02:00
Brett Cannon
27c712e149
List what classes from importlib.machinery don't work with importlib.util.LazyLoader
2016-02-20 18:40:02 -08:00
Vinay Sajip
e10d370a92
Added simple threading example to logging cookbook.
2016-02-20 19:02:46 +00:00
Martin Panter
f817a48d17
Issues #22468 , #21996 , #22208 : Clarify gettarinfo() and TarInfo usage
...
* The Windows-specific binary notice was probably a Python 2 thing
* Make it more obvious gettarinfo() is based on stat(), and that non-ordinary
files may need special care
* The file name must be text; suggest dummy arcname as a workaround
* Indicate TarInfo may be used directly, not just via gettarinfo()
2016-02-19 23:34:56 +00:00
Georg Brandl
92849d1721
Closes #20169 : fix inner links random doc.
2016-02-19 08:57:38 +01:00
Martin Panter
eac17b8955
Issue #15608 : Improve socketserver module documentation
...
* Add headings for each concrete and mix-in class and list methods and
attributes under them
* Fix class and method cross references
* Changed RequestHandler to BaseRequestHandler and added class heading
* Pull out Stream/DatagramRequestHandler definitions
* Reordered the request handler setup(), handle(), finish() methods
* Document constructor parameters for the server classes
* Remove version 2.6 not relevant for Python 3 documentation
2016-02-19 03:27:46 +00:00
Berker Peksag
3fe64d0c5c
Issue #16915 : Clarify that mode parameter of socket.makefile() does not accept
...
the same values as open().
2016-02-18 17:34:00 +02:00
Benjamin Peterson
8f0432ffbb
fix typo ( closes #26378 )
2016-02-17 23:42:46 -08:00
Ned Deily
f38c93fb7f
Issue #26368 : fix typo in asynchio stream doc, reported by Ryan Stuart.
2016-02-16 13:27:04 +11:00
Yury Selivanov
77c96813ab
Issue #25887 : Raise a RuntimeError when a coroutine is awaited more than once.
2016-02-13 17:59:05 -05:00
Guido van Rossum
e93b06a0a3
Hopefully clarify the difference between Optional[t] and an optional argument.
2016-02-10 09:48:58 -08:00
Martin Panter
c04fb56e36
Issue #26304 : Change "allows to <verb>" to "allows <verb>ing" or similar
...
The original form is incorrect grammar and feels awkward, even though the
meaning is clear.
2016-02-10 05:44:01 +00:00
Martin Panter
96a4f07107
Issues #26310 , #26311 : Fix typos in the documentation and code comments
2016-02-10 01:17:51 +00:00
Gregory P. Smith
e27403b75f
Clarify "cardinality of" as "number of elements in" as many readers do
...
not have a math vocabulary.
2016-02-08 09:58:40 -08:00
Serhiy Storchaka
c4b813d05d
Issue #26198 : Fixed error messages for some argument parsing errors.
...
Fixed the documented about buffer overflow error for "es#" and "et#" format
units.
2016-02-08 01:06:11 +02:00
Martin Panter
d5db14794b
Issue #25179 : Preparatory cleanup of existing docs on string formatting
...
* Various sections were pointing to the section on the string.Formatter
class, when the section on the common format string syntax is probably more
appropriate
* Fix references to various format() functions and methods
* Nested replacement fields may contain conversions and format specifiers,
and this is tested; see Issue #19729 for instance
2016-02-08 01:34:09 +00:00
Senthil Kumaran
b6213c5664
Fix userinfo example presented in urllib2 howto.
2016-02-05 19:37:23 -08:00
Zachary Ware
2b818142d1
Python for .NET has moved to Github.
...
Reported by Denis Akhiyarov on docs@
2016-02-03 22:05:46 -06:00
Zachary Ware
3df11b2bd6
Fix typo.
...
Reported by Jon Tetlak on docs@
2016-02-02 17:04:41 -06:00
Martin Panter
567d513b9b
Issue #26244 : Clarify default zlib compression level in documentation
...
Based on patch by Aviv Palivoda.
2016-02-03 07:06:33 +00:00
Raymond Hettinger
b00da57561
Issue #26194 : Inserting into a full deque to raise an IndexError
2016-02-01 21:19:22 -08:00
Victor Stinner
5f0c5d92ef
Enhance os.scandir() doc
...
Issue #26248 , patch written by Ben Hoyt:
1) Clarify that the return values of is_dir()/is_file()/etc are cached
separately for follow_symlinks True and False.
2) Be more specific about when the functions require a system call, and how it
relates to caching and follow_symlinks.
3) DRY up common stuff between is_dir and is_file by saying "Caching, system
calls made, and exceptions raised are as per is_dir" in is_file.
4) Tweak to the first paragraph of docs for is_dir/is_file to simplify: assume
the follow_symlinks=True default, then note the follow_symlinks=False
non-default case after.
2016-01-31 18:36:41 +01:00
Berker Peksag
fe5f614418
Issue #26242 : Fix another one in importlib.rst
2016-01-30 19:30:06 +02:00
Berker Peksag
253739daf4
Fix a markup error in socket.rst
2016-01-30 19:23:29 +02:00
Berker Peksag
ef410770a7
Update "Creating Virtual Environments" link in venv documentation
2016-01-30 12:24:31 +02:00
Berker Peksag
a9744aebc8
Update output of venv -h
...
* Update description of the --system-site-packages option
* Show --copies option in the usage
2016-01-30 12:17:10 +02:00
Berker Peksag
806cb0f2b6
Add a link to PEP 384 in stable.rst
2016-01-28 12:42:26 +02:00
Martin Panter
34360c8e09
Issue #19023 : Document ctypes array and pointer classes
...
Also add some more tests. Based on patch by Sye van der Veen.
2016-01-29 10:12:19 +00:00
Berker Peksag
547f66f599
Issue #26034 : Sync documentation of --clear with its behavior
...
Most of the docs has already been updated in c3c188a0325a.
2016-01-28 09:01:26 +02:00
Berker Peksag
a370a4271e
Issue #26199 : Fix broken link in unittest.mock-examples.rst
...
Patch by Raphael Das Gupta.
2016-01-28 08:40:03 +02:00
Martin Panter
4942870471
Issue #26220 : Remove outdated comment about a question mark
2016-01-29 04:01:16 +00:00
Raymond Hettinger
3743432302
Issue #26194 : Fix undefined behavior for deque.insert() when len(d) == maxlen
2016-01-26 21:44:16 -08:00
Brett Cannon
3bf1d87bbd
Fix a typo in a code example
2016-01-22 14:03:27 -08:00
Victor Stinner
875f29aa69
doc: i18n HTML templates
...
Issue #25907 : Use {% trans %} tags in HTML templates to ease the translation of
the documentation. The tag comes from Jinja templating system, used by Sphinx.
Patch written by Julien Palard.
2016-01-22 18:00:05 +01:00
Senthil Kumaran
e5c05cc8c0
minor clarification on Zipfile 'x' mode - exclusive creation of a file.
2016-01-21 21:06:47 -08:00
Berker Peksag
7405c16533
Issue #18620 : Improve Pool examples in multiprocessing documentation
...
A single call to Pool.apply_async() will create only one process. To use all
of the pool's processes, it should be invoked multiple times:
with Pool(processes=4) as pool:
results = [pool.apply_async(func, ()) for i in range(4)]
Patch by Davin Potts.
2016-01-21 23:59:49 +02:00
Senthil Kumaran
1538b3d3df
issue25909 - Correct the documentation of PyMapping_Items, PyMapping_Keys and
...
PyMapping_Values in Include/abstract.h and Doc/c-api/mapping.rst.
Patch contributed by Sonali Gupta.
2016-01-21 09:37:28 -08:00
Victor Stinner
d99cd333fe
Issue #26106 : doc: Move text of licenses to parsed literal block
...
This change helps to ignore text of PSF, BEOPEN.com and CNRI licenses when
translating the documentation. Patch written by Julien Palard who is
translating Python 3.5 doc to french. Text of other licenses already used
preformatted format.
2016-01-21 08:56:00 +01:00
Benjamin Peterson
b57eaeadff
merge 3.4 ( #26172 )
2016-01-20 22:02:47 -08:00
Benjamin Peterson
c836f717cd
remove script from epub ( closes #26172 )
2016-01-20 22:02:30 -08:00
Senthil Kumaran
6a0514ea20
issue25982 - Add a class definition for managers.Namespace in the multiprocessing docs.
2016-01-20 03:10:13 -08:00
Berker Peksag
744fdfbf9a
Issue #5626 : Remove misleading comment from socket.gethostname() documentation
...
A machine can have more than one IP addresses so
socket.gethostbyname(socket.gethostname()) probably won't return the correct
one.
2016-01-20 08:45:37 +02:00
Berker Peksag
49c9edf3d9
Issue #26157 : Fix typos in asyncio-eventloop.rst
...
Initial patch by Carlo Beccarini.
2016-01-20 07:14:22 +02:00
Senthil Kumaran
9e9f850f99
issue23962 - Reference the correct TimeoutError in concurrent.futures documentation.
...
Patch contributed by Ryder Lewis.
2016-01-18 18:45:00 -08:00
Senthil Kumaran
76d9a6bbd2
Issue26017 - Suggest enclosing command args in double quotes when using characters which get interpreted by shell.
2016-01-17 18:42:13 -08:00
Senthil Kumaran
80538e9dfe
Issue26135 - In the tutorial section on modules, reference importlib.reload instead of imp.reload.
2016-01-16 18:43:24 -08:00
Steve Dower
e248f6875b
Issue #25089 : Adds short documentation section for modifying an install.
2016-01-16 11:58:30 -08:00
Senthil Kumaran
a82908f743
Issue26035 - Correct the argument names used in the docs of the traceback module. Make it consistent with module args.
...
Patch contributed by Upendra Kumar.
2016-01-15 21:45:17 -08:00
Martin Panter
20b1bfa6fb
Issue #26127 : Fix links in tokenize documentation; patch by Silent Ghost
2016-01-16 04:32:52 +00:00
Ezio Melotti
397bb2486a
#26001 : mention in the tutorial that files in binary mode expect bytes, not str.
2016-01-12 11:27:30 +02:00
Ezio Melotti
f418db2e8c
#19006 : fix wording in unittest docs.
2016-01-12 11:03:31 +02:00
Yury Selivanov
a7c159ddf3
Issue #25486 : Drop "removed in 3.6" wording from inspect.getargspec docs.
2016-01-11 21:04:50 -05:00