[Debian-science-sagemath] singular4

[Jerome BENOIT]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512



On 13/10/16 13:09, Ximin Luo wrote:
> Jerome BENOIT:
>> Hi Again,
>> 
>> On 12/10/16 14:15, Tobias Hansen wrote:
>>> Hi Jerome,
>> 
>>> could you please be more specific what you are talking about? Is
>>> it about my commit to the packaging git to not compress
>>> singular.hlp? If yes, sorry about that, I thought it's such a
>>> minor change that it's easier that way.
>> 
>> It is fine, but the issue was elsewhere: the documentation for
>> Singular4 is absolutely not supported: being able to read a data
>> file is fine, reading a faulty one is not.
>> 
> 
> In terms of technical functionality, I've verified that the
> uncompressed singular.hlp can still be processed by SageMath 7.3 and
> the 3 failing tests in src/sage/interfaces/singular.py will now pass.
> [1]

good, singular 4 for Sage is new.


 Whether the help text is accurate or up-to-date is a different
> question,

This file is supposed to be generated from the source.
The documentation part is not well distributed right now, and more
important had to be fixed before.


 but I think we should still solve the compression issue
> even if the docs are crap.

I had no good reason to do so except misleading the audience.

Keep in mind that Singular for is in progress, as weel as it Debian package.
In particular, the documentation is not uptodate, and the test are not present.
My first object was to get a working Singular 4.

> 
> However, I just remembered a minor detail of Debian policy [2]:
> 
> "Packages must not require the existence of any files in
> /usr/share/doc/ in order to function [115]. Any files that are used
> or read by programs but are also useful as stand alone documentation
> should be installed elsewhere, such as under /usr/share/package/, and
> then included via symbolic links in /usr/share/doc/package."

Here I can follow the GAP packaging approach: put the doc within 
the main package as part of the library, and  add a link in the
Debian doc package.

> 
> I'm not sure the best way to solve this, so I'll leave it to you.
> Loosely speaking, SageMath does not "need" singular.hlp to function,
> so we *could* leave things as-is. Strictly speaking, the tests do
> "need" singular.hlp to pass (unless we disable them), however.

So, to step forward, the hlp will be furnished.

Right now, the issue is the readline6 -> 7 migration, what is more
important from my view.


> 
> (I didn't file a bug, because this commit was not released yet.)
> 
> X
> 
> [1]
> https://anonscm.debian.org/cgit/debian-science/packages/sagemath.git/commit/?id=0eed64f4d4720dfc7f93b55d6230b690cba9a9da
>
> 
[2] https://www.debian.org/doc/debian-policy/ch-docs.html#fr115
> 

- -- 
Jerome BENOIT, Ph.D. | jgmbenoit-at+rezozer*dot_net
http://www.rezozer.net/

- -- 
Jerome BENOIT | calculus+at-rezozer^dot*net
https://qa.debian.org/developer.php?login=calculus@rezozer.net
AE28 AE15 710D FF1D 87E5  A762 3F92 19A6 7F36 C68B
-----BEGIN PGP SIGNATURE-----

iQQcBAEBCgAGBQJX/4WLAAoJED+SGaZ/NsaL304f/ihXT6HuufUS2OZmUk8KY4Xz
3xXjcTdqAWXcPMlbz6MECSMqmp4JNn6OAvH/ALDwkcB/iWzBgcZ3SkK1DGVirBVq
ROcVdU+/U1tIuXTaghpcunBIcVvyPW/VymBgG8K0aqBRpzuTOBZEQlY8cJwOnfs2
k1IeyMiFe4+AruZH2ufN/eQXh0tkbERDWBo+2Tt2WnD5nh4mIPWOSJBFjAeeg1As
T5028mYjg0O6dHuRJg/Al0j1IaFNsWIe3zO5T+vBr0kOUNF034Ly4INFphCHZumV
hI+2uXakj757XWCXBbQMxqDXWWa4X1Mr26wgRqmsW3mAD5w6RB8OiLLZ9XsLjMmW
cdD1eQhq2J9rMsHP3xB+8pPDL7wCF9AYN1dVowdmduFDI8BAXgppGWSIVYWJ3m9a
5Zyc0nPCqYvdO57nScot0eGq1X2GifiZVvBr5jVi1xBHeccarKjdXyFMGdsB+G1J
F3JMwwRzCOTeQjsWGTiOTEM+oNWZ5YQGMP3ymQLwGxZXyYesH7bYQfXvF6irpREY
qgHMGV2YOGIk77FCItLUsLO+BS8nt93UAxo78J9bVyr714CvdxT8V5DqZrAtslz7
fFyKPhzMx9DZac9UpC5hwTYgBTYn2JahaCv7eeMrEcwhr/OdLANkKHYdFcF2xuGP
4D11orPul+7tpiFh4wxv9nvAoytQgVmW2MqlJH6jUqCVtKzUjVjRAEKuDHZVQXef
5R9PQfWHm1otGRZJsD6dDCCR7g6+ZHlrDCS8Hs98AVo3NJWQ2nH2F1HefJ6AdDg+
ZJM2NOcwh6jFGPp5qdCz3UDK0g4QjsT+36dGCzJh2Tb8vLiKT7w4gWnG6r2+m+FH
svzcQMxu+AUOBSdNWmVBu1W39bIh2it/sPZeIr5Y+K0IxzSXc7uDknHqASgFEZoC
7drvkXpdMhtGt5CkH2FZh2qX1tXj6/TfwDMDNzFtA1wKeJX25kK8t6NGPe+b3xyA
KuAaVtW5botw0IXU3UfN2xxu14be0wcxsT7/h+xau1W9x92OKqBELwmOmsjwwWcT
eVPsz0MeXhnKXaHCb1TG+rCtdtAtlOUWF8Uf8wgc2lbdvi/bGL9pHfpbzr8BwLiC
3cdh46qiSehJ5Fbkfd/2FinxhUKHfNlUY7pMjNlWXKiyiIo+5QS7898QlKgFfUEM
3cELY0B39YA7ROy9fOxl6cs2aRnkhZ9kz52I2tqwQI6GpmnoAPt0MbKJM8deZeUG
sUKTzcI3QlG4D3XuzUqMhzuQxzHtALULj3EKFftRtO2kXxz2x4poyTsVGI/IuEhC
xwyaI7Ne3tOJLIAYlqsNGBGLikQcDHRFGh4ZcslmlcEfbGoSq0Eg7YvrjEnXVPs=
=Nz/K
-----END PGP SIGNATURE-----