Commit graph

20675 commits

Author SHA1 Message Date
Miss Islington (bot)
3100b7e710
bpo-29710: Clarify documentation for Bitwise binary operation (GH-1691)
Mathematically, bitwise operations on integers behave as if there were an
infinite number of sign bits. Pragmatically, that gives the same answer as
using one extra sign bit for the bitwise logical operations.
(cherry picked from commit b4bc5cab82)

Co-authored-by: Sanyam Khurana <8039608+CuriousLearner@users.noreply.github.com>
2018-07-28 09:52:31 -07:00
Miss Islington (bot)
30f295b85e
bpo-33921: Clarify how to bind to all interfaces using socket (GH-7877)
Clarify how to bind to all interfaces using socket
(cherry picked from commit 95dfb9c3ae)

Co-authored-by: johnthagen <johnthagen@users.noreply.github.com>
2018-07-28 05:27:27 -07:00
Andrés Delfino
0041d721a6 [3.6] bpo-5978: Document that profiling needs cmd/function to return (GH-8515)
<!-- issue-number: bpo-5978 -->
https://bugs.python.org/issue5978
<!-- /issue-number -->
(cherry picked from commit 937fb55d35)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-28 13:24:35 +01:00
Miss Islington (bot)
146ba436cc
bpo-12743: Delete comment from marshal.rst (GH-8457)
Also, update the list of exceptions that may raised by PyMarshal_*
functions. We usually don't document exceptions raised by a
function, but in this case most of them were already documented
in C API and standard library documentation.
(cherry picked from commit defcffdf86)

Co-authored-by: Berker Peksag <berker.peksag@gmail.com>
2018-07-26 21:42:44 -07:00
Miss Islington (bot)
cfadd1c242
bpo-28677: Improve phrasing of when instance attribute is referenced (GH-6208)
(cherry picked from commit c0f0a7669c)

Co-authored-by: Aaron Ang <aaronang@users.noreply.github.com>
2018-07-25 10:40:32 -07:00
Miss Islington (bot)
a096cc6c3b Fix site module documentation. (GH-8441)
The script will exit with the number 0 (zero), instead of the letter O.
(cherry picked from commit 95d34c2a37)

Co-authored-by: Mariatta <Mariatta@users.noreply.github.com>
2018-07-24 10:31:11 -07:00
Miss Islington (bot)
5b3643d1a5 bpo-33468: Add try-finally contextlib.contextmanager example (GH-7816) (GH-8426)
(cherry picked from commit bde782bb59)

Co-authored-by: Matthias Bussonnier <bussonniermatthias@gmail.com>
2018-07-24 00:38:24 +03:00
Miss Islington (bot)
c774f76d21 Clarify ValueError's broad applicability (GH-8313) (GH-8317)
(cherry picked from commit feabae9617)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2018-07-17 13:24:27 -07:00
Miss Islington (bot)
f1ab9cac90 bpo-34124: Fix markup of message_from_binary_file() signature (GH-8297)
(cherry picked from commit c9265c1534)

Co-authored-by: Jon Ribbens <jribbens@gmail.com>
2018-07-16 22:41:48 +03:00
Miss Islington (bot)
083a836937
bpo-4260: Document that ctypes.xFUNCTYPE are decorators (GH-7924)
(cherry picked from commit 379e9d639a)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-13 06:54:18 -07:00
Miss Islington (bot)
b3cc7ca250
Doc: Point to Simple statements section instead of PEP (GH-8238)
(cherry picked from commit 33aefad342)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-11 03:52:27 -07:00
Miss Islington (bot)
def4b063f3
Fix documentation for input and output tutorial (GH-8231)
The ValueError message ends with a period.
(cherry picked from commit 9cffdbffc3)

Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com>
2018-07-10 18:08:43 -07:00
Miss Islington (bot)
d73497ba52 bpo-26544: Fixed implementation of platform.libc_ver(). (GH-7684). (GH-8193) (GH-8195)
(cherry picked from commit 2a9b8babf0)
(cherry picked from commit 7c43b80150)
2018-07-09 14:38:27 +03:00
Miss Islington (bot)
336c715a82
Fix margin in sentinel and mock_open (GH-8188)
(cherry picked from commit f85af035c5)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-08 17:52:44 -07:00
Marcin Niemira
4041565348 bpo-34061: Document sqlite3.NotSupportedError (GH-8172)
(cherry picked from commit bc9aa813a3)

Co-authored-by: Marcin Niemira <marcin@niemira.net>
2018-07-08 16:58:49 +03:00
Miss Islington (bot)
b7874c809c
bpo-33888: Use CPython instead of Python in the FAQ (GH-7767)
Make the change where discussing the CPython implementation of lists and dicts.
(cherry picked from commit 8d41278045)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-07 16:50:33 -07:00
Benjamin Peterson
becb527767
[3.6] closes bpo-34050: Fix link in SSL docs (GH-8173) (GH-8178)
(cherry picked from commit 9c5ba09748)

Co-authored-by: Marcin Niemira <marcin@niemira.net>
2018-07-07 16:03:37 -07:00
Miss Islington (bot)
445f9edaa4
bpo-33702: Add some missing links in production lists and do a little polish (GH-7259)
(cherry picked from commit caccca78e4)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-07 14:09:20 -07:00
Miss Islington (bot)
770937b6fd
bpo-33804: Document that the argument for io.TextIOBase.read() is optional (GH-7510)
(cherry picked from commit b6bb77c2b8)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-07 13:45:07 -07:00
Miss Islington (bot)
3271fba16e
Add missing closing parentheses (GH-8144)
(cherry picked from commit 03dd0e794e)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-07 12:34:43 -07:00
Miss Islington (bot)
dc33d4ac6f
Fix moduleauthor/sectionauthor directives in Enum (GH-8117)
(cherry picked from commit 2d748389dc)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-07 12:30:40 -07:00
Dong-hee Na
cad4a27585 [3.6] bpo-34065: Improve the markup of logging.basicConfig() arguments (GH-8153). (GH-8155)
(cherry picked from commit 2800dcf656)

Co-authored-by: Dong-hee Na <donghee.na92@gmail.com>
2018-07-07 19:11:22 +03:00
Miss Islington (bot)
55f39bdabc bpo-30516: Fix documentation issue with -timedelta in datetime (GH-7348) (GH-8092)
This commit fixes the -timedelta overfllow issue not documented properly.

Signed-off-by: Farhaan Bukhsh <farhaan.bukhsh@gmail.com>
(cherry picked from commit 5b6e49a139)

Co-authored-by: Farhaan Bukhsh <farhaan.bukhsh@gmail.com>
2018-07-05 00:04:03 +01:00
Miss Islington (bot)
f55a818954 bpo-34018: Doc'd that type names of SQLite converters are case-insensitive. (GH-8042) (GH-8067)
(cherry picked from commit 831c29721d)

Co-authored-by: Sergey Fedoseev <fedoseev.sergey@gmail.com>
2018-07-03 15:37:26 +03:00
Miss Islington (bot)
580c7db172
bpo-34006: Revert line length limit for Windows help docs (GH-8051)
The line-length limit is not needed because the pages appear in a separate app rather
 than on a browser tab.  It can also interact badly with the DPI setting.
(cherry picked from commit d824ca7f4d)

Co-authored-by: Zachary Ware <zachary.ware@gmail.com>
2018-07-02 15:23:46 -07:00
Miss Islington (bot)
b1707abd74
Doc: Remove unused image file (GH-8027)
(cherry picked from commit fe524df37c)

Co-authored-by: INADA Naoki <methane@users.noreply.github.com>
2018-06-30 11:31:17 -07:00
Tal Einat
db7ac30ef5
[3.6] bpo-32568: make select.epoll() and its docs consistent (GH-7840) (GH-8025)
* `flags` is indeed deprecated, but there is a validation on its value for
  backwards compatibility reasons.  This adds mention of this in the docs.
* The docs say that `sizehint` is deprecated and ignored, but it is still
  used when `epoll_create1()` is unavailable. This adds mention of this in
  the docs.
* `sizehint=-1` is acceptable again, and is replaced with `FD_SETSIZE-1`.
  This is needed to have a default value available at the Python level,
  since `FD_SETSIZE` is not exposed to Python. (see: bpo-31938)
* Reject `sizehint=0` since it is invalid to pass on to `epoll_create()`.

The relevant tests have also been updated.

(cherry picked from commit 0cdf5f4289)
2018-06-30 16:15:53 +03:00
Miss Islington (bot)
a73027918a
Fix the indentation in the documentation of bin() and hash() (GH-7998)
(cherry picked from commit bda9c3eae3)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-29 03:17:43 -07:00
Miss Islington (bot)
ff41cc7dee
bpo-33958: Doc: Remove unused variable in example (GH-7927)
(cherry picked from commit 62b6cea6b8)

Co-authored-by: Srinivas Reddy Thatiparthy (శ్రీనివాస్ రెడ్డి తాటిపర్తి) <srinivasreddy@users.noreply.github.com>
2018-06-27 23:45:28 -07:00
Ned Deily
853a36a53a Python 3.6.6
-----BEGIN PGP SIGNATURE-----
 
 iQIzBAABCgAdFiEEDZbfTUEQ5cQ/v7F/LTR+pqplQh0FAlsyzzMACgkQLTR+pqpl
 Qh3MexAA27PxEfxPv+zDetmsAc89x0UDfnYMlxfBUZN9KPeQXBFJ6/KBY/bnOzUn
 gKaNilTZGclg0/LOWt73nAqQgjVr/rnPgvq9aWiiWSyYDa+5+l+e/0oGGUb77zW7
 9Jmz/J/hwxVQVD42okJjzJlg/6S4LZMGBqg1QtoCkLZ6FBbbIIgbDMmkhWXL6ZFP
 wtRi6EN/0t0ke+YY5hiNdKVF9Dk2XPk6/V2g1mvzcKcGEzexQ3Jmqc/c7O1yUxQd
 1ZAb1CzmUENNPYeLSLsSgj2HY/9rJ4TbJNqD3NjNC16uoGLrLQsObaM7fGQezRLc
 NB//33X9raFQiY6XZLsH1mDYRyxDg3HhkUZKC3+xjrnCXpIgUQJpZ55Pk6oof0TP
 zTGMTb7ijbTh2qjTjcLTpYldUwHJLeY5g/9THK1GsGOQx2RqhaLXRCdg9qMky7Qy
 PqnoDc8/ZAe7CortJlC8QM49IgKR70+JVy7lY/R73rS2vXNNOCAsLooRB1x/CSnE
 uBEy+WQMcp4J2fIQMOLIICCwyZdvNhFmGS8YoaKpl5rVr3GatdZMGgY3V11RhmSG
 WP09iKdfbvwSbSGOF87K5WlUJMTSChK9t9gRFDuPLkspDX8F4aTdWPyhaNfrwZRu
 s4ws/irF0oapHZXWgk/wY/9pixAg2kAiUAtLYg2GArVsnZXDCxs=
 =bhX0
 -----END PGP SIGNATURE-----

Merge 3.6.6 final changes
2018-06-27 17:59:12 -04:00
Miss Islington (bot)
c0327cefc7
use rich markup for PEP reference (GH-7939)
it's better to refer to PEP with `pep` role in reStructuredText. It also links to the PEP page.
(cherry picked from commit df748c20da)

Co-authored-by: Behzad B. Mokhtari <35877268+perplexionist@users.noreply.github.com>
2018-06-26 21:20:10 -07:00
Ned Deily
4cf1f54eb7 3.6.6 final 2018-06-26 19:39:50 -04:00
Miss Islington (bot)
8fd8cfa369 [3.6] bpo-33573: docs to suggest median() alternatives for non-numeric data (GH-7587) (GH-7907)
(cherry picked from commit fdd6e0bf18)
2018-06-25 14:27:01 +03:00
Miss Islington (bot)
ac5a6e35ef bpo-33952: Fix typo in str.upper() documentation (GH-7898) (GH-7904)
(cherry picked from commit 4a6e746079)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-25 13:44:16 +03:00
Miss Islington (bot)
73848e028d bpo-33943: Add references in the docs for logging.basicConfig (GH-7858) (GH-7899)
Adds references to info about file modes, `time.strftime()`, string formatting
syntaxes, and logging levels.

(cherry picked from commit a8ddf85a84)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-25 09:31:24 +03:00
Miss Islington (bot)
a845b7ab3e
bpo-33887: Add TOC to Design and History FAQ(GH-7766)
(cherry picked from commit 38cf49bf69)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-23 11:48:28 -07:00
Miss Islington (bot)
688325ed1a
bpo-33877: Remove UNIX qualification for running complete programs (GH-7744)
The statement is true for Windows (and macOS) also.
(cherry picked from commit c9d43c702a)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-22 14:54:26 -07:00
Andrés Delfino
c45cb47907 bpo-33885: Replace "hook function" with "callable" (GH-7765) 2018-06-22 17:10:23 -04:00
Miss Islington (bot)
b225cb770f bpo-33894: Clarified the tempfile.tempdir documentation (GH-7829) (GH-7842)
(cherry picked from commit 940ae60856)

Co-authored-by: Srinivas Reddy Thatiparthy (శ్రీనివాస్ రెడ్డి తాటిపర్తి) <srinivasreddy@users.noreply.github.com>
2018-06-21 04:05:07 -04:00
Miss Islington (bot)
f14e8eaaa5
bpo-33892: Doc: Use gender neutral words (GH-7770)
(cherry picked from commit 5092439c2c)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-17 21:54:51 -07:00
Xtreak
c5ff553ae7 [3.6] bpo-33859: Fix spelling mistakes in docs. (GH-7691). (GH-7750)
(cherry picked from commit c151f7846d)

Co-authored-by: Xtreak <tirkarthi@users.noreply.github.com>
2018-06-16 09:33:16 +03:00
Miss Islington (bot)
8e6428f216
bpo-33571: Improve the glossary description for '...' prompt (GH-6971)
Mention that it can be triggered by triple quotes and after specifying decorators.
(cherry picked from commit 6868003514)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 21:08:22 -07:00
Miss Islington (bot)
2636833e8e
bpo-33836: Recommend keyword-only param for memoization in FAQ (GH-7687)
Update the the signature in the code example to make `_cache` a keyword-only parameter.
(cherry picked from commit 2707e41a5c)

Co-authored-by: Noah Haasis <haasis_noah@yahoo.de>
2018-06-15 20:50:28 -07:00
Miss Islington (bot)
9c6fe387e2 Improve the grammar in the glossary item for list (GH-7727)
" ... access to elements is O(1)."

(cherry picked from commit 7469ff5017)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 20:05:21 -07:00
Miss Islington (bot)
2ac5242352 doc: Fix small typos in library/multiprocessing (GH-698) (GH-7721)
(cherry picked from commit 5619ab2db3)

Co-authored-by: Sylvain Bellemare <sbellem@gmail.com>
2018-06-15 22:27:48 +02:00
Miss Islington (bot)
ae4b2af42c bpo-33854: Add PEP 461 title to 'See also' note (GH-7688) (GH-7720)
(cherry picked from commit a9d0b34a5c)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 16:14:53 -04:00
Miss Islington (bot)
cd9ede6b20
bpo-33847: Add '@' operator entry to index (GH-7669)
(cherry picked from commit 695118600f)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 12:45:19 -07:00
Miss Islington (bot)
eb4989970c
bpo-33852: Remove misplaced parentheses around 'list'. (GH-7672)
'expresson list' refers to the grammar term 'expression_list' in the subscription production.
(cherry picked from commit 4fddd4e406)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 11:48:22 -07:00
Victor Stinner
142e3c08a4
[3.6] bpo-32356: idempotent pause_/resume_reading (GH-4914) (GH-7629)
Backport note: don't add new is_reading() method from master to 3.6.

(cherry picked from commit d757aaf9dd)
2018-06-13 12:05:15 +02:00
Miss Islington (bot)
961332dfd3
bpo-31378: Document sqlite3.OperationalError exception (GH-7677)
(cherry picked from commit 71ede00f14)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2018-06-13 02:30:09 -07:00