#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: |
-----------------------------+----------------------------------------------
Description changed by drkirkby:
Old description:
> #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
New description:
#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.
The commands to be typed at the Sage prompt are prefixed with:
{{{
sage:
}}}
but those to be typed at the shell command line are not prefixed with
anything, and could perhaps best be prefixed with:
{{{
$
}}}
Those that need root access should start with:
{{{
#
}}}
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#comment:1>
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.
