> I find the generic version of the function definitions less than > satisfactory. I'd guess it would be had to make Sphinx pickup the > more detailed info in these situations? I'd also guess the decorators > could maybe manipulate the docstring and inject some information based > on the arguments of the decorator? Either way, could the effect of > these decorators on the documentation be improved?
Yes, that is possible -- decorators already have to "steal" documentation from whatever they decorate. I think that we should require decorators to document their existence and effect. --tom -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org
