[Debian-science-sagemath] Final touches

[François Bissey]

If I remember correctly formatting of the documentation/help on the command line
depends on sphinx.

> On 19/02/2019, at 22:44, Tobias Hansen <thansen at debian.org> wrote:
> 
> On 2/19/19 10:36 AM, Ximin Luo wrote:
>> Jeroen Demeyer:
>>> On 2019-02-19 10:16, Tobias Hansen wrote:
>>>> Do we need runtime dependencies on cython and sphinx?
>>> That depends on what you want. If you want all doctests to pass, then yes: doctests do depend on Cython and Sphinx.
>>> 
>> We are able to express 3 levels of runtime dependencies in Debian - Depends, Recommends and Suggests. There are no hard rules on what goes where but there is a general convention that Depends is for vital things, Recommends is for "standard" user-level things, and Suggests are totally optional. I would suggest for sagemath:
>> 
>> 1. Depends is for all mathematical functionality.
>> 2. Recommends is for extra user-oriented stuff like commands to pretty-print docs.
>> 3. Suggests could be for power-user or dev-oriented stuff like additional tools needed to run `sage -t`.
>> 
>> All of these would need to be added to the "Build-Depends" for the sagemath source package since we run the tests during the build.
>> 
>> However if cython/sphinx aren't needed for (1) or (2) then we can avoid having the sagemath binary package depend on them, saving users some disk space.
>> 
>> X
>> 
> I think when installing all Recommends, the doctests should pass (as during build). So I'd put cython/sphinx in Recommends. I find Suggests a bit useless because it's not installed by default and I don't think that many people look at this to get ideas what else to install.
> 
> Best,
> 
> Tobias
> 
> 
> _______________________________________________
> Debian-science-sagemath mailing list
> Debian-science-sagemath at alioth-lists.debian.net
> https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/debian-science-sagemath