Mailman 3 April 2017 - docs

Re: [docs] Sync-up docstrings in C version of the the decimal module (issue 27779)
by stefan＠bytereef.org April 6, 2017

April 6, 2017

https://bugs.python.org/review/27779/diff/18450/Modules/_decimal/docstrings… File Modules/_decimal/docstrings.h (right): https://bugs.python.org/review/27779/diff/18450/Modules/_decimal/docstrings… Modules/_decimal/docstrings.h:244: Represents the number as a triple tuple, to show the internals exactly as\n\ I meant "show the internals exactly as they are". This is not true for the C version. It is not true for the Python version because it uses a string for the coefficient -- the initial version had the tuple IIRC. https://bugs.python.org/review/27779/

1 0

[issue30002] Minor change to https://docs.python.org/3.6/extending/building.html
by Arthur Goldberg April 6, 2017

April 6, 2017

New submission from Arthur Goldberg: The core example on this page starts: from distutils.core import setup, Extension module1 = Extension('demo', sources = ['demo.c']) ... I suggest that 'sources = ['demo.c']' be changed to 'sources = ['demomodule.c']', because this would make the example consistent with https://docs.python.org/3.6/extending/extending.html which says: "Begin by creating a file spammodule.c. (Historically, if a module is called spam, the C file containing its implementation is called spammodule.c; ... )" This minor change may help encourage this standard practice. Arthur ---------- assignee: docs@python components: Documentation messages: 291203 nosy: ArthurGoldberg, docs@python priority: normal severity: normal status: open title: Minor change to https://docs.python.org/3.6/extending/building.html type: behavior versions: Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30002> _______________________________________

2 1

[issue29997] Suggested changes for https://docs.python.org/3.6/extending/extending.html
by Arthur Goldberg April 5, 2017

April 5, 2017

New submission from Arthur Goldberg: I've just taught myself how to write C extensions to Python with https://docs.python.org/3.6/extending/extending.html. I think it's quite good. Nevertheless, I've some suggested improvements. These all use the vi s/// replacement syntax. Ambiguous 'it': s/If the latter header file does not exist on your system, it declares the functions malloc(), free() and realloc() directly./If the latter header file does not exist on your system, Python.h declares the functions malloc(), free() and realloc() directly./ Unclear, as 'The C function' refers to the specific example, whereas 'always has' implies that this applies to all calls from Python to C: s/The C function always has two arguments, conventionally/A C function called by Python always has two arguments, conventionally/ In PyMODINIT_FUNC PyInit_spam(void) { PyObject *m; m = PyModule_Create(&spammodule); if (m == NULL) return NULL; SpamError = PyErr_NewException("spam.error", NULL, NULL); Py_INCREF(SpamError); PyModule_AddObject(m, "error", SpamError); return m; } remove m = PyModule_Create(&spammodule); if (m == NULL) return NULL; and replace it with ... because it won't compile because spammodule has not been described yet on the page. Self-contradictory: 'normally always' is an oxymoron. s/It should normally always be METH_VARARGS or METH_VARARGS | METH_KEYWORDS; a value of 0 means that an obsolete variant of PyArg_ParseTuple() is used./It should always be METH_VARARGS or METH_VARARGS | METH_KEYWORDS; however, legacy code may use 0, which indicates that an obsolete variant of PyArg_ParseTuple() is being used./ Incomplete: this comment doesn't contain a complete thought s/module documentation, may be NULL/pointer to a string containing the module's documentation, or NULL if none is provided/ Provide hyperlink: for user convenience, add a hyperlink to 'Modules/xxmodule.c' s/included in the Python source distribution as Modules/xxmodule.c/included in the Python source distribution as Modules/xxmodule.c/ Incomplete: It would be good to lead programmers towards the easiest approach. s/ If you use dynamic loading,/<new paragraph> If you can use dynamic loading, the the easiest approach is to use Python's distutils module to build your module. If you use dynamic loading,/ ---------- assignee: docs@python components: Documentation messages: 291192 nosy: ArthurGoldberg, docs@python priority: normal severity: normal status: open title: Suggested changes for https://docs.python.org/3.6/extending/extending.html type: behavior versions: Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29997> _______________________________________

2 2

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Dominic Mayers April 5, 2017

April 5, 2017

Changes by Dominic Mayers <dominic_mayers(a)yahoo.com>: Removed file: http://bugs.python.org/file46775/Issue29947_for_discussion_03.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29947> _______________________________________

1 0

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Dominic Mayers April 5, 2017

April 5, 2017

Dominic Mayers added the comment: An improved version of the patch, I hope. I will remove the old patch, because it's really does not help to see the old versions. ---------- Added file: http://bugs.python.org/file46781/Issue29947_for_discussion_04.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29947> _______________________________________

1 0

[issue28415] PyUnicode_FromFormat integer format handling different from printf about zeropad
by Terry J. Reedy April 5, 2017

April 5, 2017

Terry J. Reedy added the comment: (Response to what I believe is latest patch.) In msg278666, my two suggestions were 'either...or', not both. The list came from Antti's msg278528, but the correct list for Python appears to be different, and different for bytes and unicode. When I made the suggestion, I did not realize that 'exactly' was repeated for each conversion type in a table. As a note, I think the following might work. "For <list of> conversion types, the 0-conversion flag has effect even when a precision is given." I also think that 'exactly could be dropped when it is not exactly true. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28415> _______________________________________

1 0

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Dominic Mayers April 4, 2017

April 4, 2017

Changes by Dominic Mayers <dominic_mayers(a)yahoo.com>: Added file: http://bugs.python.org/file46775/Issue29947_for_discussion_03.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29947> _______________________________________

1 0

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Dominic Mayers April 4, 2017

April 4, 2017

Changes by Dominic Mayers <dominic_mayers(a)yahoo.com>: Removed file: http://bugs.python.org/file46774/Issue29947_for_discussion_02.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29947> _______________________________________

1 0

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Dominic Mayers April 4, 2017

April 4, 2017

Changes by Dominic Mayers <dominic_mayers(a)yahoo.com>: Removed file: http://bugs.python.org/file46770/Issue29947_for_discussion.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29947> _______________________________________

1 0

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Dominic Mayers April 4, 2017

April 4, 2017

Dominic Mayers added the comment: I simplified the patch. Using a class as a factory function is the simplest case, so I took advantage of this. I also give one way to pass extra parameters to the handler in the factory function, because it's the main reason why we cannot always use a class. ---------- Added file: http://bugs.python.org/file46774/Issue29947_for_discussion_02.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29947> _______________________________________

1 0