Use ".. automethod:: _coerce_map_from_" to force docbuild of the underscore methods that should be in the reference manual. See, for example, sage.structure.parent.Parent.__init__
On Saturday, October 5, 2013 8:29:24 PM UTC+1, Simon King wrote: > > Hi! > > This post has two purposes, namely an ad and a question. > > (1) I'd like to make coercion experts aware of #14711, where we are > working on > fixing yet another memory leak of the coercion system. Without #14711, > > sage: for D in xrange(2,2**30): > ....: QuadraticField(-D); > ....: > > would quickly fill up the memory, since all the different quadratic > fields would stay in memory because of cached coercion maps. With > #14711, the caching is modified, so that the quadratic fields are > allowed to die. > > All doctests pass, and it would make sense to review it. Nils Bruin > seems to be at it already. > > (2) I have a question on how to reference a thematic tutorial in the > reference manual. > > We currently have three ways of establishing a coercion between parents > P and Q, which differ in whether a strong reference to P keeps Q alive > and whether a strong reference to Q keeps P alive. The three methods > would be used in different settings. Nils Bruin suggests to add a fourth > method, since he sees use cases for the new method. > > Obviously we would like that the four methods refer to one another. But > one method, namely "_coerce_map_from_()", is an underscore method and does > not appear in the reference manual. It would thus make sense that the > three > other methods refer to the thematic tutorial on categories and coercion, > which elaborates on _coerce_map_from_(). > > But how can I put a link from the reference manual to the thematic > tutorial? > > Best regards, > Simon > > > -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/groups/opt_out.
