[maxima-sage] 12/12: Add justifications for this package to package descriptions and README.Debian.

[Tobias Hansen]

This is an automated email from the git hooks/post-receive script.

thansen pushed a commit to branch master
in repository maxima-sage.

commit 4ab0b50ed73c58f581b12352e87c9670c068c790
Author: Tobias Hansen <thansen at broeselmaschine.fc.up.pt>
Date:   Sun Nov 13 16:27:29 2016 +0000

    Add justifications for this package to package descriptions and README.Debian.
---
 debian/README.Debian | 20 ++++++++++++++++++++
 debian/control       | 18 ++++++++++++++++++
 2 files changed, 38 insertions(+)

diff --git a/debian/README.Debian b/debian/README.Debian
new file mode 100644
index 0000000..3d636cd
--- /dev/null
+++ b/debian/README.Debian
@@ -0,0 +1,20 @@
+There are several reasons why SageMath cannot use Debian's maxima package at the moment
+and this second package maxima-sage is needed:
+
+ 1. Version mismatch
+
+ SageMath 7.4 uses Maxima 5.35.1, while the maxima package in Debian is constantly updated to follow
+ new upstream versions. Currently the version of maxima in Debian is 5.38.1. It is not trivial
+ to update SageMath to a new Maxima version, as this ticket for the Maxima 5.38.1 update shows:
+
+ https://trac.sagemath.org/ticket/18920
+
+ 2. Lisp compiler
+
+ The maxima package in Debian uses only GCL as common lisp compiler, while SageMath uses ECL. SageMath
+ cannot use the GCL version, since the preferred interface to Maxima is via an ECL fasl library.
+ The possibility of adding an ECL version of Maxima to the maxima package was discussed in
+
+ https://bugs.debian.org/779804
+
+This maxima-sage package is coinstallable with the maxima packages in Debian.
diff --git a/debian/control b/debian/control
index 5a5bdb0..3334f1c 100644
--- a/debian/control
+++ b/debian/control
@@ -25,6 +25,12 @@ Description: Computer algebra system -- base system
  quite reliable, and has good garbage collection, and no memory leaks.
  It comes with hundreds of self tests.
  .
+ The maxima-sage packages are meant to be used together with SageMath.
+ They contain the version of Maxima that works together with the
+ SageMath version in Debian and use ECL instead of GCL as Lisp compiler.
+ To use Maxima by itself, the more complete and up-to-date maxima package
+ is recommended.
+ .
  This package contains the main executables and base system files.
 
 Package: maxima-sage-doc
@@ -43,6 +49,12 @@ Description: Computer algebra system -- documentation
  quite reliable, and has good garbage collection, and no memory leaks.
  It comes with hundreds of self tests.
  .
+ The maxima-sage packages are meant to be used together with SageMath.
+ They contain the version of Maxima that works together with the
+ SageMath version in Debian and use ECL instead of GCL as Lisp compiler.
+ To use Maxima by itself, the more complete and up-to-date maxima package
+ is recommended.
+ .
  This package contains most of the documentation.
 
 Package: maxima-sage-share
@@ -60,5 +72,11 @@ Description: Computer algebra system -- extra code
  quite reliable, and has good garbage collection, and no memory leaks.
  It comes with hundreds of self tests.
  .
+ The maxima-sage packages are meant to be used together with SageMath.
+ They contain the version of Maxima that works together with the
+ SageMath version in Debian and use ECL instead of GCL as Lisp compiler.
+ To use Maxima by itself, the more complete and up-to-date maxima package
+ is recommended.
+ .
  This package contains a set of contributed routines and add-on 
  packages.

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-science/packages/maxima-sage.git