> After I tried
> make book
> make book.pdf
> without success. But since _I_ know that to build html doc I need to
> switch to src/doc, I switched to src/doc and issued again make book,
Not only *you* know. It is even properly documented. ;-)

http://fricas.github.io/install.html#build-extra-documentation-book-and-website

But you are right, at some point, we should add a "book.pdf" target to the top-level Makefile.

> But I remember having read somewhere viewports will not be build (I
> use WSL2 so I never tried xvfb)
I am not sure, but I would bet that xvfb allows to build without X. So it should work under WSL2. Sorry, that is just a guess.

> I re-switched to src/doc, issued a 'make book.pdf' and, after
> temporarily installing tensor.sty with 'apt-get install
> texlive-science' I was able to obtain an up to date book. Good!
Cool! So that was on WSL2?

> So my notes would be maybe to add at the end of the./configure step,
> as it's usual, a displayed message related to:
>
> configure: HyperDoc graphics must be built separately.
> configure: WARNING: Aldor interface will not be built.
>
> and building viewports and eventually how to build book.pdf.
>
> Remember, I did this with a newbie spirit in mind.
The newbie spirit is good. We need more of this kind.

But since the generation is not important for people that are not familiar with building things (we provide it on github anyway), I think it is enough to have the build-instruction on the website (url above).

Ralf> After I tried
> make book
> make book.pdf
> without success. But since _I_ know that to build html doc I need to
> switch to src/doc, I switched to src/doc and issued again make book,
Not only *you* know. It is even properly documented. ;-)

http://fricas.github.io/install.html#build-extra-documentation-book-and-website

But you are right, at some point, we should add a "book.pdf" target to the top-level Makefile.

> But I remember having read somewhere viewports will not be build (I
> use WSL2 so I never tried xvfb)
I am not sure, but I would bet that xvfb allows to build without X. So it should work under WSL2. Sorry, that is just a guess.

> I re-switched to src/doc, issued a 'make book.pdf' and, after
> temporarily installing tensor.sty with 'apt-get install
> texlive-science' I was able to obtain an up to date book. Good!
Cool! So that was on WSL2?

> So my notes would be maybe to add at the end of the./configure step,
> as it's usual, a displayed message related to:
>
> configure: HyperDoc graphics must be built separately.
> configure: WARNING: Aldor interface will not be built.
>
> and building viewports and eventually how to build book.pdf.
>
> Remember, I did this with a newbie spirit in mind.
The newbie spirit is good. We need more of this kind.

But since the generation is not important for people that are not familiar with building things (we provide it on github anyway), I think it is enough to have the build-instruction on the website (url above).

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/965a2584-f2ef-4357-9871-fb37b46bee0d%40hemmecke.org.

Reply via email to