#9448: make it clearer not to edit sources in site-packages
-----------------------------+----------------------------------------------
Reporter: wjp | Owner: mvngu
Type: defect | Status: new
Priority: major | Milestone: sage-5.0
Component: documentation | Keywords:
Author: | Upstream: N/A
Reviewer: | Merged:
Work_issues: |
-----------------------------+----------------------------------------------
Changes (by jdemeyer):
* cc: jhpalmieri (added)
* type: enhancement => defect
Old description:
> Suggested approaches during SD23 lightning talk:
>
> Add a big note in the developer guide around where the location of the
> cloned branch is mentioned
>
> Add an extra field in the source introspection pointing to the sage
> source file. (Suggested by John Cremona)
New description:
When doing factor?? (either from the command line or in the notebook), the
given file is in site-packages. It should give the file in devel instead.
Example: factor??
{{{
Type: function
Base Class: <type 'function'>
String Form: <function factor at 0x282d230>
Namespace: Interactive
File: /usr/local/src/sage-4.4.4/local/lib/python2.6/site-
packages/sage/rings/arith.py
Definition: factor(n, proof=None, int_=False, algorithm='pari',
verbose=0, **kwds)
}}}
Suggested approaches during SD23 lightning talk:
Add a big note in the developer guide around where the location of the
cloned branch is mentioned
Also: no source file is given for class methods, for example:
n = 60
n.factor??
{{{
Type: builtin_function_or_method
Base Class: <type 'builtin_function_or_method'>
String Form: <built-in method factor of sage.rings.integer.Integer
object at 0x428ed20>
Namespace: Interactive
Definition: n.factor(self, algorithm='pari', proof=True, limit=None)
Source:
def factor(self, algorithm='pari', proof=True, limit=None):
}}}
In the notebook interface, n.factor?? DOES work, and it even points to the
right file in the devel directory.
--
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/9448#comment:2>
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.