CTAN update: glossaries

CTAN Announcements ctan-ann at ctan.org
Fri Sep 24 19:43:22 CEST 2021

Nicola Talbot submitted an update to the



Version:  4.47 2021-09-20
License:  lppl1.3

Summary description:  Create glossaries and lists of acronyms

Announcement text:
 * added new files containing dummy entries for testing:

    -  example-glossaries-longchild.tex
    -  example-glossaries-childmultipar.tex

 * glossaries.sty:

    - Rollback to v4.46 is available, if necessary:


    - bug fix #173 https://www.dickimaw-books.com/bugtracker.php?key=173
      (.glsdefs not updated if entry definition modified)

      This bug fix has also led to support for the use of the 'see' key
      within the document environment.

      ** Delete your .glsdefs files on upgrading **

     Note that this update slightly changes the format of the .glsdefs file.
     If you have a system that parses this file (for example, to pick
     up labels for autocompletion) it will need to be modified.

     Old format:

 \gls at defglossaryentry{<label>}%
 <key value list>

     New format:

 \glsdefs at newdocentry{<label>}%
 <key value list>

    - bug fix #162 https://www.dickimaw-books.com/bugtracker.php?key=162
     (\newacronym without \setacronymstyle but with
      \glsnoexpandfields has incorrect plurals)

    - bug fix #166 https://www.dickimaw-books.com/bugtracker.php?key=166
      (\ also needs escaping with makeindex's quote character in the
      event that the sort value contains commands like \| or \! with

    - bug file #177 https://www.dickimaw-books.com/bugtracker.php?key=177
      (spurious \glolist@ at the end of glslabels file with writeglslabels option)

    - new package option 'writeglslabelnames'
      (as writeglslabels but also writes the name)

    - added warnings to deprecated acronym style package options
      'description', 'footnote', 'smaller', 'smallcaps', 'dua'
      and corresponding commands, such as \SetDescriptionFootnoteAcronymStyle.

      (These package options and commands were deprecated in v4.02 2013-12-05
      and have been labelled as deprecated in the manual since then.)
      The warnings can be suppressed with the 'nowarn' package option
      but it's better to use \setacronymstyle instead (or switch to
      glossaries-extra's abbreviations).

    - replaced some instances of \edef with \protected at edef when
      defining control sequences that store labels or lists of
      labels. Similarly for \xdef and \eappto. (Aiming towards
      support for UTF-8 characters in labels with PDFLaTeX, but
      may not be fully implemented so not yet documented.)

 * makeglossaries-lite:

    - added hybrid instructions if glossaries-extra record option detected but not

    - bug fix #183 https://www.dickimaw-books.com/bugtracker.php?key=183
      ("bad argument #1 to 'gsub'" when \makeglossaries missing)

    - Only add double-quotes if filename contains any spaces
      (should address issue #129)

 * makeglossaries:

    - added hybrid instructions if glossaries-extra record option detected but not

    - only add double-quotes to makeindex/xindy if space occurs in
      the pathname. (Issue #129 for makeglossaries-lite will probably
      also cause the same problem for makeglossaries since it relates
      to the behaviour of certain versions of cmd.exe in Windows.)

 * user manual:

   - some sections have been rearranged.


The package’s Catalogue entry can be viewed at

The package’s files themselves can be inspected at


   Thanks for the upload.

     For the CTAN Team
    Petra Rübe-Pugliese


CTAN is run entirely by volunteers and supported by TeX user groups.
Please join a user group or donate to one, see https://ctan.org/lugs

More information about the Ctan-ann mailing list