<div dir="ltr"><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Nov 20, 2014 at 9:54 AM,  <span dir="ltr"><<a href="mailto:jstnms123@gmail.com" target="_blank">jstnms123@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div id=":2vk" class="" style="overflow:hidden">> Here is an *entirely typical* example: on some Unix, try<br>
><br>
> % pydoc urllib<br></div></blockquote></div><div class="gmail_extra"><br></div>I don't know who "kj" is, and jstnms123 seems to be basically off his rocker, so I won't try cc'ing either of them. (They also seem to misunderstand the nature of contributing to open source software, but I'll ignore that.)</div><div class="gmail_extra"><br></div><div class="gmail_extra">Hopefully I'm not duplicating someone else's response. I just stumbled on this thread. A couple things to note. One, pydoc just assembles the documentation strings for the item you asked for. Python has both inline documentation (meant to be brief, quick reference material) and long form documentation (the library and reference documentation, as well as the tutorial.) Pydoc just extracts what is available at the interpreter prompt if you execute</div><div class="gmail_extra"><br></div><div class="gmail_extra">import urllib</div><div class="gmail_extra">help(urllib)</div><div class="gmail_extra"><br></div><div class="gmail_extra">That is meant to answer quick questions like, "what arguments does urllib.urlopen accept?", not, "what's the overall intent of the urllib module?". Despite its admitted brevity, note that if you ask pydoc for a module's documentation, that at the very top of its output, it also identifies the location of the source code on your system and refers you to the long form online documentation:</div><div class="gmail_extra"><br></div><blockquote style="margin:0px 0px 0px 40px;border:none;padding:0px"><div class="gmail_extra"><div class="gmail_extra"><font face="monospace">Help on module urllib:</font></div></div><div class="gmail_extra"><div class="gmail_extra"><font face="monospace"><br></font></div></div><div class="gmail_extra"><div class="gmail_extra"><font face="monospace">NAME</font></div></div><div class="gmail_extra"><div class="gmail_extra"><font face="monospace">    urllib - Open an arbitrary URL.</font></div></div><div class="gmail_extra"><div class="gmail_extra"><font face="monospace"><br></font></div></div><div class="gmail_extra"><div class="gmail_extra"><font face="monospace">FILE</font></div></div><div class="gmail_extra"><div class="gmail_extra"><font face="monospace">    /opt/TWWfsw/python27/lib/python2.7/urllib.py</font></div></div><div class="gmail_extra"><div class="gmail_extra"><font face="monospace"><br></font></div></div><div class="gmail_extra"><div class="gmail_extra"><font face="monospace">MODULE DOCS</font></div></div><div class="gmail_extra"><div class="gmail_extra"><font face="monospace">    <a href="http://docs.python.org/library/urllib">http://docs.python.org/library/urllib</a></font></div></div><div class="gmail_extra"><div class="gmail_extra"><font face="monospace"><br></font></div></div><div class="gmail_extra"><div class="gmail_extra"><font face="monospace">DESCRIPTION</font></div></div><div class="gmail_extra"><div><font face="monospace">    ...</font></div></div></blockquote><div class="gmail_extra"><div><br></div><div>I in no way mean to suggest that the documentation can't be improved. I'm simply pointing out that the documentation is almost certainly better than kj and jstnms123 give the authors credit for. I added that particular feature to the pydoc module over ten years ago, so I know it is highly unlikely your version of pydoc is missing this feature.</div><div><br></div><div>Skip</div><div><br></div></div></div>