<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta content="text/html; charset=windows-1252"
http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
On 09/06/2010 23:43, Danny Fernandez wrote:
<blockquote
cite="mid:AANLkTimh-wAa1ln1EUCnBwgcORuiDP9k6k6rd1wIwp63@mail.gmail.com"
type="cite">
<div>Hi Michael,<br>
<br>
Are there any documentation tools that would work with IronPython that
you would recommend? </div>
</blockquote>
<br>
Hmmm... in terms of automatically generating api documentation from
docstrings there are embarrassingly few for Python - let alone
IronPython. Sphinx is great for building documentation but doesn't need
to be run *with* IronPython and won't pull docstrings from your API for
you.<br>
<br>
Maybe other people have suggestions.<br>
<br>
All the best,<br>
<br>
Michael<br>
<br>
<blockquote
cite="mid:AANLkTimh-wAa1ln1EUCnBwgcORuiDP9k6k6rd1wIwp63@mail.gmail.com"
type="cite">
<div>I got pydoc to work on a small sample python file but the html
documentation included imports. I had small<br>
python file but the clr module took most of the html documentation. I
am newbie so I could be setting pydoc<br>
incorrectly.<br>
</div>
<div>Thanks.</div>
<div><br>
Danny</div>
<div><br>
<br>
</div>
<div class="gmail_quote">On Wed, Jun 9, 2010 at 10:56 AM, Michael
Foord <span dir="ltr"><<a moz-do-not-send="true"
href="mailto:fuzzyman@voidspace.org.uk">fuzzyman@voidspace.org.uk</a>></span>
wrote:<br>
<blockquote class="gmail_quote"
style="border-left: 1px solid rgb(204, 204, 204); margin: 0px 0px 0px 0.8ex; padding-left: 1ex;">
<div text="#000000" bgcolor="#ffffff">
<div>
<div class="h5">On 09/06/2010 16:55, Danny Fernandez wrote:
<blockquote type="cite">
<div>Hi All,<br>
<br>
I am a newbie in IronPython world which by the way rocks. I tried
posting yesterday so I am not sure what happened so sorry if there is a
double post. </div>
<div> </div>
<div>I am having trouble trying to use epydoc. I have IronPython
2.6.1 for .NET 2.0 on my 32-bit Windows XP box. I am not sure if I have
set it up correctly it is probably me not setting up things correctly.<br>
<br>
I installed the epydoc source in c:\python\epydoc and set IRONPATHHOME
is set to C:\python\epydoc\. I am following an example of using epydoc
from their website and added the debug arg to get more information so I
cd in C:\python\epydoc\scripts and executed the following<br>
<br>
ipy epydoc.py --html --debug sys -o sys_docs<br>
<br>
Traceback (most recent call last):-] Building documentation: sys<br>
File "epydoc.py", line 16, in <module><br>
File "C:\python\epydoc\epydoc\cli.py", line 965, in cli<br>
File "C:\python\epydoc\epydoc\docbuilder.py", line 454, in
_get_docs_from_pyname<br>
File "C:\python\epydoc\epydoc\docparser.py", line 209, in parse_docs<br>
File "C:\python\epydoc\epydoc\docintrospecter.py", line 131, in
introspect_docs<br>
File "C:\python\epydoc\epydoc\docintrospecter.py", line 275, in
introspect_module<br>
File "C:\python\epydoc\epydoc\docintrospecter.py", line 131, in
introspect_docs<br>
File "C:\python\epydoc\epydoc\docintrospecter.py", line 392, in
introspect_class<br>
TypeError: instancemethod.__cmp__(x,y) requires y to be a
'instancemethod', not a NoneType<br>
<br>
<br>
I tried find information on using IronPython with epydoc but with no
luck. I got pydoc to work but it pulled documentation for the clr
module which I use of course which took most of the documentation for
my module. I thought I can try epydoc with the parse only feature. I
appeciate any feedback. </div>
</blockquote>
<br>
<br>
</div>
</div>
Hmm... no idea on the specific problem - but this *may* be related:<br>
<br>
IronPython 2.6.1:<br>
<br>
>>> class X(object):<br>
... def f(s): pass<br>
...<br>
>>><br>
>>> a = X()<br>
>>> a.f.__cmp__
<div class="im"><br>
Traceback (most recent call last):<br>
</div>
File "<stdin>", line 1, in <module><br>
AttributeError: 'instancemethod' object has no attribute '__cmp__'<br>
<br>
CPython 2.6.5:<br>
<br>
>>> class X(object):<br>
... def f(s): pass<br>
...<br>
>>> a = X()<br>
>>> a.f.__cmp__<br>
<method-wrapper '__cmp__' of instancemethod object at 0x01858DA0><br>
<br>
<br>
Michael<br>
<blockquote type="cite">
<p>Thanks<br>
<br>
Danny</p>
<div class="im">
<pre><fieldset></fieldset>
_______________________________________________
Users mailing list
<a moz-do-not-send="true" href="mailto:Users@lists.ironpython.com"
target="_blank">Users@lists.ironpython.com</a>
<a moz-do-not-send="true"
href="http://lists.ironpython.com/listinfo.cgi/users-ironpython.com"
target="_blank">http://lists.ironpython.com/listinfo.cgi/users-ironpython.com</a>
</pre>
</div>
</blockquote>
<br>
<br>
<pre cols="72">--
<a moz-do-not-send="true" href="http://www.ironpythoninaction.com/"
target="_blank">http://www.ironpythoninaction.com/</a>
<a moz-do-not-send="true" href="http://www.voidspace.org.uk/blog"
target="_blank">http://www.voidspace.org.uk/blog</a>
READ CAREFULLY. By accepting and reading this email you agree, on behalf of your employer, to release me from all obligations and waivers arising from any and all NON-NEGOTIATED agreements, licenses, terms-of-service, shrinkwrap, clickwrap, browsewrap, confidentiality, non-disclosure, non-compete and acceptable use policies (”BOGUS AGREEMENTS”) that I have entered into with your employer, its partners, licensors, agents and assigns, in perpetuity, without prejudice to my ongoing rights and privileges. You further represent that you have the authority to release me from any BOGUS AGREEMENTS on behalf of your employer.
</pre>
</div>
</blockquote>
</div>
<br>
<pre wrap="">
<fieldset class="mimeAttachmentHeader"></fieldset>
_______________________________________________
Users mailing list
<a class="moz-txt-link-abbreviated" href="mailto:Users@lists.ironpython.com">Users@lists.ironpython.com</a>
<a class="moz-txt-link-freetext" href="http://lists.ironpython.com/listinfo.cgi/users-ironpython.com">http://lists.ironpython.com/listinfo.cgi/users-ironpython.com</a>
</pre>
</blockquote>
<br>
<br>
<pre class="moz-signature" cols="72">--
<a class="moz-txt-link-freetext" href="http://www.ironpythoninaction.com/">http://www.ironpythoninaction.com/</a>
<a class="moz-txt-link-freetext" href="http://www.voidspace.org.uk/blog">http://www.voidspace.org.uk/blog</a>
READ CAREFULLY. By accepting and reading this email you agree, on behalf of your employer, to release me from all obligations and waivers arising from any and all NON-NEGOTIATED agreements, licenses, terms-of-service, shrinkwrap, clickwrap, browsewrap, confidentiality, non-disclosure, non-compete and acceptable use policies (”BOGUS AGREEMENTS”) that I have entered into with your employer, its partners, licensors, agents and assigns, in perpetuity, without prejudice to my ongoing rights and privileges. You further represent that you have the authority to release me from any BOGUS AGREEMENTS on behalf of your employer.
</pre>
</body>
</html>