#12817: The 'nargs' argument to function() is undocumented
---------------------------------+------------------------------------------
Reporter: mjo | Owner: mvngu
Type: defect | Status: new
Priority: major | Milestone: sage-5.0
Component: documentation | Resolution:
Keywords: | Work issues:
Report Upstream: N/A | Reviewers:
Authors: | Merged in:
Dependencies: | Stopgaps:
---------------------------------+------------------------------------------
Comment (by nbruin):
Note that `sage.calculus.var.var` and `sage.calculus.var.function` are
just convenience wrappers of `SR.var` and
`sage.symbolic.function_factory.function_factory` respectively. Both are
augmented to inject the name they define into the global namespace and are
therefore only suited for interactive use at sage's toplevel. In any more
elaborate program or in library code, you should use the original
functions.
The documentation of any of those can use improvement, but I'm not sure
you want to explain all options in all of their docstrings. Perhaps a good
cross reference can save some work.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12817#comment:1>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
