On 06/12/2013 05:56 AM, Waldek Hebisch wrote:
> Ralf Hemmecke wrote:
>> In HyperDoc click
>>
>> Reference > Axiom Book > 2. Using Types and Modes > 2.7. Conversion
>>
>> Clicking now on the first word "Conversion" leads to a non-existing page.
>>
>> The source is "\spadglossSee{Conversion}{conversion}" in ug02.htex which
>> obviously points to the glossary.

> The problem is due to missing 'glosskey.text' and 'glossdef.text'
> files.  AFAICS we lost them during transition from wh-sandbox
> to FriCAS.  'glosskey.text' and 'glossdef.text' may be generated
> from 'src/share/algebra/gloss.text' by the 'buildGloss' function
> in 'src/interp/br-data.boot'.  However, currently 'buildGloss'
> is unused and 'src/share/algebra/gloss.text' looks like a
> generated file (but ATM I do not know how it was generated).
> Moreover, 'buildGloss' also creates 'gloss.ht', but it looks
> fishy because I see no other source of text contained in
> 'gloss.ht' and 'gloss.text'...

Except glossdef.text, these files are in fricas since the beginning.

https://github.com/hemmecke/fricas-svn/blob/master/src/hyper/pages/gloss.ht
(last modified in r1302)
https://github.com/hemmecke/fricas-svn/blob/master/src/share/algebra/gloss.text
(last modified in r22)
https://github.com/hemmecke/fricas-svn/blob/master/src/share/algebra/glosskey.text
(last modified in r22)

Furthermore, the search field at the very bottom of the
Reference->Glossary page doesn't seem to work. But looking at the code
in ht-root.boot (the only place where I've found the use of
glossdef.text) seems to indicate that the missing glossdef.text could be
the reason for the non-functioning search.

glossdef.text is at least on the original NAGcdrom, so could be taken
from there if needed.

However, it's interesting information that these files have been
generated. I don't find it important enough to resurrect the generation
of these files before the release, but I've made an entry into my TODO
list. Only if I can find a quick fix it can go into the release.

The interesting thing is this one:

https://github.com/hemmecke/fricas/blob/htexdoc/src/htex/ug22.htex#L35
% DO NOT EDIT THIS FILE. This was created by gloss.awk
% from gloss.ht.

Up to now I thought that the .htex files are the original sources. That
doesn't seem to be always the case. :-(

That brings me to the question of unused .htex files. Since originally I
also planned to generate the book, I included all of them from NAGcdrom.
In src/hyper/Makefile.in I have a variable

NON_HD_CHAPTERS = ${EXAMPLES_CHAPTER} 17 18 19 20 22

that is responsible for excluding these chapters from the hyperdoc
generation.

Since ug22 is anyway generated from gloss.ht and ug17-20 describe
categories/domains/packages/operations and thus can potentially also be
generated from the information in the algebra directory, I now tend not
to include them into my final patch for inclusion into FriCAS.

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 post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/fricas-devel?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to