Talk:Python Style Guide: Difference between revisions
Ian Bicking (talk | contribs) |
Ian Bicking (talk | contribs) |
||
| Line 10: | Line 10: | ||
Is there a mechanism in Python to localize docstrings? Not everyone who will be using Python libraries will speak English. --[[User:IanOsgood|IanOsgood]] 18:37, 17 November 2006 (EST) |
Is there a mechanism in Python to localize docstrings? Not everyone who will be using Python libraries will speak English. --[[User:IanOsgood|IanOsgood]] 18:37, 17 November 2006 (EST) |
||
Not really; docstrings are syntactically required to be plain strings at the beginning of the function/module/class. Potentially the help browser could perform localization lazily. If translation is done after docstring extraction (which is the only feasible thing, I think) then it doesn't have any effect on Python code. -- [[User:Ian Bicking|Ian Bicking]] 22:59, 17 November 2006 (EST) |
|||
Revision as of 03:59, 18 November 2006
Copyright
This document has been placed in the public domain.
[A tiny point, since we're in style guide mode: please don't use public domain dedications, for the same sort of reasons given here, and because the statement can be interpreted differently depending on jurisdiction -- for example, France completely disallows authors to give up their author moral rights. So, I'm all about proper copyright licenses.] Cjb 13:57, 13 November 2006 (EST)
I've just copied the copyright notice from PEP 8. While we can reappropriate the copyright (after all, it's public domain), I'm lazy. I'd defer to the site copyright license, but it's considerably more restrictive and it's nice to keep licensing consistency. I looked for a proper CC license, but they all require attribution. How annoying. Not sure how to paste the HTML in here either. Hrm. Ian Bicking 21:22, 17 November 2006 (EST)
Localized docstrings?
Is there a mechanism in Python to localize docstrings? Not everyone who will be using Python libraries will speak English. --IanOsgood 18:37, 17 November 2006 (EST)
Not really; docstrings are syntactically required to be plain strings at the beginning of the function/module/class. Potentially the help browser could perform localization lazily. If translation is done after docstring extraction (which is the only feasible thing, I think) then it doesn't have any effect on Python code. -- Ian Bicking 22:59, 17 November 2006 (EST)