On Fri, Sep 9, 2022 at 4:43 PM davida...@gmail.com
<davidayott...@gmail.com> wrote:
>
> I believe that the functionalities given by the method _element_constructor_ 
> should be at least mentioned in the main docstring of the Parent.
>
> For example, when typing:
>
>         sage: QQ?
>
> Then, the ouput explains to the user how to construct a rational number. This 
> is how I always used Sage. The documentation of _element_constructor_ would 
> be there for the developers that need to understand and modify it.

Well, _things are internal, and not required to be documented.

>
> Le vendredi 9 septembre 2022 à 05:16:27 UTC-4, axio...@yahoo.de a écrit :
>>
>> Dear all,
>>
>> as a user, how am I supposed to access the docstring of an 
>> _element_constructor_?
>>
>> For example,
>>
>> sage: P.<x> = QQ[]
>> sage: P?
>>
>> does not give me any hint about the various ways to construct a polynomial.
>>
>> If this is not possible other than "R._element_constructor_?", then, as 
>> developers, how should we make this documentation accessible?
>>
>> Martin
>
> --
> 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 sage-devel+unsubscr...@googlegroups.com.
> To view this discussion on the web visit 
> https://groups.google.com/d/msgid/sage-devel/ecf3daf3-0050-4255-84cc-472881a37e0en%40googlegroups.com.

-- 
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 sage-devel+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sage-devel/CAAWYfq19hRHeVNVYfgSchQ3DY2PRnQP427ykHoo2H0tuPvrCiQ%40mail.gmail.com.

Reply via email to