#11081: Update the "Install from Source Code" section of the Sage Installation
Guide
-----------------------------------+----------------------------------------
   Reporter:  drkirkby             |       Owner:  mvngu     
       Type:  enhancement          |      Status:  needs_work
   Priority:  major                |   Milestone:  sage-4.7  
  Component:  documentation        |    Keywords:            
     Author:  David Kirkby         |    Upstream:  N/A       
   Reviewer:  Karl-Dieter Crisman  |      Merged:            
Work_issues:                       |  
-----------------------------------+----------------------------------------
Changes (by kcrisman):

  * status:  new => needs_work
  * reviewer:  => Karl-Dieter Crisman


Comment:

 A few comments for improvement:
  * I think it would be nice to have at least the main "fully supported"
 versions here.  No need to go clicking through if you are on a normal
 system, then, and also it will be clear that e.g. Windows 7 is not on that
 list just by looking at it.  Something like "supported on many Linux
 distributions, Mac OS X, and 32-bit Solaris; see ... for details and
 status of other systems." I'm not wedded to that phrasing, but it's
 reasonable to have at least minimal info.
  * A minor note should be added that gfortran is not provided by Xcode on
 OS X, but that Sage provides a suitable Fortran compiler for OS X.
  * Even for my ancient < 1 GHz Emac (probably from around 2003), it takes
 less than a minute for Sage to start up the first time (though it's
 close!).  I think it is more reasonable to say "starting the first time
 may take more than a few seconds; a few platforms will take longer for
 reason X" where it is clear that reason X is something about the platform,
 not Sage.
  * "**Note from David Kirkby.** " - is that going to look ok in the docs?
 Maybe instead using the ".. note:" syntax...

 All the updates etc. and changes for more accurate documentation look
 fine, though I'm sure more knowledgeable folks will have some minor
 changes there, since it's a rule that any patch longer than 1 character
 has a bug :-)

 Nice work cleaning this up, Dave.  We are very fortunate that Sage has
 enough people who care about this kind of thing that we do eventually
 clean them up!

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/11081#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.

Reply via email to