#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:
-------------------------------------+-------------------------------------
Changes (by ncohen):

 * status:  needs_info => needs_work


Comment:

 > It's not impossible, it's just a needless complication.
 >
 > Analogy: you don't want `gcc` to keep track of dependencies, that's why
 you use `make`: usually, `make` runs `gcc` and not the other way around.
 Similarly, `make` should run `./sage -i` and not the other way around.

 My problem is not whether you should have a way to track dependencies and
 a way to not track them. My problem is that we have been using and
 advertising 'sage -i' for years. It appears in our doc, on some people's
 web page, and we can expect users to know how to run it (those who know
 how to open a console).

 We don't have one year deprecations policies to change the behaviour of
 some lost Sage function so that you can change 'sage -i' to 'make' without
 warning, especially when (see [comment:12]) we cannot expect all users to
 know what 'make' is, nor to know where 'SAGE_ROOT' is.

 As it seems that there is no technical problem in changing the user
 interface, I set this ticket back to `needs_work`.

 Nathann

--
Ticket URL: <http://trac.sagemath.org/ticket/18859#comment:26>
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.

Reply via email to