Hi Waldek,
On 1/8/24 01:15, Waldek Hebisch wrote:
I would like to do the following change to install.rst (and
consequently INSTALL). This is mostly change due to Ralf,
but I did small change to Aldor instructions. Now it is
enough to give '--enable-aldor' to make Aldor interface,
do I removed part about changing directores and 'make'
in the subdirectory.
I've added your changes to my patch and also corrected a little.
It would be ready to commit (patch attached).
I also did small change to performance comparison corresponding
to my latest measurements.
The "than" in line 73 looks a bit weird. Shouldn't it be "then"?
https://github.com/hemmecke/fricas/blob/update-doc-aldor-interface/src/doc/sphinx/source/install.rst?plain=1#L73
On 64-bit AMD64 on average SBCL is the fastest one (9 times faster than
CLISP), Clozure CL and GCL the second (about 3 times slower than SBCL),
than ECL (about 7 times slower than SBCL) and CLISP is the slowest
one. Note: very old versions of ECL were much (about 4 times) slower,
versions from about 7-10 years ago gave best performance and
newest ECL versions are progressively slower.
Ralf
--
You received this message because you are subscribed to the Google Groups "FriCAS -
computer algebra system" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to fricas-devel+unsubscr...@googlegroups.com.
To view this discussion on the web visit
https://groups.google.com/d/msgid/fricas-devel/ad46df9f-0e4a-444b-b0bf-9ac5d4c732b1%40hemmecke.org.
From 0702ea7c439371c0c4875bee07eb0cdcc611662b Mon Sep 17 00:00:00 2001
From: Ralf Hemmecke
Date: Sun, 10 Dec 2023 18:11:01 +0100
Subject: update documentation for building FriCAS Aldor interface
---
INSTALL | 89 +++
INSTALL.aldor | 55 ---
src/doc/sphinx/source/install.rst | 68 +--
3 files changed, 118 insertions(+), 94 deletions(-)
delete mode 100644 INSTALL.aldor
diff --git a/INSTALL b/INSTALL
index 027f8805..f8436bc5 100644
--- a/INSTALL
+++ b/INSTALL
@@ -68,10 +68,11 @@ CMU CL port should be considered experimental, it received only little
testing. Also CMU CL seem to have problems on some machines. By
default FriCAS tries to use SBCL, since it is fast and reliable. On
64-bit AMD64 on average SBCL is the fastest one (9 times faster than
-CLISP), Clozure CL the second (about 1.5 times slower than SBCL), than
-GCL and ECL (about 3 times slower than SBCL) and CLISP is the slowest
-one. Note: very old versions of ECL were much (about 4 times) slower, you
-should use reasonably new version if you care about speed.
+CLISP), Clozure CL and GCL the second (about 3 times slower than SBCL), than
+ECL (about 7 times slower than SBCL) and CLISP is the slowest
+one. Note: very old versions of ECL were much (about 4 times) slower,
+versions from about 7-10 years ago gave best performance and
+newest ECL versions are progressively slower.
Some computation work much faster on 64-bit machines, especially
when using SBCL.
@@ -168,17 +169,37 @@ SphinxDoc (optional)
The documentation is built via Sphinx.
sudo apt install python3 python3-pip
- pip3 install -U Sphinx==5.3.0
-
-**WARNING**: Currently, Sphinx 6 and higher will fail building the
-".html" pages.
+ pip3 install -U Sphinx
Aldor (optional)
-If you want to use Aldor to extend the FriCAS library, you must, of
-course, have Aldor installed, and add "--enable-aldor" to your
-configure options when you compile FriCAS.
+Aldor was originally invented to be the next generation compiler for
+Axiom (the system that FriCAS forked from). If you want to use
+Aldor to extend the FriCAS library, you must, of course, have Aldor_
+installed, and add "--enable-aldor" to your configure options when
+you compile FriCAS.
+
+The commands below download the Aldor git repository into
+"$ALDORDIR" and install it into "$ALDORINSTALLDIR". Adapt the
+directories to whatever you like.
+
+ ALDORDIR=$HOME/aldor
+ ALDORINSTALLDIR=$ALDORDIR/install
+ mkdir -p $ALDORDIR
+ cd $ALDORDIR
+ git clone https://github.com/aldorlang/aldor.git
+ mkdir $ALDORDIR/build
+ cd $ALDORDIR/build
+ $ALDORDIR/aldor/aldor/configure --prefix=$ALDORINSTALLDIR --disable-maintainer-mode
+ make -j8
+ make install
+
+Then make the aldor executable available in your "PATH" by adding
+the following lines to your ".bashrc".
+
+ ALDORINSTALLDIR=/absolute/path/to/aldor/install
+ export PATH=$ALDORINSTALLDIR/bin:$PATH
Extra libraries needed by ECL
@@ -480,15 +501,25 @@ You can not only extend the FriCAS library by ".spad" files (SPAD
programs), but also by ".as" files (Aldor programs). For the latter
to work FriCAS needs a library "libfricas.al".
-This library can be build as follows.
-(An Aldor compiler is of course a prerequisite.)
+Note that building the interface temporarily needs about 2 GB extra
+disk space. Since currently,
