On Thursday, August 28, 2014 5:05:42 PM UTC-4, John Myles White wrote:
>
> As we're starting to get better ideas for a documentation system, two
> questions I have are how we do two things:
>
> (1) Handle documentation of generic functions and their specialized
> methods without requiring documentation of all specialized methods.
>
Note that my proposal includes this. If you have generic documentation
that applies to all methods, then you attach the documentation to the
Function object. If you have method-specific docs, you attach it to the
Method object.
(Note that I think it will be annoying to implement this functionality by
parsing comments.)
>
> (2) Handle documentation of functions that being generated by macros.
>
As above. Writing
doc ....docs.... getindex
will attach docs to the getindex Function, i.e. it is not method-specific.
