Latest news 2019-12-05: new blog post "RSS Feeds and Other Notifications."

Bug Tracker

ID10
StatusClosed (Not a Bug)
Categoryglossaries
Version3.04
Summarycross-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).

Add comment.

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" button. (Please ensure the address is valid.) Your details won't be passed on to third parties in line with this site's Privacy Policy.

If you supply your name, it will be used in the email greeting, which provides a more personal message, otherwise you'll just get a generic greeting. If you have previously supplied your name when signing up for notifications, you don't need to resupply it unless you want to change it.

If you have previously subscribed to notifications for this report, you can unsubscribe by clicking on the "Stop Notification" button.

The "Confirm Bug ID" field helps to protect against spambots. Please enter the bug ID (which you can find at the top of this page).

(Optional.)
E mail:
Confirm E mail:
Confirm Bug ID:

To unsubscribe from all notifications use the notifications page.

Comment

You can append a comment to the report using the form below. Comments are checked first before being added. Any spam or offensive content will be removed first according to this site's Terms of Website Use. Please bear in mind that I develop and maintain free software in my spare time. If you want commerical level support then you can hire a TeX consultant.

The "Confirm Bug ID" field helps to protect against spambots. Please enter the bug ID (which you can find at the top of this page).

(Optional. If provided, it will be shown with the comment.)
Confirm Bug ID:

You can use the following markup:

[pre]Displayed verbatim[/pre]
[tt]monospace text[/tt]
[em]emphasized text[/em]
[b]bold text[/b]
[url]web address[/url]

Ordered list:
[ol]
[li]first item[/li]
[li]second item[/li]
[/ol]

Unordered list:
[ul]
[li]first item[/li]
[li]second item[/li]
[/ul]

Click on the Preview button to preview the message.

Return to list.

© 2019 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 Cookies Site Map FAQs