[IronPython] Docstrings on stuff in clr module
fuzzyman at voidspace.org.uk
Thu Apr 30 18:52:02 CEST 2009
Dino Viehland wrote:
> There’s the format the compiler generates w/ the /doc: option – I’m
> not sure how standardized it is but it’s at least consistent J When
> you install the .NET framework SDK you get XML doc files for all of
> the .NET framework installed into
> %WINDIR%\Microsoft.NET\Framework\v2.0.50727\en\... (or some other
> language instead of en).
> We already support reading and producing __doc__ from these XML files
> (using .NET’s xml reading support and just looking for the values we
> know we need to pull out) it’s just that we do something different for
> IronPython’s own doc strings.
Yes - and those docstrings on the .NET types are *very* useful. :-) (So
thanks for the integration.)
I now get them in the Wing IDE source assistant when I am working with
> *From:* users-bounces at lists.ironpython.com
> [mailto:users-bounces at lists.ironpython.com] *On Behalf Of *Jonathan March
> *Sent:* Thursday, April 30, 2009 9:20 AM
> *To:* Discussion of IronPython
> *Subject:* Re: [IronPython] Docstrings on stuff in clr module
> Is there a standardized protocol for XML docstrings?
> Then what software would you use to process them?
> On Thu, Apr 30, 2009 at 10:54 AM, Dino Viehland <dinov at microsoft.com
> <mailto:dinov at microsoft.com>> wrote:
> Yes - I've opened a bug (22235 -
> I want to generally improve the doc strings everywhere. I've slowly
> been pushing on this and my ultimate goal is to get all of the doc
> strings moved into XML comments and then we can read them from there.
> Then we just need to go through a big push and add XML doc comments
> everywhere :)
> If other people have APIs they want doc strings on please add them
> to the comments. But I can see clr being particularly problematic
> as it otherwise lacks documentation.
> Users mailing list
> Users at lists.ironpython.com
More information about the Ironpython-users