#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.

Reply via email to