#12688: Improve documentation of span method
----------------------------------+-----------------------------------------
Reporter: rbeezer | Owner: jason, was
Type: enhancement | Status: needs_review
Priority: minor | Milestone: sage-5.0
Component: linear algebra | Resolution:
Keywords: rd2 | Work issues:
Report Upstream: N/A | Reviewers:
Authors: Rob Beezer | Merged in:
Dependencies: 12541 | Stopgaps:
----------------------------------+-----------------------------------------
Changes (by {'newvalue': u'Rob Beezer', 'oldvalue': ''}):
* keywords: => rd2
* status: new => needs_review
* dependencies: => 12541
* author: => Rob Beezer
Old description:
> I discovered this while working on #12541. Documentation says the
> `check` will "coerce entries of gens into base field." This does not
> appear to be happening, and should. (Edit: this is an integral span of
> rational vectors, a construction that is intended, so improving the
> documentation might be in order.)
>
> {{{
> sage: (QQ^2).span(gens=[vector(QQ, [1,1/2])], base_ring=ZZ, check=True)
> Free module of degree 2 and rank 1 over Integer Ring
> Echelon basis matrix:
> [ 1 1/2]
> }}}
New description:
I discovered this while working on #12541. Documentation says the `check`
will "coerce entries of gens into base field." This does not appear to be
happening, and should. (Edit: this is an integral span of rational
vectors, a construction that is intended, so improving the documentation
might be in order.)
{{{
sage: (QQ^2).span(gens=[vector(QQ, [1,1/2])], base_ring=ZZ, check=True)
Free module of degree 2 and rank 1 over Integer Ring
Echelon basis matrix:
[ 1 1/2]
}}}
'''Depends:''' #12541
'''Apply:'''
1. [attachment:trac_12688_span_documentation.patch]
--
Comment:
Patch is documentation only. More thorough, and more in keeping with
current documentation standards.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12688#comment:3>
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.
