I like it at the end, I think.  I also don't feel strongly, so if there's
even one person that disagrees, then I will rescind my suggestion.  Then
it's ready to merge!  :+1:


On Tue, Mar 11, 2014 at 1:46 PM, Jai Ram Rideout
<notifications@github.com>wrote:

> In doc/sphinxext/numpydoc/numpydoc/docscrape.py:
>
> > +                    doc_list = []
> > +                    for name in sorted(items):
> > +                         try:
> > +                            doc_item = pydoc.getdoc(getattr(self._cls, name))
> > +                            doc_list.append((name, '', splitlines_x(doc_item)))
> > +                         except AttributeError:
> > +                            pass # method doesn't exist
> > +                    self[field] = doc_list
> > +
> > +    @property
> > +    def methods(self):
> > +        if self._cls is None:
> > +            return []
> > +        return [name for name,func in inspect.getmembers(self._cls)
> > +                if ((not name.startswith('_') or
> > +                     '.. shownumpydoc' in pydoc.getdoc(func))
>
> I didn't really think it was necessary since this is just a sphinx
> comment, so it's ignored in the output. It doesn't really matter where it
> goes in order to successfully tag the method.
>
> If you want me to, I can update to enforce that it's the last thing in the
> docstring (besides trailing whitespace)- no strong feelings on this one
>
> --
> Reply to this email directly or view it on GitHub<https://github.com/biocore/bipy/pull/134/files#r10492143>
> .
>