> To be managable, extended information should be outside of
> docstrings and docstings should be short.

Well, you know, we disagree in that position. We don't live any longer
in the 80the where storage was short and expensive.

Ideally I would like some informal description of what the function does
together with a clear specification of input/output conditions.
And to help newcomers also examples of how to apply the function would
be nice.

Whether the examples necessarily must live in the docstring is not too
important for me. What is important is a pointer to some tutorial that
demonstrates the use of that function.

Ralf

-- 
You received this message because you are subscribed to the Google Groups 
"FriCAS - computer algebra system" 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/fricas-devel.
For more options, visit https://groups.google.com/d/optout.

Reply via email to