#15816: improve documentation for reviewers
---------------------------------------+------------------------
Reporter: rws | Owner:
Type: defect | Status: new
Priority: major | Milestone: sage-6.2
Component: documentation | Resolution:
Keywords: toolchain, beginner | Merged in:
Authors: | Reviewers:
Report Upstream: N/A | Work issues:
Branch: | Commit:
Dependencies: | Stopgaps:
---------------------------------------+------------------------
Changes (by rws):
* keywords: binary, make, toolchain => toolchain, beginner
Old description:
> on SuSE Linux, with 6.1.1-x86-lib64-fedora binary:
> {{{
> $ cd sage-6.1.1-x86_64-Linux
> $ make
> (builds manual)
> $ ./sage -dev checkout --ticket 15482
> ...
> $ make
> make
> /home/ralf/sage-6.1.1-x86_64-Linux/local/var/lib/sage/installed/mpc-1.0.2
> make[3]: Entering directory `/home/ralf/sage-6.1.1-x86_64-Linux/build'
> /home/ralf/sage-6.1.1-x86_64-Linux/build/pipestatus "sage-spkg
> ${SAGE_SPKG_OPTS} mpc-1.0.2 2>&1" "tee -a
> /home/ralf/sage-6.1.1-x86_64-Linux/logs/pkgs/mpc-1.0.2.log"
> Found local metadata for mpc-1.0.2
> /home/ralf/sage-6.1.1-x86_64-Linux/src/bin/sage-spkg: line 303: cd:
> /home/ralf/sage-6.1.1-x86_64-Linux/upstream: No such file or directory
> Attempting to download package mpc-1.0.2
> (builds mpc, ppl...)
> }}}
>
> How can I avoid this? It's supposed to be a complete binary...
> Alternatively, give more information in the docs on what the user has to
> expect with the binary distribution.
New description:
In order to notmake this error:
{{{
$ ./sage -dev checkout --ticket 15482
...
$ make
...
Attempting to download package mpc-1.0.2
(builds mpc, ppl...)
}}}
you should give more information in the docs on what commands a potential
reviewer will need, i.e. sage -b, tools to analyze coverage etc.
The place where to put it:
http://sagemath.org/doc/developer/walk_through.html#reviewing
--
Comment:
Adapted the ticket title/description and set beginner task. Sorry for the
noise.
--
Ticket URL: <http://trac.sagemath.org/ticket/15816#comment:6>
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 unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/groups/opt_out.
