references to builtins

[Glyph Lefkowitz]

There are lots of C{str} and C{int} littered all over @type and @param statements in Twisted. I'd really prefer these to be more properly expressed as L{str} and L{int}. Similarly, I'd like to express @raises statements with e.g. L{OSError}.

This doesn't need any fancy cross-reference stuff; I *would* like to be able to refer to arbitrary Python stdlib modules this way as well, but builtins and the standard exception hierarchy are important enough that I wouldn't mind if they all simply linked to a static 'python builtins' page included with the generated docs.

[Glyph Lefkowitz (glyph)]

You could link to http://docs.python.org/library/functions.html#str, http://docs.python.org/library/functions.html#list, etc. for these. See also https://bugs.launchpad.net/pydoctor/+bug/961797

[Michael Hudson-Doyle (mwhudson)]

http://python.net/~mwh/attr-doc/twisted.python.failure.Failure.html#check

and

http://python.net/~mwh/attr-doc/twisted.python.filepath.FilePath.html#setContent

contain examples of this now.

[Michael Hudson-Doyle (mwhudson)]

I cleaned up the code and pushed it to trunk.

[Glyph Lefkowitz (glyph)]

No you didn't. Trunk according to https://launchpad.net/pydoctor is https://code.launchpad.net/~mwhudson/pydoctor/dev and you haven't pushed there in months. Some piece of metadata needs to be updated here :).

[Glyph Lefkowitz (glyph)]

See https://bugs.launchpad.net/pydoctor/+bug/696633/comments/4

[Michael Hudson-Doyle (mwhudson)]

Oops. *Now* I've pushed to trunk.