Mailman 3 May 2017 - docs

[issue29898] PYTHONLEGACYWINDOWSIOENCODING isn't implemented
by Berker Peksag May 16, 2017

May 16, 2017

Changes by Berker Peksag <berker.peksag(a)gmail.com>: ---------- stage: test needed -> backport needed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29898> _______________________________________

1 0

[issue29898] PYTHONLEGACYWINDOWSIOENCODING isn't implemented
by Berker Peksag May 16, 2017

May 16, 2017

Berker Peksag added the comment: New changeset 87fa8a780e9045a26c735f085c07bba4b2d0be60 by Berker Peksag in branch 'master': bpo-29898: Fix incorrect env variable name (GH-1576) https://github.com/python/cpython/commit/87fa8a780e9045a26c735f085c07bba4b2… ---------- nosy: +berker.peksag _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29898> _______________________________________

1 0

[issue29651] Inconsistent/undocumented urlsplit/urlparse behavior on invalid inputs
by Vasiliy Faronov May 16, 2017

May 16, 2017

New submission from Vasiliy Faronov: There is a problem with the standard library's urlsplit and urlparse functions, in Python 2.7 (module urlparse) and 3.2+ (module urllib.parse). The documentation for these functions [1] does not explain how they behave when given an invalid URL. One could try invoking them manually and conclude that they tolerate anything thrown at them: >>> urlparse('http:////::\\\\!!::!!++///') ParseResult(scheme='http', netloc='', path='//::\\\\!!::!!++///', … [View More]

7 11

[issue30373] Incomplete description of re.LOCALE
by Jakub Wilk May 15, 2017

May 15, 2017

New submission from Jakub Wilk: <https://docs.python.org/3/library/re.html#re.LOCALE> reads: "Make \w, \W, \b, \B, \s and \S dependent on the current locale." But this is not the only thing this flag does. When combined with re.IGNORECASE, it also makes case-insesitive matching locale-dependent. ---------- assignee: docs@python components: Documentation messages: 293726 nosy: docs@python, jwilk priority: normal severity: normal status: open title: Incomplete description of re.LOCALE … [View More]

2 1

Re: [docs] I would like to contribute to the Python documentation
by INADA Naoki May 15, 2017

May 15, 2017

On Mon, May 15, 2017 at 6:54 PM, Gustavo Toffo <gustavotoffo(a)gmail.com> wrote: > I'd be more than happy to be the coordinator on the Portuguese language > section > > And honestly, there aren't major differences between brazil's and portugal's > portuguese. You can think of it like british and american english, although > there are some difference in words, meanings and expressions, the flow of > the language tends to be the same, and since I was born and raised in … [View More]> portugal by my mostly brazilian family I'm well acquainted with all the > proper terms of both accents. > > But if I had to make a choice it'd be pt_br while making sure the terms are > understood by pt_pt. There is `pt` language which is not activated yet. Which do you prefer? `pt` or `pt_BR`? > > Also, I'd be more than happy that my translation is redistributed in OSS > license > > All I'd like is basically the following; > > - To have my name and e-mail contact on the translation so people know who > the translator is and who to contact and so on > See this page: https://docs.python.org/3/about.html#contributors-to-the-python-documentati… I think all contributors will be listed somewhere like that. But we're in planning phase. There are no actual translated page under docs.python.org yet. Of course, you can build translated document from source and Transifex by yourself and publish it under PSF license. > - To have a link (even if it's a website I myself create which wouldn't be > much of a problem) to books both free and paid on how to learn Python (since > I think you can agree that learning Python by the syntax itself is a bit too > abstract) and for more advanced topic such as machine learning and so on. > > Can I do this with the OSS license? Thank you > Maybe, docs hosted under docs.python.org will be "sentense-by-sentense" translation. But you can build customized version and publish it by yourself too. > > 2017-05-15 5:05 GMT-03:00 INADA Naoki <songofacandy(a)gmail.com>: >> >> Hi, Gustavo. >> >> I'm grad to hear that you're interested in translating Python document. >> >> Julien Palard is working on making doc translation easier. >> Please see PEP 545 (https://www.python.org/dev/peps/pep-0545/ ) >> >> If you're happy about your translation is redistributed in OSS license, >> you can start translating on Transifex without waiting PEP 545 is >> accepted. >> https://www.transifex.com/python-doc/python-36/dashboard/ >> >> I want to assign you as a coordinator of Portuguese. >> >> But I'm not familiar with Portuguese. >> There are pt_BR and pt_PT in Python project on Transifex. (Both are >> inactive). >> Are they different language like cn_TW and cn_ZH? >> Which language do you want to lead? pt_PT, pt_BR or pt? >> >> Regards, >> >> >> On Wed, May 10, 2017 at 12:12 AM, Gustavo Toffo <gustavotoffo(a)gmail.com> >> wrote: >> > Hello! >> > >> > I would like to contribute to the wonderful language that is Python. >> > >> > I've noticed that the portuguese documentation of Python is either >> > severely >> > lacking or not updated. >> > >> > I would like to help out and offer to translate the documentation and >> > provide working resources, whether updated examples, books that are >> > updated, >> > including books of my own, all in the documentation to better help teach >> > Python. >> > >> > I will do the work for free although I would very much appreciate some >> > mention of my contribution. My primary concern is in making sure that >> > Python >> > reaches as many people as possible with the best quality that it can. >> > >> > I want to eventually translate the whole website in order to make it >> > available to the Portuguese speaking audiences (of which I'm a native) >> > >> > I'm sending along a 3 page sample of my work. I've translated the >> > beginner's >> > guide and purposefuly left at the side some of the original text just so >> > you >> > can be assured of my quality of work. >> > >> > Thank you for all your efforts in this wonderful language >> > >> > Grandes abraços! >> > >> > >> > >> > _______________________________________________ >> > docs mailing list >> > docs(a)python.org >> > https://mail.python.org/mailman/listinfo/docs >> > > > [View Less]

1 0

I would like to contribute to the Python documentation
by Gustavo Toffo May 15, 2017

May 15, 2017

Hello! I would like to contribute to the wonderful language that is Python. I've noticed that the portuguese documentation of Python is either severely lacking or not updated. I would like to help out and offer to translate the documentation and provide working resources, whether updated examples, books that are updated, including books of my own, all in the documentation to better help teach Python. I will do the work for free although I would very much appreciate some mention of my … [View More]

2 1

[issue30358] Profile documentation - include sort argument for runctx
by Berker Peksag May 14, 2017

May 14, 2017

New submission from Berker Peksag: For future reference, this was also reported by Chris Cummins on docs(a)p.o at https://mail.python.org/pipermail/docs/2017-May/031420.html ---------- nosy: +berker.peksag stage: -> patch review versions: +Python 3.5, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30358> _______________________________________

1 7

'sort' argument to profile.runctx is undocumented
by Chris Cummins May 14, 2017

May 14, 2017

Hi, The runctx function in the profile module accepts sort as an optional keyword, but this is undocumented. The sort keyword was added in Py 3.2: https://bugs.python.org/issue9898 It would be nice if the documentation could be updated to reflect this. Cheers, Chris

2 1

[issue29898] PYTHONLEGACYWINDOWSIOENCODING isn't implemented
by Berker Peksag May 14, 2017

May 14, 2017

Changes by Berker Peksag <berker.peksag(a)gmail.com>: ---------- pull_requests: +1669 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29898> _______________________________________

1 0

[issue11681] -b option undocumented
by Éric Araujo May 13, 2017

May 13, 2017

New submission from Éric Araujo <merwok(a)netwok.org>: Python 2 has a -b command-line option which is undocumented. It is used by the warnings machinery to decide to warn about (-b) or raise an error (-bb) if someone uses str(bytes) or str(buffer) (explanation courtesy of grep and Python/pythonrun.c). ---------- assignee: docs@python components: Documentation keywords: easy messages: 132195 nosy: docs@python, eric.araujo priority: normal severity: normal stage: needs patch status: open … [View More]

11 22