Commit Graph

20336 Commits

Author SHA1 Message Date
Pablo Galindo 8ca036d471 bpo-32586: Fix code example in urllib2's doc (GH-5238)
It should be `urllib2.URLError` instead of just `URLError`.
2018-01-18 16:16:13 -08:00
Benjamin Peterson e13698172f
[2.7] advance copyright years to 2018 (GH-5094). (#5105)
(cherry picked from commit 65f2a6dcc2)
2018-01-04 23:02:11 -08:00
Serhiy Storchaka ca54740f25
[2.7] bpo-32211: Document the existing bug in re.findall() and re.finditer(). (GH-4695). (#5096)
(cherry picked from commit 1e6d8525f9)
2018-01-04 14:08:27 +02:00
Miss Islington (bot) 0e0d1017a4 bpo-32452: clarify term 'brackets' in generator tutorial (GH-5079) (#5082)
Updates documentation for generator expressions in classes tutorial: Clarify usage of ambiguous term "brackets" by replacing with "square brackets". Updated subsequent lines to respect line breaks. (GH-5079)
(cherry picked from commit f190eb59e6)
2018-01-02 10:42:12 -05:00
Miss Islington (bot) 3ff488c082 trivial: link updates in documentation (GH-2765) (#4836)
(cherry picked from commit 4f29f3c84b)
2017-12-13 14:45:13 +02:00
Vinay Sajip 292fce9934
bpo-32212: Updated logging documentation to make parameter names more consistent with source. (GH-4765) (GH-4768)
(cherry picked from commit a9f8df646a)
2017-12-09 12:49:10 +00:00
Mariatta 12fa6b1e2f
Add a missing space in tkinter documentation. (GH-4692). (GH-4723)
(cherry picked from commit ae342cf7de)
2017-12-04 21:15:57 -08:00
Miss Islington (bot) d6c6e586b4 Improve Scheduler Objects documentation. (GH-4556) (GH-4558)
Mention that the lower the priority number, the higher priority it represents.
(cherry picked from commit 9d5ec808de)
2017-11-24 21:49:10 -08:00
Miss Islington (bot) c02037d622 bpo-30004: Fix the code example of using group in Regex Howto Docs (GH-4443) (GH-4555)
The provided code example was supposed to find repeated words, however it returned false results.
(cherry picked from commit 610e5afdcb)
2017-11-24 21:01:39 -08:00
Miss Islington (bot) 465f3d0820 Improve the String tutorial docs (GH-4541) (GH-4546)
The paragraph that contains example of string literal concatenation was placed
after the section about concatenation using the '+' sign.
Moved the paragraph to the appropriate section.
(cherry picked from commit 78a5722ae9)
2017-11-24 09:35:53 -08:00
Miss Islington (bot) 66cdc84e40 Extending Python Doc minor updates (GH-4518) (GH-4536)
Move footnote markers to be closer to the related terminology:
before the end of the sentence, instead of after.
(cherry picked from commit cdfe910e74)
2017-11-24 00:55:33 -08:00
Victor Stinner 733b5f3f2f
bpo-32050: Fix -x option documentation (#4423)
The line number in correct when using the -x option: Py_Main() uses
ungetc() to not skip the first newline character.
2017-11-20 07:08:44 -08:00
Masayuki Yamamoto aa9100567f Document parameters of BaseServer.finish_request() (GH-4445)
(cherry picked from commit 7750bded92)
2017-11-19 15:20:09 +03:00
Erik Bray 3393c8067d Fix typo in atexit documentation. (GH-4419) (GH-4442)
`kargs` -> `kwargs`
2017-11-17 05:57:54 -08:00
Miss Islington (bot) a2f1be0b5b bpo-15606: Improve the re.VERBOSE documentation. (GH-4366) (#4395)
(cherry picked from commit b0b44b4b33)
2017-11-14 17:39:04 +02:00
Miss Islington (bot) 47eaaa5524 bpo-31793: Doc: Specialize smart-quotes for Japanese (GH-4006)
(cherry picked from commit 5a66c8a64d)
2017-11-08 01:53:24 +09:00
Miss Islington (bot) 4376a22759 bpo-31923: Fix spelling in sqlite3 docs (GH-4227)
(cherry picked from commit aafece7a9e)
2017-11-05 02:11:25 +03:00
Serhiy Storchaka fd38819497
[2.7] bpo-18699: Corrected documentation for window.chgat in curses module (GH-1430). (#4272)
(cherry picked from commit b838cc3ff4)
2017-11-04 10:42:56 +02:00
Victor Stinner 52ba7b447f
bpo-20064: Document PyObject_Malloc() (#4204)
Document the following functions:

* PyObject_Malloc()
* PyObject_Realloc()
* PyObject_Free()

Document also the pymalloc allocator.
2017-10-31 10:08:28 -07:00
Serhiy Storchaka ef346a2473 [2.7] bpo-31667: Fix gettext related links. (GH-3860) (#4100)
* Fix incorrect links.
* Remove redundant links.
* Add signatures and index entries for gettext related
functions in the locale module.
(cherry picked from commit c02a1f4ad8)
2017-10-24 10:59:17 +03:00
Victor Stinner 355393e743 [2.7] bpo-31733, bpo-31692: Document 2 new env vars in What's New in Python 2.7 (GH-4019)
bpo-31733, bpo-31692: Document the new PYTHONSHOWREFCOUNT and
PYTHONSHOWALLOCCOUNT environment variables.
2017-10-17 13:13:13 -07:00
Victor Stinner 7b4ba62e38 [2.7] bpo-31692: Add PYTHONSHOWALLOCCOUNT env var (GH-3927)
bpo-31692, bpo-19527:

* Add a new PYTHONSHOWALLOCCOUNT environment variable, similar to
  the Python 3 "-X showalloccount" option
* When Python is compiled with COUNT_ALLOCS, the new
  PYTHONSHOWALLOCCOUNT environment variable now has to be set to dump
  allocation counts into stderr on shutdown. Moreover, allocations
  statistics are now dumped into stderr rather than stdout.
* Add @test.support.requires_type_collecting decorator: skip test if
  COUNT_ALLOCS is defined
* Fix tests for COUNT_ALLOCS: decorate some methods with
  @requires_type_collecting
* test_sys.test_objecttypes(): update object type when COUNT_ALLOCS
  is defined
2017-10-17 02:25:23 -07:00
Victor Stinner 3c082a7fdb bpo-31733: Add PYTHONSHOWREFCOUNT env var (GH-3932)
Add a new PYTHONSHOWREFCOUNT environment variable. In debug mode,
Python now only print the total reference count if PYTHONSHOWREFCOUNT
is set.
2017-10-17 01:35:19 -07:00
vyas45 50cef52372 [2.7] bpo-31754: Fix type of 'itemsize' in PyBuffer_FillContiguousStrides (GH-3993) 2017-10-16 21:23:43 +03:00
Ned Deily 356b68023d bpo-31766: restore 3.5 to docs version switchers (#3971) 2017-10-12 14:24:23 -04:00
Miss Islington (bot) 7440655bc5 bpo-31720: msilib documentation, change MsiError into MSIError (GH-3914) (GH-3916)
(cherry picked from commit 28f713601d)
2017-10-07 09:00:42 -07:00
Ned Deily 8d614bebb6 Remove retired and security branches from active docs (#3881) 2017-10-03 23:06:13 -04:00
Igor Filatov cf7197ae43 [2.7] bpo-31351: Set return code in ensurepip when pip fails (GH-3734)
Previously ensurepip would always report success, even if the
pip installation failed.

(cherry picked from commit 9adda0cdf8)
2017-09-25 11:03:24 +10:00
Zachary Ware da86874a3d [2.7] bpo-31423: Fix building the PDF documentation (GH-3693) (GH-3700)
Use prefixed macro names for the `authoraddress` function, add T2A to the font encoding in LaTeX sources to support Cyrillic characters in the PDF documentation, and replace the deprecated `font_size` config option with `pointsize`.
(cherry picked from commit da9b4cfb48)
2017-09-22 13:41:10 -05:00
Christian Heimes 5b6452d412 bpo-31533: fix broken link to OpenSSL docs (GH-3674) (GH-3676)
(cherry picked from commit 19e4d93)
2017-09-20 13:23:09 -07:00
Michael Seifert 41376241e3 bpo-29916: Include PyGetSetDef in C API extension documentation. (#831) (#3609)
(cherry picked from commit da67e0d644)
2017-09-16 14:30:07 +03:00
R. David Murray ae16b9966d [2.7] Clarify nature of parse_args 'args' argument. (GH-3292) (GH-3328)
Patch by Paul.j3.  Includes an unrelated but useful addition to the
optparse porting section.
(cherry picked from commit 0c7983e4ad)
2017-09-09 22:55:07 -07:00
Christian Heimes b9a860f3bf [2.7] bpo-29136: Add TLS 1.3 cipher suites and OP_NO_TLSv1_3 (GH-1363) (#3446)
* bpo-29136: Add TLS 1.3 support

TLS 1.3 introduces a new, distinct set of cipher suites. The TLS 1.3
cipher suites don't overlap with cipher suites from TLS 1.2 and earlier.
Since Python sets its own set of permitted ciphers, TLS 1.3 handshake
will fail as soon as OpenSSL 1.1.1 is released. Let's enable the common
AES-GCM and ChaCha20 suites.

Additionally the flag OP_NO_TLSv1_3 is added. It defaults to 0 (no op) with
OpenSSL prior to 1.1.1. This allows applications to opt-out from TLS 1.3
now.

Signed-off-by: Christian Heimes <christian@python.org>.
(cherry picked from commit cb5b68abde)
2017-09-07 22:31:17 -07:00
Miss Islington (bot) 82cae7c5be [2.7] bpo-31330: Clarify that RawTextHelpFormatter collapses repeated newlines. (GH-3272) (GH-3428)
Also provide a solution if the user wants to keep multiple blank lines.
(cherry picked from commit 397c467c49)
2017-09-07 17:17:42 -04:00
Miss Islington (bot) ab4894bba6 [2.7] bpo-21649: Add RFC 7525 and Mozilla server side TLS (GH-3387) (GH-3400)
Signed-off-by: Christian Heimes <christian@python.org>
(cherry picked from commit ad0ffa033e)
2017-09-06 17:31:48 -07:00
Benjamin Peterson 6d6ff08d38 [2.7] Issue GH-28705: greatly simplify the FAQ entry on transpiling. (#3371)
This also eliminats a dead link to Weave in the process..
(cherry picked from commit 78ffd6cffa)
2017-09-05 18:18:16 -07:00
Zachary Ware 986b7ffc65 [2.7] bpo-30450: Pull Windows dependencies from GitHub rather than SVN (GH-1783) (GH-3306)
The Windows build now depends on Python 3.6 to fetch externals, but it
will be downloaded via NuGet (which is downloaded via PowerShell) if it
is not available via `py -3.6`.  This means the only thing that must be
installed on a modern Windows box to do a full build of CPython with all
extensions is Visual Studio.

Cherry-picked from 51599e2bdd, parts of 40a23e8899, parts of 68d663cf85, d5cd21d75a, and possibly others that I've missed.

Also:

* Rename db -> bsddb for disambiguity

* Update sqlite3 to 3.14.2.0 since it's the version we use on 3.x, and it's simpler to just use it than to also upload the old version to cpython-source-deps

* Add PCbuild/*.ilk to .gitignore
2017-09-04 16:05:33 -07:00
INADA Naoki 4cde4bdcc8 bpo-31095: Fix potential crash during GC (GH-3197)
(cherry picked from commit a6296d34a4)
2017-09-04 12:31:41 +09:00
Mariatta 2281c041b2 Fix broken `Show Source` links on documentation pages (GH-3113) (GH-3128)
The `Show Source` was broken because of a change made in sphinx 1.5.1
In Sphinx 1.4.9, the sourcename was "index.txt".
In Sphinx 1.5.1+, it is now "index.rst.txt".

(cherry picked from commit b9ff498793)
2017-08-18 06:22:32 -07:00
Julien Palard 3cc46bb3ed Update the language selection in the docs language switch. (GH-3114) (#3117)
Change the option for `Français` into `French` to be consistent with the other language selections that are already in English.
(cherry picked from commit b616b97299)
2017-08-17 16:37:56 +02:00
Christian Heimes 05b7d9c667 [2.7] bpo-30714: ALPN changes for OpenSSL 1.1.0f (#3094)
OpenSSL 1.1.0 to 1.1.0e aborted the handshake when server and client
could not agree on a protocol using ALPN. OpenSSL 1.1.0f changed that.
The most recent version now behaves like OpenSSL 1.0.2 again. The ALPN
callback can pretend to not been set.

See https://github.com/openssl/openssl/pull/3158 for more details

Signed-off-by: Christian Heimes <christian@python.org>
(cherry picked from commit a5c1bab352)
2017-08-15 10:55:03 +02:00
Julien Palard fe8d9dc479 bpo-31159: fix language switch regex on unknown yet built languages. … (#3051) (#3081)
* bpo-31159: fix language switch regex on unknown yet built languages. (#3039)

This fix a regex issue (a missing non-matching group around an 'or'
list) and the specific possible case where a translation is built but
not yet in known by the picker, but not explicitly listing possible
languages in the regex.
(cherry picked from commit 122081deef)

* bpo-31149: Doc: Add Japanese to the language switcher. (#3028)

(cherry picked from commit c82b7f332a)

(cherry picked from commit e8e7fba0b2)
2017-08-13 23:44:51 +02:00
Julien Palard 245dafca85 bpo-31045: Language switch (#2652) (#3024)
* Doc: Indicate the language

* Renaming version_switcher to switchers (to add language_switcher).

* Adding language switch.

* Doc switchers: Enhance readability of regex parsing versions.

* Doc switchers: Desambiguate the need of a replace(/\/+$/g, '') by proper naming.

* Doc switchers: py3k can't reach js, it's redirected server-side by nginx.

* Doc switchers: Examples matching actual regexes.

* Doc switchers: Better fallback on unexisting translated version.

(cherry picked from commit dff9b5f9d6)
2017-08-08 14:14:23 +02:00
Subhendu Ghosh dd6e4aa113 bpo-27470: Improve doc for commandline -3 option
Mention that it warns about features that are significantly changed in Python 3
and can’t be detected using static code analysis.

Link to Porting Python 2 Code to Python 3 doc
2017-08-04 12:00:10 +10:00
Mariatta fa90179e07 Fix trivial typo in multiprocessing documentation (GH-2930) (GH-2942)
(cherry picked from commit 6fcb69dad5)
2017-07-28 19:55:04 -07:00
Aditya Hase 0666d0e504 bpo-30304: Improve TestCase.assertMultiLineEqual docs (GH-2847)
Mention that TestCase.assertMultiLineEqual method is used by default when comparing Unicode string when comparing Unicode strings with assertEqual.
2017-07-25 13:59:52 -07:00
Nicholas 82a77d38d6 [2.7] bpo-30964: Mention ensurepip in package installation docs (GH-2795)
Adds a new 'Pip not installed' section that covers
running `ensurepip` manually, and also references
the relevant section of the Python Packaging User
Guide.

(cherry picked from commit b3527bfefd)
2017-07-21 16:29:44 +10:00
Mariatta 598f26b788 [2.7] Fix typo in Turtle Docs: yingyang -> yinyang (GH-2770) (GH-2780)
(cherry picked from commit fff2a21057)
2017-07-20 07:14:46 -07:00
Ned Deily 3b1e72662a Update doc download files size estimates. (#2774) 2017-07-20 04:45:42 -04:00
Ned Deily 64a9f3d961 bpo-30939: Avoid Sphinx deprecation warning in docs build. (#2721) (#2725)
(cherry picked from commit 50f58163a6)
2017-07-15 23:06:57 -04:00