On Sat, Apr 24, 2021 at 10:58:35PM +0200, Ralf Hemmecke wrote:
> > http://math.uni.wroc.pl/~hebisch/fricas/install.rst
> 
> ====================
> 0. Change to a directory with enough (0.8 GB) free space
> ====================
> 
> I have not checked, but the 0.8GB seem to include the whole build, right?

Yes.

> ====================
> 1. Fetch sources
>    ::
> 
>       git clone --depth 1 https://github.com/fricas/fricas
>       cd fricas
        ^^^^^^^^^ 
That is not needed/wanted

> 
>    Remove the ``--depth 1`` option for access to the change history.
> ====================
> 
> Is the ``--depth 1 really important to you? When I clone with depth 1
> the size is
> 
>       5.877.760 ./.git
>      31.539.200 .
> 
> without --depth the disk size is
> 
>      20.582.400 ./.git
>      46.243.840 .
> 
> compared to what is generated later. The whole history is less than all
> checked out files. Those 15 MB are negligible (also compared to the size
> of the build).

That is 5M to fetch versus 20M.  It is likely that webby kids will
not notice, but difference is substantial for people with slower
links.

> ====================
> 2. Create build directory and change to it
>    ::
> 
>        mkdir ax-build
>        cd ax-build
> =====================
> 
> Do you want people to do the build inside a subdirectory of the
> git-repository?

Parallel, see correction above.  I do not know how many Mac OS
or Windows user will build git version, but for them in tree
build will fail.  Even if in tree build works, parallel
directory is cleaner.

> Why do you call it "ax-..." and not "fricas-build"?

Well, that is what I use.  I prefer short names, this one is
not very important except for distingushing between various
build directories (that is why "build" would be bad name).

> I am more in favour of giving a concrete directory here something like
> 
> /PATH/TO/FRICAS
> 
> and
> 
> /PATH/TO/FRICAS-BUILD
> 
> (possibly putting it into variables F and B,
> because calling "./configure" would not work inside "ax-build",
> "$F/configure" would.
> 
> Anyway, I have changed ax-build t fricas-build.
> 
> Since I do not have "." in my PATH, also calling "configure" will not
> work even in in-tree-builds.

Right, the configure line should be:

    ../fricas/configure --with-lisp=/path/to/your/lisp --prefix=/tmp/usr

And the same for '--help'

> I've added your modifications (with slight changes)
> 
> https://github.com/hemmecke/fricas/blob/wip/rstdoc/src/doc/sphinx/source/install.rst
> 
> Rendered version is here:
> 
> https://hemmecke.github.io/fricas/install.html

In lynx names have "P:" added, like:

Installation GuideP:

AFAICS this is due to the following in generated html.

<a class="headerlink" href="#installation-guide" title="Permalink to this 
headline">P:</a>

More generally, generated html has a lot of Javascript junk.  Is this
someting you added to configuration or general Github junk?

BTW: In current days Javascript is security problem and it would
be good if our pages worked without Javascript.

-- 
                              Waldek Hebisch

-- 
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 [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/fricas-devel/20210425092329.GA24610%40math.uni.wroc.pl.

Reply via email to