#18859: Update docs to use "make pkgname" instead of "./sage -i pkgname"
-------------------------------------+-------------------------------------
Reporter: jdemeyer | Owner:
Type: enhancement | Status: needs_work
Priority: major | Milestone: sage-6.9
Component: documentation | Resolution:
Keywords: | Merged in:
Authors: Jeroen Demeyer | Reviewers: Ralf Stephan
Report Upstream: N/A | Work issues: ???
Branch: | Commit:
u/jdemeyer/update_docs_to_use__make_pkgname__instead_of____sage__i_pkgname_|
626113afdc2a3023f2ce1e83fa8d0123cbae442f
Dependencies: | Stopgaps:
-------------------------------------+-------------------------------------
Comment (by jhpalmieri):
I don't quite find backwards compatibility a compelling enough reason to
keep the old behavior of `sage -i ...`: I find it likely that more users
are currently misinstalling packages by not installing dependencies vs.
ones who might want to force-install without a dependency-check in the
future. The latter are more likely to know what they're doing and thus
will be able to adapt to a change.
Given the amount of debate on this ticket, maybe we should have a
discussion on sage-devel: how should we document installing packages?
- `make pkg`
- `sage -i pkg` (backwards-incompatible, with a new option `sage -i --no-
deps pkg`)
- `sage -m pkg` and/or `sage --make pkg`
(Or was there a discussion that I missed?) I have a slight, not strong,
preference, for the second one. An advantage of 1 and 3 is that they keep
the current behavior of `sage -i`. An advantage of 2 and 3 is that they
can be run from anywhere, not just SAGE_ROOT.
As far as this ticket actually goes, if we want to recommend `make pkg`,
then you should also change the `sage` command so that `-i` is not listed
as a basic option. Same with `src/doc/en/reference/repl/options.rst`.
--
Ticket URL: <http://trac.sagemath.org/ticket/18859#comment:36>
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/d/optout.
