#11237: Improve the clarity of the "Install from Source Code" section of the 
"Sage
Installation Guide"
-----------------------------+----------------------------------------------
   Reporter:  drkirkby       |       Owner:  mvngu     
       Type:  enhancement    |      Status:  new       
   Priority:  major          |   Milestone:  sage-4.7.1
  Component:  documentation  |    Keywords:            
     Author:                 |    Upstream:  N/A       
   Reviewer:                 |      Merged:            
Work_issues:                 |  
-----------------------------+----------------------------------------------
 #11159 corrected a large number of errors in the section on installing
 Sage from source code. It possibly introduced the odd error too, though I
 think #11159 was a significant improvement. (I might be a little biased in
 that opinion, as I wrote most of it!)

 However, in my own opinion, the whole section could be written a bit more
 clearly. One obvious step is to separate the sections about building Sage
 on different platforms, as the mix of information on OS X, Linux and
 Solaris is a bit confusing. I would suggest different sections for:

  * Linux
  * OS X
  * Solaris/!OpenSolaris
  * Cygwin (unsupported, but some hints for those trying)
  * AIX (unsupported, but some hints for those trying)
  * HP-UX (unsupported, but some hints for those trying)

 The last two would be very short, but would help someone trying on those
 platforms.

 Also, the preferred commands for installing necessary software on the a
 number of different Linux distributions. I think we should cover the
 common ones in a bit more detail.

 Any comments on any of these points, or generally how to improve the
 ''Install from Source Code'' section of the ''Sage Installation Guide''
 would be useful.


 Dave

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