[SciPy-dev] maxentropy docs / parent class methods
Tue Feb 16 16:05:44 CST 2010
On Tue, Feb 16, 2010 at 4:41 PM, <firstname.lastname@example.org> wrote:
> On Tue, Feb 16, 2010 at 4:10 PM, Skipper Seabold <email@example.com> wrote:
>> The docs on the methods for the maxentropy model class that are
>> inherited from basemodel are not picked up by sphinx. It seems that
>> most of the .rst files explicitly list the methods, but since
>> basemodel is not intended to be public (and some subclasses overwrite
>> the parent class methods), is there a better way than to start listing
>> the basemodel methods?
>> I started to make the changes, but I don't think this is the right way
>> forward. Other thoughts?
> Try to reference directly the basemodel.xxx method in the autoclass for model
> .. autoclass:: model
> .. autosummary::
> :toctree: generated/
> Otherwise, it's better to have too much than too little information in the docs
That works, but it's still the basemodel namespace under model. I was
looking to statsmodels to see how we autogenerate the inherited
methods. I might play around with a local build so I don't clutter up
the logs on the wiki. It's changed so that they show up for now while
I clean up a little more but is probably not a final solution.
More information about the SciPy-Dev