Mailman 3 August 2014 - docs

[issue22261] Document how to use Concurrent Build when using MsBuild
by Zachary Ware Aug. 29, 2014

Aug. 29, 2014

Zachary Ware added the comment: I finally managed to get a review posted on Rietveld, which should have sent you an email (sorry for the delay!). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue22261> _______________________________________

1 0

Document how to use Concurrent Build when using MsBuild (issue 22261)
by zachary.ware＠gmail.com Aug. 29, 2014

Aug. 29, 2014

Sorry it's taken me longer than expected to give you a review. A couple of things to be addressed, and then we'll be good to go! http://bugs.python.org/review/22261/diff/12760/PCbuild/readme.txt File PCbuild/readme.txt (right): http://bugs.python.org/review/22261/diff/12760/PCbuild/readme.txt#newcode91 PCbuild/readme.txt:91: Please note that normal msbuild switches can also be passed. For example, I think 'MSBuild' is the proper capitalization for 'msbuild'. And we should say that the MSBuild switches must be passed after any of those listed above, you're limited to 9 MSbuild switches, and anything with an = in it must be wrapped in quotes (like "/p:externalsDir=P:\cpython-externals"). And possibly just personal preference, but I don't like the "Please note that" at the beginning of the line; the rest of the line stands fine without it. http://bugs.python.org/review/22261/diff/12760/PCbuild/readme.txt#newcode92 PCbuild/readme.txt:92: build.bat -e -d /m This file isn't quite in reST format, but is close; I'd go ahead and follow the devguide's suggestions for block quoting (blank line before and after, indent 3 spaces). http://bugs.python.org/review/22261/

1 0

Typo Report
by Evan Travis Aug. 28, 2014

Aug. 28, 2014

Web Page: https://docs.python.org/2.6/tutorial/classes.html Section: 9.5.1. Multiple Inheritance Paragraph: “With new-style classes,…” Typo: “…(where *one* at least one of the parent classes…)…” Solution: Remove bolded word à *one*

2 1

Typo Report
by Evan Travis Aug. 28, 2014

Aug. 28, 2014

Web Page: https://docs.python.org/2.6/tutorial/classes.html Section: 9.6. Private Variables Paragraph: “Since there is a valid use-case..." Typo: “…(at least *two* leading undercores, at most *one* trailing underscore)…” Solution: Swap bolded words --> *one* and *two*

1 0

[issue22288] Incorrect Call grammar in documentation
by Martijn Pieters Aug. 28, 2014

Aug. 28, 2014

New submission from Martijn Pieters: The changes for issue #3473 introduced a documentation bug. The Call expression grammar implies that f(*[1, 2], *[3, 4]) is allowed: | "*" `expression` ["," "*" `expression`] ["," "**" `expression`] I think Benjamin meant to use: | "*" `expression` ["," `keyword_arguments `] ["," "**" `expression`] instead, see the corresponding commit for Python 3.x: http://hg.python.org/cpython/diff/6abada05c313/Doc/reference/expressions.rst ---------- assignee: docs@python components: Documentation messages: 225970 nosy: docs@python, mjpieters priority: normal severity: normal status: open title: Incorrect Call grammar in documentation versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue22288> _______________________________________

1 6

Re: [docs] Doc: remove errors about mixed-type comparisons. (issue 12067)
by blckknght＠gmail.com Aug. 28, 2014

Aug. 28, 2014

I think the patch is great, with the exception of one line (which I have several issues with). http://bugs.python.org/review/12067/diff/12409/Doc/reference/expressions.rst File Doc/reference/expressions.rst (right): http://bugs.python.org/review/12067/diff/12409/Doc/reference/expressions.rs… Doc/reference/expressions.rst:1120: Strings cannot directly be compared with binary sequences, and vice versa! I think the "be" is misplaced in this sentence (it should be "cannot be directly compared"). Further, the "and" conjunction seemed so jarring to me I wasn't sure it was even grammatical (though after further consideration I understand it now). I'd suggest dropping the whole "vice versa" clause, since the ability to be compared is symmetric (even if the comparisons themselves are not). It wouldn't make sense to say that A can be compared to B if B cannot be compared to A. And finally, the exclamation mark at the end is a bit overemphatic!!1! tldr, make this sentence: "Strings and binary sequences cannot be directly compared." http://bugs.python.org/review/12067/

1 0

[issue22291] Typo in docs - Lib/random
by Ben Rodrigue Aug. 27, 2014

Aug. 27, 2014

New submission from Ben Rodrigue: Small typo: In the documentation for the random module. The documentation refers to the semi-open range and then gives an example using a left bracket and then a curved parenthesis on the right. Link to page:https://docs.python.org/3.4/library/random.html >From text:"which generates a random float uniformly in the semi-open range [0.0, 1.0)" I am new to programming but I believe this to be incorrect. If there is a way to submit a patch for the documentation, I am happy to do so. ---------- assignee: docs@python components: Documentation messages: 225990 nosy: benrodrigue, docs@python, eric.araujo, ezio.melotti, georg.brandl priority: normal severity: normal status: open title: Typo in docs - Lib/random versions: Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue22291> _______________________________________

2 1

Re: [docs] Doc: remove errors about mixed-type comparisons. (issue 12067)
by vadmium+py＠gmail.com Aug. 27, 2014

Aug. 27, 2014

Some comments on the doc changes https://bugs.python.org/review/12067/diff/12409/Doc/reference/expressions.r… File Doc/reference/expressions.rst (right): https://bugs.python.org/review/12067/diff/12409/Doc/reference/expressions.r… Doc/reference/expressions.rst:1087: The behavior of the default equality comparison that instances with different Needs a comma between “comparison, that” https://bugs.python.org/review/12067/diff/12409/Doc/reference/expressions.r… Doc/reference/expressions.rst:1096: otherwise, :exc:`TypeError` is raised: Everything is an instance of the built-in type “object”, and “subtypes of each other” does not make much sense to me. I think the cases where TypeError is raised or not by default are already described above. Would it hurt to just drop the second sentence? https://bugs.python.org/review/12067/diff/12409/Doc/reference/expressions.r… Doc/reference/expressions.rst:1149: each other), have the same length, and each pair of corresponding elements Again, “subtypes of each other” does not make sense. Maybe just say you cannot compare between lists, tuples, and ranges [and byte sequences and text strings] this way. [I understand comparing the different kinds of byte sequences is meant to work though.] https://bugs.python.org/review/12067/diff/12409/Doc/reference/expressions.r… Doc/reference/expressions.rst:1156: * Mappings (instances of :class:`dict`) are compared lexicographically using Not sure “lexicographical comparison” makes sense unless the items have an order. Maybe the original wording was better? https://bugs.python.org/review/12067/diff/12409/Doc/reference/expressions.r… Doc/reference/expressions.rst:1216: sequences and mappings, but not to sets). See also the Perhaps drop “mappings”; even OrderedDict does not do ordering comparisons for me https://bugs.python.org/review/12067/

1 0

[issue12855] linebreak sequences should be better documented
by Martin Panter Aug. 27, 2014

Aug. 27, 2014

Martin Panter added the comment: Any reason why characters 1C–1E are excluded? ---------- nosy: +vadmium _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12855> _______________________________________

1 0

How to embed python in python ?
by Sthanki, Dinesh Aug. 26, 2014

Aug. 26, 2014

Sorry, 'docs', I did not know who to submit this to. I need to write an IDE to run some Python Scripts, I could attempt that in C#, but , why not write the actual IDE in python, to run python code ? Here is some not very successful attempt run Python script (one liner) from python This is an assortment of things I found on the web, mind you, no one is attempting to run python in a python script (embed python in a python script, how about that for a twist ?). from ctypes import * from sys import getsizeof from binascii import hexlify xPyLib = windll.LoadLibrary("python34.dll") # This works partially #xPyLib = windll.LoadLibrary("C:\Python34\DLLs\python3.dll") # This works partially too xPyLib.Py_SetProgramName(); xPyLib.Py_Initialize(); status = xPyLib.Py_IsInitialized(); # check If Python is Initialized if status==1: print ("Python is Initialized Successfully") vers = xPyLib.Py_GetVersion(); # CHECK OUT THE GARBAGE VERSION DATA HERE Platform = xPyLib.Py_GetPlatform() # CHECK OUT THE GARBAGE VERSION DATA HERE print ("Python Vers: "+str(hexlify(string_at(id(vers), getsizeof(vers))))) print ("Platform: "+str(hexlify(string_at(id(Platform), getsizeof(Platform))))) #print ("Platform: "+str(xPyLib.Py_GetPlatform())) Command = "x=2" status = xPyLib.PyRun_String(Command); xPyLib.Finalize(); else: print ("*** Failed to Initialize Python ***") exit() Oh, one of the FAQ's should be "How do I submit a question ?" Thank you for your time. Dinesh Sthanki Desk: 770-302-1201 Cell: 678-895-6120

1 0