请问一下PYTHON有没有和JAVA一样的API介绍的文档啊

jhbmail

python的模块很多都是直接扔在lib的根目录下，没有很好的组织，而且多如牛毛，让人眼花缭乱。也就是说python虽然也有package，但是此package实际上相当于namespace，和java的package概念是不一样的。

------------------------------------------------------------

    namespace其实是一种比java的package更好的机制，名称空间其实就该和实际的物理位置无关。直接扔在lib的根目录也没有关系，你只要知道namespace就行。

jhbmail

文档上方法或者函数签名中的参数和返回值没有类型，只有通过它的说明才能略知一二。特别是返回值，经常需要跑到命令行执行一下，然后用type和dir看返回的是个啥东东。而javadoc里面是有类型的，而且是链接，可以点来点去，相关的类之间都是可以串起来的，所以非常方便。

---------------------------------------------------------
很多IDE都可以显示方法的doc string 内容，这里一般都包括了参数和返回值的类型，根本不需要去试什么。

jkit

原帖由 jhbmail 于 2006-6-15 02:26 发表
namespace其实是一种比java的package更好的机制，名称空间其实就该和实际的物理位置无关。直接扔在lib的根目录也没有关系，你只要知道namespace就行。

整一个胡说八道! 都懒得辩解了。

原帖由 jhbmail 于 2006-6-15 02:32 发表
很多IDE都可以显示方法的doc string 内容，这里一般都包括了参数和返回值的类型，根本不需要去试什么。

又一个胡说八道！
1：离题，我们在谈文档，你在说IDE
2：简单明了的函数签名和大段大段的doc string谁更方便？如果看了半天才找到是返回oddclass类型，你还得到处去找oddclass的说明！（注：javadoc里面引用到其他类的地方是链接，可以直接点过去的）

flw

原帖由 jkit 于 2006-6-10 14:16 发表


如果有返回类型说明，例如 void mymod.sort(myobj), 那么立刻就知道是直接用mymod.sort(myobj)，
如果是 myobj mymod.sort(myobj)，你也立刻就能知道该用 myobjsorted = mymod.sort(myobj)

到底应该是那种情况你去看文档不就知道了？

每个模块都有自己的文档，
而标准模块的文档更是随处可见，
你不看文档，当然不知道了！

jhbmail

QUOTE:
原帖由 jhbmail 于 2006-6-15 02:26 发表
namespace其实是一种比java的package更好的机制，名称空间其实就该和实际的物理位置无关。直接扔在lib的根目录也没有关系，你只要知道namespace就行。
整一个胡说八道! 都懒得辩解了。

-----------------------------------------------------------------
呵呵，不好意思啊，可能这个我理解不深吧，只是c++,c#啊这些都是用的名称空间，好像更方便哦。package的优点到底是什么请jkit给我讲讲好吗？谢谢。

flw

原帖由 jkit 于 2006-6-8 09:33 发表
纯html文件的javadoc我觉得就已经很好用了，因为它层次分明，很容易找到想要的文档，根本就不需要搜索。
而python的文档是chm的，因为chm支持搜索，所以也还凑合着可以用，如果不能搜索的话，特别是对于新手来说 ...

晕～
难道你不知道，chm 其实就是打包过的 html？
晕～
如果你高兴，你还可以把它变成 PDF 格式的，
是什么格式并不重要，
HTML 格式的 Python 文档也不是没有，这里就有：
http://www.python.org/doc/

jhbmail

1：离题，我们在谈文档，你在说IDE

------------------------------------------------------------
这个我不太认同哦，如果用IDE的时候自动就提示出来了，就没必要到文档里找了吧？我们的目的都是获得信息，不是吗？

简单明了的函数签名和大段大段的doc string？？呵呵，可能你习惯用emacs啊这些没有这个功能的编辑器了吧，听说高手都用这个的，我用的pydev提示出来可只有一句话哦，很简洁的。

＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃

如果看了半天才找到是返回oddclass类型，你还得到处去找oddclass的说明！（注：javadoc里面引用到其他类的地方是链接，可以直接点过去的）
--------------------------------------------------------------------------------
这个说得很有道理啊，认同。

[ 本帖最后由 jhbmail 于 2006-6-15 10:04 编辑 ]

jkit

原帖由 flw 于 2006-6-15 09:53 发表

到底应该是那种情况你去看文档不就知道了？

每个模块都有自己的文档，
而标准模块的文档更是随处可见，
你不看文档，当然不知道了！

我说的是方不方便的问题，不是知不知道的问题。

原帖由 flw 于 2006-6-15 09:58 发表

晕～
难道你不知道，chm 其实就是打包过的 html？
晕～
如果你高兴，你还可以把它变成 PDF 格式的，
是什么格式并不重要，
HTML 格式的 Python 文档也不是没有，这里就有：
[url]http://www.python.org/d ...

我的意思是说打包过的chm要比html用起来方便。html版的javadoc就已经够方便了，而pydoc要打包成chm才能凑合用，我啥时候说没有html版的pydoc了？你觉得html版的pydoc够方便吗？反正我是觉得巨不方便。

jkit

原帖由 jhbmail 于 2006-6-15 09:59 发表
1：离题，我们在谈文档，你在说IDE

------------------------------------------------------------
这个我不太认同哦，如果用IDE的时候自动就提示出来了，就没必要到文档里找了吧？我们的目的都是获得信息， ...

看来你习惯于一面敲代码一面思考了。而我习惯于先构思好了再动手写代码。

flw

原帖由 jkit 于 2006-6-15 10:20 发表


我说的是方不方便的问题，不是知不知道的问题。
我的意思是说打包过的chm要比html用起来方便。html版的javadoc就已经够方便了，而pydoc要打包成chm才能凑合用，我啥时候说没有html版的pydoc了？你觉 ...

你觉得不方便，
那是因为你是初学，
我初学 java 的时候还觉得 java 不方便呢。
对你来说，你对 java 了解的多，对 python 了解的少，
那你当然觉得 python 不方便了。

凡事都得有个过程，绝不能一蹴而就。
慢慢来，先浏览一下文档，日后查起来就不觉得不方便了。

BTW：java 是商业产品，python 是免费产品，如果你觉得 python 的文档不方便，
那你大可以发誓好好学 python，然后等融会贯通了写一套你心目中认为方便的文档来，
只不过，恐怕你也不会这么做吧？

农村有句话：白吃的枣儿还嫌核大，这话不是在教训你，
而是说，Java 有那么雄厚的资金做支持，假如连个文档都写得不如 python 好的话，那 Sun 的那帮工程师还不如去吃屎。