Hi Qian,
>> https://github.com/fricas/fricas/blob/master/src/doc/Makefile.in#L328
>>
>> It will be generated before the compilation process comes src/doc for
>> producing the documentation.
>
> But it looks like it is a directly copy of src/doc/ht/util.ht,
> not generated.
Oh yes, you are right. I had to look it up myself. I believe the point
was that util.ht is not only needed in src/doc, but elsewhere.
Maybe src/interp/htcheck.boot is this "elsewhere". And it seems to be
the place to teach hyperdoc about the macros. As far as I can say,
util.ht is for HyperDoc what is a .sty file for LaTeX.
In fact, I faintly remember that I wanted to move util.ht to some other
place, but kept it under src/doc because it will be installed along with
all the other .ht files. If I am not completely wrong then it is not
used at all during compilation in src/doc, but rather only during "make
install".
The reason why I believe this is that src/doc/Makefile.in just produces
book.pdf from the .htex files (and the generated images) and the .html
files (from the .rst files). There will be some .ht files produced from
the .htex files, but I cannot remember that I ever actively *use* .ht
files other than for copying them to the respective installation directory.
>> Instead of your change to the documentation I would like to have this
>> somehow a little more precise. Maybe like this:
>>
>> ===========
>> # The intro.htex and util.ht files are not directly relevant for image
>> # generation, however, util.ht is used during generation of interpsys.
>> ===========
>
> Does "intro.htex" still exist? If so, where?
Oh, good catch. "intro.tex" existed on the NAGcdrom. I do not remember
why I have left that in the comments, but the content of that file now
essentially lives in ug00.htex. There should be no reason to mention
ug00.htex. I think you can simply remove the reference to intro.htex.
I definitely did not mean tecintro.tex, because that never existed in
.htex format.
https://github.com/fricas/fricas/blob/master/src/doc/book.tex#L72
> When function "initroot" is called, it will take the value of
> environment variable "FRICAS" (if it exists) and assign to Lisp
> variable |$spadroot|.
Yes, OK. The idea was to get rid of the FRICAS variable in the internals
of FRICASsys and rather rely on spadroot, right? I actually never
understood why this would matter whether the internal variable is called
FRICAS or spadroot. Anyway, then your first patch
- fn := CONCAT($spadroot, '"/share/hypertex/pages/util.ht")
+ -- this is called once by bootsys to generate interpsys
+ fn := CONCAT(getEnv '"FRICAS", '"/share/hypertex/pages/util.ht")
looked like a bad thing, since it intruces FRICAS again.
The second patch
+ echo '(initroot)' >> makeint.lisp
looks better, but I do not dare to say anything about whether it solves
the problem in the right way.
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/c8bb5387-c0da-4640-b5b2-bb3bdbdffd00%40hemmecke.org.
