#11081: Update the "Install from Source Code" section of the Sage Installation
Guide
-----------------------------------+----------------------------------------
Reporter: drkirkby | Owner: mvngu
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-4.7
Component: documentation | Keywords:
Author: David Kirkby | Upstream: N/A
Reviewer: Karl-Dieter Crisman | Merged:
Work_issues: |
-----------------------------------+----------------------------------------
Changes (by drkirkby):
* status: needs_work => needs_review
Comment:
I'm attaching a patch which makes the following changes - again roughly
listed in the order they are mentioned in the document.
* Provide some hyperlinks to external sites such as Wikipedia where I
felt it might be appropriate.
* Provided a list of the supported platforms (Linux, OS X, Solaris and
!OpenSolaris), but did not go into many details about these.
* Added a note that gfortran does not come with Xcode, but that Sage
includes an executable for a Fortran compiler on OS X.
* Stated Sage is not supported on Windows except via a virtual machine
and added a link to Wikipedia to explain what a virtual machine is.
* Increased the disk space needed from 2 to 2.5 GB. I think 2 GB is just
about enough now, but I doubt it will be for long. (In fact, a 64-bit on
Solaris is taking over 3 GB)
* Removed the comment that Xcode is a free download and stated there may
be a charge. (I see it costs $4.99, although I did not state the amount).
* Added minimum versions of GNU make and GNU tar. (I don't actually know
what are the minimum versions for this, but I know the versions shipped
with the first release of Solaris 10 in 2005 will build Sage, so I put
them as minimum versions)
* Removed comments about what uses Perl. (It now just states Perl is
needed, with no explanation of why, although the minimum version is
stated).
* Changed the wording of the startup time of Sage to read ''starting the
first time should take well under a minute, but can take several minutes
if the file system is slow or busy. Since Sage opens a lot of files, it is
preferable to install Sage on a fast file system if this is possible.'' (I
believe those are all indisputable facts)
* Added that one could install things like binutils if one has the right
privileges, and if not to ask the system administrator.
* Removed comments there must be a system-wide install of gfortran, and
changed it to be a system wide or a personal installation.
* Removed comment about Sage not building with gcc 4.3, as I can find
nothing to suggest this is the case now.
* Removed the suggestion to compile Sage as root, and suggest this is not
done. (Since the bug with PARI's galois data files has been resolved,
there seems no good reason to compile Sage as root.)
* State on Mac OS 10.4, 10.5, Solaris and !OpenSolaris one should set
SAGE64 to ''yes'' before running ''make''. (Also stated 64-bit Solaris
builds are unstable)
* Suggested that one runs
{{{
grep "An error occurred" spkg/logs/*
}}}
if a build error occurs, and to put the output of that on sage-support.
(Previously the documentation said to attach install.log, but its totally
impractical to attach a file the size of install.log to an email).
* Removed the ''Note from David Kirkby'' advising one not to build as
root.
* Added at the bottom of the page ''This page was last updated in April
2011''
I believe there are still improvements that could be made, but believe the
changes made are a good compromise between improving the accuracy and
spending too much time over minor details.
Dave
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/11081#comment:12>
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.
