[issue22558] Missing hint to source code - complete

2016-01-06 Thread Terry J. Reedy
Changes by Terry J. Reedy : -- versions: +Python 3.6 -Python 3.4 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue22558] Missing hint to source code - complete

2016-01-06 Thread Terry J. Reedy
Terry J. Reedy added the comment: If there is a New-in note (which follows Synopsis), then (to be consistent) the Source note should follow it. If not (the normal situation), then Source follows Synopsis directly. A point in favor of linking all Python sources from the docs is that default s

[issue22558] Missing hint to source code - complete

2016-01-05 Thread Guido van Rossum
Guido van Rossum added the comment: It's fine to add a source link to any module for which there is Python source code. I suppose this adds a slight maintenance burden when a module moves (e.g. when a module is turned into a package, or when the subdirectory structure of the Lib directory cha

[issue22558] Missing hint to source code - complete

2016-01-05 Thread Terry J. Reedy
Terry J. Reedy added the comment: Guido, should we take your comment as approving linking every source, as opposed to only some? This scope issue is the main sticking point for this issue. Otherwise, the standard patch is 3 easy new lines after the :synopsis: (and any 'New in Version x.y' no

[issue22558] Missing hint to source code - complete

2016-01-05 Thread Guido van Rossum
Guido van Rossum added the comment: Actually uploading a patch for this should be easy, right? -- keywords: +easy nosy: +gvanrossum ___ Python tracker ___ ___

[issue22558] Missing hint to source code - complete

2014-11-11 Thread Alexander Belopolsky
Alexander Belopolsky added the comment: +1 "to add links to all the [Python] modules" If the code is not readable, hard to understand or not self-documenting that's the reason to improve the code not to make it harder to find and see. -- nosy: +belopolsky _

[issue22558] Missing hint to source code - complete

2014-11-02 Thread Ezio Melotti
Ezio Melotti added the comment: The source links have been added where the code proved to be readable, easy to understand, and self documenting, and have been omitted when the code is complicated and not self documenting. This has been done under the assumption that reading the code might hel

[issue22558] Missing hint to source code - complete

2014-10-10 Thread Terry J. Reedy
Terry J. Reedy added the comment: Messages and patches can be unlinked from an issue (and that action recorded in the history list) but not edited. Proofread before clicking. Originally, only a few module docs had a source code link where the source code was thought to be especially useful.

[issue22558] Missing hint to source code - complete

2014-10-05 Thread Friedrich Spee von Langenfeld
Friedrich Spee von Langenfeld added the comment: I decremented the shown number of modules by 25. Here is the new list: https://docs.python.org/3/library/base64.html https://docs.python.org/3/library/binhex.html https://docs.python.org/3/library/bz2.html https://docs.python.org/3/library/cgitb.h

[issue22558] Missing hint to source code - complete

2014-10-05 Thread R. David Murray
R. David Murray added the comment: And that have source code. That said, some modules may have been consciously omitted. -- nosy: +r.david.murray, rhettinger ___ Python tracker

[issue22558] Missing hint to source code - complete

2014-10-05 Thread SilentGhost
SilentGhost added the comment: Your code produces many false positives, would you care to reduce this list to only those modules that actually do not have a Source code link? -- nosy: +SilentGhost ___ Python tracker

[issue22558] Missing hint to source code - complete

2014-10-05 Thread Friedrich Spee von Langenfeld
New submission from Friedrich Spee von Langenfeld: As mentioned in Issue22528, in some modules´ documentation, the link to their source code is missing. To check the stdlib, I´ve written the script missing_hint.py. It seems that in the following module entries, there aren´t a link to their sou