Re: Javadoc style python manual?

2006-09-10 Thread xiong . xu . cn
Thanks for all replies regard with this question! I think I will get used to python help system:) Maybe I will look into epydoc, too... -Xiong Michele Simionato 写道: > Ben Sizer wrote: > > Michele Simionato wrote: > > > Ben Sizer wrote: > > > > I agree that the Python docs aren't quite as effecti

Re: Javadoc style python manual?

2006-09-08 Thread Paul Boddie
John J. Lee wrote: > [epydoc on the standard library] > Why do you expect to get useful docs that way? The canonical Python > stdlib docs live in LaTeX files, not in the docstrings. You may find > some useful bits and pieces in the docstrings too, or you may not. But wasn't the questioner reco

Re: Javadoc style python manual?

2006-09-08 Thread Paul Rubin
[EMAIL PROTECTED] (John J. Lee) writes: > Why do you expect to get useful docs that way? The canonical Python > stdlib docs live in LaTeX files, not in the docstrings. You may find > some useful bits and pieces in the docstrings too, or you may not. Yucch. From http://www.gnu.org/software/em

Re: Javadoc style python manual?

2006-09-08 Thread John J. Lee
"Paul Boddie" <[EMAIL PROTECTED]> writes: [...] > Better usage of the find command could be made, and the resulting > process occupied over 0.5GB before producing 581MB of API documents on > disk. The resulting output reveals some major differences between some > modules and in the quality of the d

Re: Javadoc style python manual?

2006-09-08 Thread John J. Lee
[EMAIL PROTECTED] writes: > Hi there, > > I'm new to python and I'm from the java world. > Though I love to learn python, I'm not very comfortable with the python > documentation. > Because when i read jdk doc, i can see the class hierachy, class > member, class methods etc in html docs. It's ver

Re: Javadoc style python manual?

2006-09-08 Thread Paul Boddie
Ben Sizer wrote: > [EMAIL PROTECTED] wrote: > > I'm new to python and I'm from the java world. > > Though I love to learn python, I'm not very comfortable with the python > > documentation. > > Because when i read jdk doc, i can see the class hierachy, class > > member, class methods etc in html do

Re: Javadoc style python manual?

2006-09-08 Thread Michele Simionato
Ben Sizer wrote: > Michele Simionato wrote: > > Ben Sizer wrote: > > > I agree that the Python docs aren't quite as effective as reference > > > material due to the lack of simple function and method lists though. > > > > http://docs.python.org/lib/modindex.html, pydoc and ipython are more > > tha

Re: Javadoc style python manual?

2006-09-08 Thread Ben Sizer
Michele Simionato wrote: > Ben Sizer wrote: > > I agree that the Python docs aren't quite as effective as reference > > material due to the lack of simple function and method lists though. > > http://docs.python.org/lib/modindex.html, pydoc and ipython are more > than enough for me. modindex is co

Re: Javadoc style python manual?

2006-09-08 Thread Michele Simionato
Ben Sizer wrote: > I agree that the Python docs aren't quite as effective as reference > material due to the lack of simple function and method lists though. http://docs.python.org/lib/modindex.html, pydoc and ipython are more than enough for me. Michele Simionato -- http://ma

Re: Javadoc style python manual?

2006-09-08 Thread db
On Fri, 08 Sep 2006 01:11:06 -0700, xiong.xu.cn wrote: > Hi there, > > I'm new to python and I'm from the java world. > Though I love to learn python, I'm not very comfortable with the python > documentation. > Because when i read jdk doc, i can see the class hierachy, class > member, class metho

Re: Javadoc style python manual?

2006-09-08 Thread Rob Wolfe
[EMAIL PROTECTED] wrote: > Hi there, > > I'm new to python and I'm from the java world. > Though I love to learn python, I'm not very comfortable with the python > documentation. > Because when i read jdk doc, i can see the class hierachy, class > member, class methods etc in html docs. It's very

Re: Javadoc style python manual?

2006-09-08 Thread Ben Sizer
[EMAIL PROTECTED] wrote: > I'm new to python and I'm from the java world. > Though I love to learn python, I'm not very comfortable with the python > documentation. > Because when i read jdk doc, i can see the class hierachy, class > member, class methods etc in html docs. It's very easy for me to

Javadoc style python manual?

2006-09-08 Thread xiong . xu . cn
Hi there, I'm new to python and I'm from the java world. Though I love to learn python, I'm not very comfortable with the python documentation. Because when i read jdk doc, i can see the class hierachy, class member, class methods etc in html docs. It's very easy for me to understand the Java lang