About
Shop
LaTeX
Free Software
Books
News
Contact
Blog
Recent news (2017-04-18): glossaries-extra v1.14 released.

Bug Tracker

ID 10
Status Closed (not a bug)
Category glossaries
Version 3.04
Interpreter N/A
Summary cross-referencing not as described

Report

Hi

Section 8 of the manual writes:

"Note that in this case, the entry with the see key will automatically be added to the glossary, but the cross-referenced entry won't."

Contrary to what the manual says, specifying a see key does not automatically add that entry (entry with the see key) to the glossaries as my MWE shows. Does it mean the other way round, as in the cross-referenced entry (the one specified within the see key) will show up even if it is not cited by commands such as \gls. In that case the wording of above is a bit confusing.

In my MWE, I got one of the entry (Empirical) to show up by using \glssee within the description key, but it fails to generate the text "see also".

I can manually write the cross-reference within the description key, but I am curious as to why the see key doesn't seem to do what the manual says.

Even by writing {\glssee[see also]{Empirical}{Blackbox}} and {\glssee[see also]{Mechanistic}{Whitebox}} *after* \makeglossaries, there is no "see also xxx" links within the glossary table for the entries of Empirical and Mechanistic.

How do I create a purely see also cross-reference, get "see also" text to show up, while supressing the page number of that entry? I.e. Empirical in glossary table should read: Empirical see also Blackbox and similarly for Mechanistic Mechanistic see also Whitebox

Thank you very much

MWE

\documentclass{article}

\usepackage[notree,shortcuts]{glossaries}

\newglossaryentry{Blackbox}
{
  name=Blackbox models,
  sort=blackbox,
  description={--- In system identification, the term \emph{blackbox} 
modelling refers to the process of modelling a system through 
non-parametric techniques, without knowledge of physical inner
workings of the system, resulting in an \emph{empirical} model}
}
\newglossaryentry{Whitebox}
{
  name=Whitebox models,
  sort=whitebox,
  description={--- In system identification, the term \emph{whitebox} 
modelling refers to the process of modelling a system through first 
principles, laws of physics and explicit assumed relationships 
between the input and output through prior knowledge of the system, 
resulting in a \emph{mechanistic} model}
}
\newglossaryentry{Mechanistic}
{
  name=Mechanistic models,
  sort=mechanistic,
  description={},
  see=[see also]{Whitebox},
  nonumberlist
}
\newglossaryentry{Empirical}
{
  name=Empirical models,
  sort=empirical,
  description={},
  see=[see also]{Blackbox},
  nonumberlist
}
\makeglossaries
\glssee[see also]{Empirical}{Blackbox}
\begin{document}
Something about \gls{Blackbox} and \gls{Whitebox}
\newpage
\printglossary[title={Glossaries}]
\end{document}

Evaluation

Edited 2013-04-21 19:26

I've clarified in the documentation that \makeglossaries must be used before cross-referenced entries are defined.

Edited 2012-12-31 21:09

The user guide is correct, but I will edit it to clarify that \makeglossaries must be used before entries can be added to the external glossary file. Example:

\documentclass{article}

\usepackage[nonumberlist,seeautonumberlist]{glossaries}

\makeglossaries % <- move before entry definitions

\newglossaryentry{Blackbox}
{
  name=Blackbox models,
  description={cut for brevity}
}
\newglossaryentry{Whitebox}
{
  name=Whitebox models,
  description={cut for brevity}
}
\newglossaryentry{Mechanistic}
{
  name=Mechanistic models,
  description={},
  see=[see also]{Whitebox},
}
\newglossaryentry{Empirical}
{
  name=Empirical models,
  description={},
  see=[see also]{Blackbox}
}

\begin{document}

\printglossary[title={Glossaries}]
\end{document}

This automatically adds "Mechanistic models" and "Empirical models" to the glossary.

You can use the "seeautonumberlist" package option together with "nonumberlist" to only show the number list for entries containing "see" or "see also" elements, but if that entry has been referenced in the text you will also get page numbers as well as the "see" or "see also" tag in the location list for that entry. This is because the glossary mechanism works in the same way as \index which suffers from the same drawback.

The alternative is to suppress the location list (with "nonumberlist") and use, e.g., "see also \gls{Blackbox}" in the description of "Empirical" and not use the "see" key (as in the first example in section 8 of the user guide).

Watch This Report

If you would like to be notified whenever updates are made to this report, please fill in your email address in the box below and click on "Notify Me of Changes". (Please ensure the address is valid.) Your details won't be passed on to third parties in line with this site's Privacy Policy.

Comments

If you would like to add a comment regarding this bug report, please fill in the form below, but don't use it for a different bug or feature request, even if it's related. Instead fill out a new bug report or feature request. (If you want to link it to this report, make a note of the ID number at the top of the page.)

Name (Optional)
Comment

You can use the following markup:

[pre]Displayed verbatim[/pre]
[tt]monospace font[/tt]
[url]web address[/url]

which will be converted to:

<pre>Displayed verbatim</pre>
<tt>monospace font</tt>
<a href="web address">
web address</a>

I'm sorry, some spammers have cracked the captcha and genuine comments were being hidden in the midst of spam, so I've replaced the captcha with this test: Please enter the ID number of this report in the confirm ID box below.

Confirm ID: (The number at the top of this page.)

Return to Search Results


The free software provided here (including my class files and packages on CTAN) are funded by my book sales. While I'm keen to remove bugs from my code, book production has to take priority over bug fixes, so please don't expect a rapid response.

Version numbers that end with "b" indicate a beta (prototype) release. Version numbers that end with "a" indicate an alpha (unstable) release.

© 2012 Dickimaw Books. "Dickimaw", "Dickimaw Books" and the Dickimaw parrot logo are trademarks. The Dickimaw parrot was painted by Magdalene Pritchett.

Terms of Use Privacy Policy Site Map FAQs