Bug Tracker

One or more errors has occurred:

Invalid search_category value

I’m currently working on a major new version of the datatool package. This may take a while. Please be patient. (Experimental version available for testing.)

ID	163🔗
Date:	2020-06-23 09:21:26
Status	Closed (Not a Bug)
Category	glossaries
Version	4.43
Summary	Inverted crossref (see and seealso) behavior

Description

It seems cross-references (i.e. "see" and "seealso" attributes of glossaryentries) are inverted (relative behavior of \gls) when building the glossary. Example: These glossary entries exist and are referencing each other in the following way:

text-body -> \gls -> item2
item2 -> "see" -> item1see
item2 -> "seealso" -> item1seealso
item2 -> \gls -> item1gls
item3see -> "see" -> item2
item3seealso -> "seealso" -> item2

Output in glossary:

item1gls
item2
item3see
item3seealso

Expected output in glossary:

item1gls
item1see
item1seealso
item2

See fuller description at [TeX.SX Link]

MWE

Download (932B)

\documentclass[a4paper]{article}

\usepackage[colorlinks]{hyperref}
\usepackage[automake]{glossaries-extra}

\makeglossaries{}

\newglossaryentry{item1see}
{
        name=item1see,
        description={Item 1 see}
}
\newglossaryentry{item1seealso}
{
        name=item1seealso,
        description={Item 1 seealso}
}
\newglossaryentry{item1gls}
{
        name=item1gls,
        description={Item 1 gls}
}
\newglossaryentry{item2}
{
        name=item2,
        description={Item2 2, not like \gls{item1gls} at all.},
        see={item1see},
        seealso={item1seealso}
}
\newglossaryentry{item3see}
{
        name=item3see,
        description={Item 3 see},
        see={item2}
}
\newglossaryentry{item3seealso}
{
        name=item3seealso,
        description={Item 3 seealso},
        seealso={item2}
}

\begin{document}
  I reference \gls{item2}, but none of the others directly in the text.

  \printglossaries

\end{document}

Evaluation

This is the documented behaviour of the see and seealso keys. The description of the see key in chapter 4 of the glossaries user manual starts as follows (emphasis in the original):

see Cross-reference another entry. Using the see key will automatically add this entry to the glossary, but will not automatically add the cross-referenced entry.

As mentioned in the glossaries manual, the see key essentially provides a convenient shortcut that performs

\glssee[tag]{label}{xr-label list}

after the entry has been defined. It's this command that performs the indexing.

If you want to avoid this automatic indexing, consider using bib2gls instead, which provides much better handling of these cross-references.

Comments

0 comments.

Add Comment

Name (optional):

Are you human? Please confirm the bug report ID (which can be found at the top of this page) or login if you have an account.

Confirm ID:

Comment:

You can use the following markup:

Block:

[pre]Displayed verbatim[/pre]
[quote]block quote[/quote]

In line:

[tt]code[/tt]
[file]file/package/class name[/file]
[em]emphasized text[/em]
[b]bold text[/b]
[url]web address[/url] [sup]superscript[/sup]
[sub]subscript[/sub]

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

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

You can use the Preview button to review your message formatting before submitting.

Page permalink: https://www.dickimaw-books.com/bugtracker.php?key=163