#13819: arrow2d path keyword is confusing
---------------------------+------------------------------------------------
Reporter: kcrisman | Owner: jason, was
Type: enhancement | Status: new
Priority: minor | Milestone: sage-5.6
Component: graphics | Keywords:
Work issues: | Report Upstream: N/A
Reviewers: | Authors:
Merged in: | Dependencies:
Stopgaps: |
---------------------------+------------------------------------------------
Basically, there is no true documentation for this, so that it's not
obvious that
{{{
sage: arrow2d(path=[[(1,1),(2,3),(3,3)]])
}}}
is the correct syntax (note the double brackets) and it's not at all clear
that the head and tail point are ignored. Is that even what we want? I
find it annoying to send people to `bezier_path` for more details when
there is not a hyperlink (though that's easily fixed) and (worse) it would
make more sense to have
{{{
sage: arrow2d((1,1),(3,3),path=[(2,3)])
}}}
as a syntax. (Maybe `bezier_path` itself should allow a single list of
tuples as a shorthand when there is just one path...)
Anyway, there are a number of ways to solve the problem of confusion, such
as better documentation, but I figure whoever works on this should think
of what our real goal is here, too.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/13819>
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.
