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 … [View More]

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, … [View More]

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 … [View More]

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 … [View More]

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