But I want the glossary to be better than that of the HyperSpec. I
often find myself looking at a glossary entry in the HyperSpec as a
result of having clicked on a link in an entry for some operator, but
then I am "stuck" on that glossary entry, because there is no link
from it to a section that explains the concept in detail.
As an example of what I am referring to, take for example a page such
as ADJUST-ARRAY. Observe that the argument named ELEMENT-TYPE is
specified to be a TYPE SPECIFIER and that TYPE SPECIFIER is a link.
Clicking on that link, one ends up in the glossary entry for TYPE
SPECIFIER as is appropriate. But it would be good to have a link from
the glossary entry that goes to section 4.2.3 that discusses in more
detail what a type specifier is.
In my latest experiment, I used the HYPERREF LaTeX package and turned
the word ATOM into a link to the SECTION that takes about atoms. What
I would really like to do is to introduce an indirection through the
glossary. In other words, I would like each glossary entry to have a
label, and I would like the link on ATOM to refer to that label. Then
I want the glossary entry to contain a link to the section on ATOMs,
with a text such as: "for more information on the type ATOM, see
section...".
I don't think I have ever created a glossary in a document like this,
so I need to figure it out, unless someone else has the time to do
so. It is important that each entry can be associated with a label so
that it can be linked to.
I think the reference manual needs a glossary.
But I want the glossary to be better than that of the HyperSpec. I often find myself looking at a glossary entry in the HyperSpec as a result of having clicked on a link in an entry for some operator, but then I am "stuck" on that glossary entry, because there is no link from it to a section that explains the concept in detail.
As an example of what I am referring to, take for example a page such as ADJUST-ARRAY. Observe that the argument named ELEMENT-TYPE is specified to be a TYPE SPECIFIER and that TYPE SPECIFIER is a link. Clicking on that link, one ends up in the glossary entry for TYPE SPECIFIER as is appropriate. But it would be good to have a link from the glossary entry that goes to section 4.2.3 that discusses in more detail what a type specifier is.
In my latest experiment, I used the HYPERREF LaTeX package and turned the word ATOM into a link to the SECTION that takes about atoms. What I would really like to do is to introduce an indirection through the glossary. In other words, I would like each glossary entry to have a label, and I would like the link on ATOM to refer to that label. Then I want the glossary entry to contain a link to the section on ATOMs, with a text such as: "for more information on the type ATOM, see section...".
I don't think I have ever created a glossary in a document like this, so I need to figure it out, unless someone else has the time to do so. It is important that each entry can be associated with a label so that it can be linked to.