On 27.02.23 23:52, Waldek Hebisch wrote:
IMO right way is to always recurse to documentation subdirectory,
but configure hould pass info about X availability to documentation
Makefile. In documentation Makefile we can use conditionals to
enable only targets buildable without X. We already have logic
for pages depending on graphic (connection to X server). Such
logic should be more general.
Ok, that's what I wanted to hear and that is fine with me.
As far as I remember the html pages do not require X, but sphinx-doc,
however, building the book only works correctly, if I have the graphics.
For the book there would be two options.
1) do not allow to build the book if graphics cannot be generated
2) create a local version of the book without graphics
For simplicity, I am rather in favour of (1) since it is much easier to
just download book.pdf from github. I think, it is a waste of effort to
do (2).
Actually, I am not so clear with this X stuff. As far as I understand,
we need some X libraries to build the graphics subsystem and we need a
running X server to actually create the pictures.
In the unlikely case that someone has the libraries, but no running X
server, creating the book would also not work, right? Or would it by
using xvfb?
Anyhow, I think I set some variables in configure.ac and add the doc
directory unconditionally to the build, i.e. .help files. The book and
the html pages will only work by explicitly calling "cd src/doc; make
book.pdf" or "make doc" and fail gracefully if it is known from
configure time that they cannot be built.
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 [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/fricas-devel/a926da80-853c-d558-3e10-9f1101cfdcda%40hemmecke.org.
