Twisted currently does a range of really vile monkey
patches to epydoc to make it work somewhat nicely with
Twisted's various needs. You can see the evil in
Twisted generates its API docs by running
"admin/epyrun" in a SVN checkout.
If nothing else, you might get some feature ideas from
what's been done here.