Mailman 3 May 2014 - docs

[issue21439] Numerous minor issues in Language Reference
by Raymond Hettinger May 10, 2014

May 10, 2014

Raymond Hettinger added the comment: I also don't agree with most of the typographic changes and, like Éric find some of the grammar changes to be pedantic. The OP refers to his own changes as "editorial infelicities". This should have been a warning sign. The OP further warns, "I have been reading the Language Reference Manual in order to teach myself Python 3" which explains why Éric has found " a few misunderstandings of Python". If the OP cares enough to prepare a chapter by chapter patch (as suggested by Terry), I would be happy to review them one by one, applying any that are actual readability improvements. ---------- assignee: zach.ware -> rhettinger nosy: +rhettinger priority: normal -> low versions: -Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21439> _______________________________________

1 0

[issue21439] Numerous minor issues in Language Reference
by Terry J. Reedy May 10, 2014

May 10, 2014

Terry J. Reedy added the comment: I suggest at least a patch per chapter (3.x.y, 4.x.y, 6.x.y, ...). ---------- nosy: +terry.reedy _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21439> _______________________________________

1 0

Where can I get help about python3?
by 1 2 May 10, 2014

May 10, 2014

Hi there, I am just a rookie who just started to learn python and I am going to start right from python3. Pls, help

2 2

[issue21439] Numerous minor issues in Language Reference
by Éric Araujo May 9, 2014

May 9, 2014

Éric Araujo added the comment: BTW my opinion of the proposed changes is that many of them are good (obvious typos, reports of things unclear to a beginner, etc) but I don’t agree with some typographic changes, I find that some grammar changes are pedantic, and there are even a few misunderstandings of Python. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21439> _______________________________________

1 0

[issue21439] Numerous minor issues in Language Reference
by Éric Araujo May 9, 2014

May 9, 2014

Éric Araujo added the comment: Attaching plain text version. ---------- nosy: +eric.araujo Added file: http://bugs.python.org/file35201/PythonRefmanual_3_4_0_Errata.txt _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21439> _______________________________________

1 0

[issue21300] Docs (incorrectly) suggest email.policy.default is the default policy
by Merlijn van Deen May 8, 2014

May 8, 2014

New submission from Merlijn van Deen: Which would make sense, but email.policy.Compat32 is *actually* the default policy. This patch adapts the documentation to reflect this. ---------- assignee: docs@python components: Documentation files: defaultpolicy.diff keywords: patch messages: 216783 nosy: docs@python, r.david.murray, valhallasw priority: normal severity: normal status: open title: Docs (incorrectly) suggest email.policy.default is the default policy versions: Python 3.3, Python 3.4, Python 3.5 Added file: http://bugs.python.org/file34964/defaultpolicy.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21300> _______________________________________

3 6

[issue13030] Be more generic when identifying the Windows main dir in installation doc
by Sandro Tosi May 6, 2014

May 6, 2014

New submission from Sandro Tosi <sandro.tosi(a)gmail.com>: Given I have no knowledge of the windows system, I'm just proxying http://mail.python.org/pipermail/docs/2011-September/005793.html : >>> Under: http://docs.python.org/install/index.html#inst-how-install-works It notes "Windows prefix\Lib\site-packages C:\PythonXY\Lib\site-packages" for default values on Windows. In the paragraph following the table is the text: "prefix and exec-prefix stand for the directories that Python is installed to, and where it finds its libraries at run-time. They are always the same under Windows, and very often the same under Unix and Mac OS X. " I don't know if it's hardcoded into Python distributions to use C, but it's not correct. The correct way to identify what most people think of as C is via the %SYSTEMROOT% environment variable, so the path described would be "%SYSTEMROOT%\PythonXY\Lib\site-packages" (This is still not the correct way to do things on Windows, but it at least shouldn't break on systems with a %SYSTEMROOT% other than C. I've seen configurations like that on systems which boot multiple versions of Windows.) <<< ---------- assignee: docs@python components: Documentation messages: 144422 nosy: brian.curtin, docs@python, sandro.tosi, tim.golden priority: normal severity: normal stage: needs patch status: open title: Be more generic when identifying the Windows main dir in installation doc type: behavior versions: Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13030> _______________________________________

4 5

[issue21366] Document that return in finally overwrites prev value
by Jon Brandvein May 6, 2014

May 6, 2014

New submission from Jon Brandvein: def foo(): try: return 1 finally; return 2 print(foo()) # 2 I've seen this peculiar case discussed on a few blogs lately, but was unable to find confirmation that this behavior is defined. In the try/finally section of Doc/reference/compound_stmts.rst, immediately after the sentence beginning > When a return, break, or continue statement is executed I propose adding something to the effect of: > A return statement in a finally clause overrides the value of any return statement executed in the try suite. This wording also handles the case of nested try/finally blocks. ---------- assignee: docs@python components: Documentation messages: 217277 nosy: brandjon, docs@python priority: normal severity: normal status: open title: Document that return in finally overwrites prev value type: behavior _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21366> _______________________________________

5 8

The Language Reference Manual: a list of suggested improvements
by Feliks Kluzniak May 5, 2014

May 5, 2014

Hello! I have been reading the Language Reference Manual in order to teach myself Python 3. I noticed several minor errors, and a much larger number of linguistic or editorial infelicities. I have listed them all in the enclosed document: I hope it will be useful. Sincerely, — Feliks Kluzniak P.S. My apologies for not having the time to weed out those remarks which might already have been entered into the list of „documentation bugs”.

2 1

[issue21439] Numerous minor issues in Language Reference
by Zachary Ware May 5, 2014

May 5, 2014

Changes by Zachary Ware <zachary.ware(a)gmail.com>: ---------- nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21439> _______________________________________

1 0