I agree that it would be nice if __*__ and _*_ showed up in the documentation. David
On Mon, Apr 9, 2012 at 14:00, Andrey Novoseltsev <novos...@gmail.com> wrote: > > > On Apr 9, 2:51 pm, "Nicolas M. Thiery" <nicolas.thi...@u-psud.fr> > wrote: > > On Mon, Apr 09, 2012 at 10:06:32AM -0700, Andrey Novoseltsev wrote: > > > I think "_included_private_doc_" attribute would be great. > > > > Of course, as Florent and David I'd much prefer the approach of > > including a private method if and only if it's referred to somewhere, > > but unless we have a volunteer to implement that, the attribute is fine. > > > > I am not very happy with the name of that attribute but don't have a > > really better suggestion so ... Maybe "_documented_private_methods_"? > > > > A potential issue/feature about that attribute: it will be inherited. > > > > While we are speaking about documentation for ``._*`` methods it, a > > related question. I consider Python's (``.__*__``) and Sage's > > (``._*_``) special methods as public, and would be very much in favor > > of including them by default in the Sphinx documentation. > > > > What do you think? > > > > YES!!! I remember implementing "contains" just because "__contains__" > does not show up in the documentation! > > > Cheers, > > Nicolas > > -- > > Nicolas M. Thi�ry "Isil" <nthi...@users.sf.net> > http://Nicolas.Thiery.name/ > > -- > 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 > -- 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