texlive[48439] Master/texmf-dist: bib2gls (19aug18)

commits+karl at tug.org commits+karl at tug.org
Sun Aug 19 23:26:24 CEST 2018


Revision: 48439
          http://tug.org/svn/texlive?view=revision&revision=48439
Author:   karl
Date:     2018-08-19 23:26:23 +0200 (Sun, 19 Aug 2018)
Log Message:
-----------
bib2gls (19aug18)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/support/bib2gls/CHANGES
    trunk/Master/texmf-dist/doc/support/bib2gls/bib2gls-begin.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/bib2gls.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-authors.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-bacteria.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-chemical.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-citations.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-constants.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-languages.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-maths.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-media.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-msymbols.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi1.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi2.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-people.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-units1.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-units2.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-units3.pdf
    trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-usergroups.pdf
    trunk/Master/texmf-dist/scripts/bib2gls/bib2gls.jar
    trunk/Master/texmf-dist/scripts/bib2gls/convertgls2bib.jar
    trunk/Master/texmf-dist/scripts/bib2gls/resources/bib2gls-en.xml
    trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls-begin.tex
    trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls-src.zip
    trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls.bib
    trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls.tex
    trunk/Master/texmf-dist/source/support/bib2gls/src/gls2bib-src.zip
    trunk/Master/texmf-dist/source/support/bib2gls/src/texparser-src.zip

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/CHANGES
===================================================================
--- trunk/Master/texmf-dist/doc/support/bib2gls/CHANGES	2018-08-19 21:25:49 UTC (rev 48438)
+++ trunk/Master/texmf-dist/doc/support/bib2gls/CHANGES	2018-08-19 21:26:23 UTC (rev 48439)
@@ -1,3 +1,8 @@
+v1.7 (2018-08-18):
+
+  * added support for multiple supplementary sources
+    (requires at least glossaries-extra v1.36)
+
 v1.6 (2018-07-07):
 
   * corrected some of the latin<n> to Java encoding names

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/bib2gls-begin.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/bib2gls.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-authors.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-bacteria.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-chemical.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-citations.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-constants.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-languages.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-maths.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-media.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-msymbols.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi1.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi2.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-people.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-units1.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-units2.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-units3.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/support/bib2gls/examples/sample-usergroups.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/scripts/bib2gls/bib2gls.jar
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/scripts/bib2gls/convertgls2bib.jar
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/scripts/bib2gls/resources/bib2gls-en.xml
===================================================================
--- trunk/Master/texmf-dist/scripts/bib2gls/resources/bib2gls-en.xml	2018-08-19 21:25:49 UTC (rev 48438)
+++ trunk/Master/texmf-dist/scripts/bib2gls/resources/bib2gls-en.xml	2018-08-19 21:26:23 UTC (rev 48439)
@@ -335,6 +335,7 @@
 Ignoring {1}</entry>
 <entry key="warning.option.pair.required">Resource option {0} requires option {1}</entry>
 <entry key="warning.group.option.required">Resource option {0} requires application switch {1}</entry>
+<entry key="warning.no_group_field">You have the --group switch on but the document hasn''t defined the ''group'' key. (Have you forgotten to use the ''record'' package option?)</entry>
 <entry key="warning.parent.missing">Parent {0} does not occur before entry {1} so removing relationship.</entry>
 <entry key="warning.unknown.field.pattern">Ignoring pattern for unknown field: {0}</entry>
 <entry key="warning.notbasiclatin.id">Problematic entry label: {0}
@@ -356,6 +357,7 @@
 <entry key="warning.unknown.widest">Can''t determine widest level {0} entry for unknown glossary type. Using fallback method.</entry>
 <entry key="warning.invalid.locale">Unrecognised locale: {0}. Using {1} instead.</entry>
 <entry key="warning.interpreter.needed.fallback">Interpreter needed to obtain fallback contents for field {0} (entry {1})</entry>
+<entry key="warning.multi_supp_unsupported">Multiple supplemental locations not supported with glossaries-extra {1}. Restricting selection to just {0}. Update to at least glossaries-extra version {2} to support multiple supplementary sources.</entry>
 
 <entry key="error.title">Error: {0}</entry>
 <entry key="error.alias.map.forbidden">The 'alias' field can't be mapped.</entry>
@@ -371,7 +373,7 @@
 Have you indexed your entries using commands like \gls?</entry>
 <entry key="error.missing.aux.new.cs">Missing \{0} in aux file (make sure glossaries-extra.sty is at least {1}).</entry>
 <entry key="error.only.one.aux">Only one aux file permitted.</entry>
-<entry key="error.no.aux">Missing aux file. Use --help for help.</entry>
+<entry key="error.no.aux">Aux file not supplied. Syntax: bib2gls [<options>] <aux file></entry>
 <entry key="error.file.not.found">File not found: {0}</entry>
 <entry key="error.missing.src">File not found: {0}
 (Did you forget to use the ''src'' key?)</entry>

Modified: trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls-begin.tex
===================================================================
--- trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls-begin.tex	2018-08-19 21:25:49 UTC (rev 48438)
+++ trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls-begin.tex	2018-08-19 21:26:23 UTC (rev 48439)
@@ -798,6 +798,25 @@
 (\sectionref{sec:abbreviations}) or changing the formatting
 (\sectionref{sec:glsformats}).
 
+You can test if an entry has been used with:
+\nosecformatdef{ifglsused}
+This requires that the entry (identified by \meta{label}) is
+defined. If it isn't then neither \meta{true} nor \meta{false} is
+done and an error or warning occurs. Otherwise, the command will do
+\meta{true} if the entry has been used or \meta{false} if the entry
+hasn't been used.
+
+When using \bibgls, entries are never defined on the first \LaTeX\
+run, so you may instead prefer:
+\nosecformatdef{GlsXtrIfUnusedOrUndefined}
+which does \meta{true} if either the entry hasn't been defined or
+hasn't been marked as used, otherwise it does \meta{false}.
+
+Neither \gls{ifglsused} nor \gls{GlsXtrIfUnusedOrUndefined} should
+occur in the \idx{postlinkhook} as the entry will have already
+been used by that point. Instead, you need \gls{glsxtrifwasfirstuse} 
+(see \sectionref{sec:postlinkhooks}).
+
 \section{Categories}
 \label{sec:categories}
 
@@ -2260,7 +2279,7 @@
 \cmd{usepackage}\marg{tracklang}
 \strut
 \cmd{begin}\marg{document}
-\gls{GetTrackedDialectFromLanguageTag}\marg{en-GB}\marg{\cmd{trackeddialect}}%
+\gls{GetTrackedDialectFromLanguageTag}\marg{en-GB}\marg{\cmd{trackeddialect}}\comment{}
 Tracked dialect label: \cmd{trackeddialect}.
 \gls{IfTrackedDialectHasMapping}\marg{\cmd{trackeddialect}}\comment{}
 \marg{Has mapping: \gls{GetTrackedDialectToMapping}\marg{\cmd{trackeddialect}}}\comment{}
@@ -2307,6 +2326,7 @@
 The above document produces:
 \begin{result}
 en-GB: Tracked dialect label: . No mapping. Root language: .
+
 en-MT: Tracked dialect label: maltaenglish. Has mapping: british.
 Root language: english.
 \end{result}
@@ -2323,7 +2343,7 @@
 \cmd{usepackage}\marg{tracklang}
 \strut
 \cmd{begin}\marg{document}
-\gls{GetTrackedDialectFromLanguageTag}\marg{de-DE-1996}\marg{\cmd{trackeddialect}}%
+\gls{GetTrackedDialectFromLanguageTag}\marg{de-DE-1996}\marg{\cmd{trackeddialect}}\comment{}
 Tracked dialect label: \cmd{trackeddialect}.
 \gls{IfTrackedDialectHasMapping}\marg{\cmd{trackeddialect}}\comment{}
 \marg{Has mapping: \gls{GetTrackedDialectToMapping}\marg{\cmd{trackeddialect}}}\comment{}
@@ -2396,7 +2416,7 @@
 \end{codeenv}
 This essentially uses the earlier \sty{tracklang} code where an
 extra \gls{ifdefempty} is inserted, which sets the equivalent of
-\csfmt{trackeddialect} to \gls{TrackedDialectClosestSubMatch}. If
+\csfmt{trackeddialect} in the above to \gls{TrackedDialectClosestSubMatch}. If
 the test for the captions hook is false, then \gls{foreignlanguage}
 isn't used.
 
@@ -5233,7 +5253,7 @@
 them out, as in \sectionref{sec:printglossagain}). The \field{group}
 field needs setting for every entry, and if the \field{location}
 field also needs setting then the \filefmt{entries.tex} file will
-need to be modified every time the document changes cause a shift in
+need to be modified every time new document edits cause a shift in
 the page numbers.
 
 With \bibgls, you write all the entry definitions (without the

Modified: trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls-src.zip
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls.bib
===================================================================
--- trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls.bib	2018-08-19 21:25:49 UTC (rev 48438)
+++ trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls.bib	2018-08-19 21:26:23 UTC (rev 48439)
@@ -446,6 +446,20 @@
   category={command}
 }
 
+ at dualindexentry{bibglssupplementalsublist,
+  name={\csfmt{bib\-gls\-supple\-mental\-sub\-list}},
+  user1={\margm{n}\margm{external document}\margm{list}},
+  description={supplemental sub-list encapsulator},
+  category={command}
+}
+
+ at dualindexentry{bibglssupplementalsubsep,
+  name={\csfmt{bib\-gls\-supple\-mental\-sub\-sep}},
+  user1={},
+  description={separator between supplementary sub-lists},
+  category={command}
+}
+
 @dualindexentry{glsgroupheading,
   name={\csfmt{gls\-group\-heading}},
   user1={\margm{label}},
@@ -2382,6 +2396,24 @@
   category={command}
 }
 
+ at dualindexentry{glsxtrdisplaysupploc,
+  name={\csfmt{gls\-xtr\-display\-supp\-loc}},
+  user1={\margm{prefix}\margm{counter}\margm{format}\margm{src}\margm{location}},
+  description={used to display an external location in the
+   supplementary list},
+  note={provided by \styfmt{glossaries-extra-bib2gls} v1.36+},
+  category={command}
+}
+
+ at dualindexentry{glsxtrmultisupplocation,
+  name={\csfmt{gls\-xtr\-multi\-supp\-location}},
+  user1={\margm{location}\margm{src}\margm{format}},
+  description={used by \gls{glsxtrdisplaysupploc} to format the
+  external location},
+  note={provided by \styfmt{glossaries-extra-bib2gls} v1.36+},
+  category={command}
+}
+
 @dualindexentry{glsxtr at record,
   name={\csfmt{glsxtr at record}},
   user1={\margm{label}\margm{prefix}\margm{counter}\margm{format}\margm{location}},
@@ -6481,6 +6513,31 @@
   category={command}
 }
 
+ at index{ifglsused,
+  name={\csfmt{if\-gls\-used}},
+  user1={\margm{label}\margm{true}\margm{false}},
+  description={does \meta{true} if the entry given by \meta{label} has been
+  used, \meta{false} if the entry hasn't been used and neither
+  if the entry doesn't exist (an error or warning message will
+  occur and ?? will appear in the document).
+  This command is not for use in the post-link hooks},
+  note={provided by \styfmt{glossaries}},
+  seealso={GlsXtrIfUnusedOrUndefined,glsxtrifwasfirstuse},
+  category={command}
+}
+
+ at index{GlsXtrIfUnusedOrUndefined,
+  name={\csfmt{Gls\-Xtr\-If\-Un\-used\-Or\-Un\-defined}},
+  user1={\margm{label}\margm{true}\margm{false}},
+  description={does \meta{true} if the entry given by \meta{label}
+hasn't been
+  used or is undefined, otherwise it does \meta{false}.
+  This command is not for use in the post-link hooks},
+  note={provided by \styfmt{glossaries-extra} v1.34+},
+  seealso={ifglsused,glsxtrifwasfirstuse},
+  category={command}
+}
+
 @index{glslabel,
   name={\csfmt{glslabel}},
   user1={},

Modified: trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls.tex
===================================================================
--- trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls.tex	2018-08-19 21:25:49 UTC (rev 48438)
+++ trunk/Master/texmf-dist/source/support/bib2gls/src/bib2gls.tex	2018-08-19 21:26:23 UTC (rev 48439)
@@ -2780,11 +2780,27 @@
 \section{Comments}
 \label{sec:bibcomments}
 
-You may have comments within the \ext{bib} file provided they are
-outside of entry definitions. The most common type of comment is the
-encoding comment, described above.
-Avoid using comments within field values.
+The original \ext{bib} file format as defined by \BibTeX\ doesn't
+have a designated comment character, but instead treats anything
+outside of \code{@\meta{entry}\margm{data}} as unwanted material
+that's ignored. This can catch out users who try to do something
+like:
+\begin{verbatim}
+%@misc{sample, title={Sample} }
+\end{verbatim}
+In this case, the percent character is simply discarded and the
+line is treated as:
+\begin{verbatim}
+ at misc{sample, title={Sample} }
+\end{verbatim}
+Some applications that parse \ext{bib} files are less tolerant of
+unwanted material. In the case of \bibgls, the percent character is
+treated as a comment character and other unwanted material
+should be omitted.  Avoid using comments within field values.
+Comments are best placed outside of entry definitions.
 
+The most common type of comment is the encoding comment, described above.
+
 \section{Fields}
 \label{sec:fields}
 
@@ -8964,10 +8980,13 @@
 \section{Supplemental Locations}
 \label{sec:supplementalopts}
 
-\emph{These options require at least version 1.14 of \isty{glossaries-extra}.}
+\emph{These options require at least version 1.14 of
+\isty{glossaries-extra}.} If you require locations from multiple
+external sources, then you need at least version 1.36 of
+\isty{glossaries-extra} (or, more specifically,
+\isty{glossaries-extra-bib2gls}, which is automatically loaded
+by the \styopt[only]{record} package option).
 
-\optsection{supplemental-locations}
-
 The \sty{glossaries-extra} package (from v1.14) provides a way of
 manually adding locations in supplemental documents through the use
 of the \glsaddopt{thevalue} option in the optional argument of
@@ -9035,9 +9054,35 @@
 and \glsaddopt[glsxtrsupphypernumber]{format}.
 
 This can be simplified with \bibgls\ by using the
-\optfmt{supplemental-locations} option. The value should be the base
-name (without the extension) of the supplementary document
-(\optfmt{suppl} in the above example). For example:
+\optfmt{supplemental-locations} option, described below. 
+
+Version 1.36 of \isty{glossaries-extra-bib2gls} introduces some
+special location formatting commands that don't use the
+\catattr{externallocation} attribute, but instead have an extra
+argument that indicates the external reference. The additional
+argument means that it can't be used by the \glsaddopt{format}
+key, but with \bibgls\ you don't use \cs{glsadd} to record
+the external locations. Instead it obtains the records from
+the corresponding supplementary \ext{aux} file, and adjusts the
+location encapsulator as appropriate.
+
+If \bibgls\ detects an older version of \sty{glossaries-extra},
+it will only allow one external supplemental source, and
+will set the \catattr{externallocation} attribute and use
+the \optfmt{glsxtrsupphypernumber} format. Otherwise \bibgls\
+will allow multiple sources and use the newer method.
+
+\optsection{supplemental-locations}
+
+The value should be the base name (without the extension) of the
+supplementary document (\optfmt{suppl} in the above example).
+If you have at least version 1.36 of \sty{glossaries-extra},
+the value may be a comma-separated list of base names (without the
+extensions) of the supplementary documents. If an older version is
+detected, \bibgls\ will issue a warning and only accept the first
+element of the list.
+
+For example:
 \begin{verbatim}
 \documentclass{article}
 
@@ -9056,17 +9101,85 @@
 \end{document}
 \end{verbatim}
 The location list for \code{sample} will now be \qt{1, S1} (page~1
-from the main document and S1 from the supplementary document). Note
-that the original location format from the supplementary document
-will be replaced by \optfmt{glsxtrsupphypernumber}, which will
-produce an external hyperlink if the main document loads the
-\isty{hyperref} package. (Note that not all PDF viewers can handle
-external hyperlinks, and some that can open the external PDF file may not 
-recognise the destination within that file.)
+from the main document and S1 from the supplementary document).
 
+With \sty{glossaries-extra} v1.36+, the location from the
+supplementary document will be encapsulated with:
+\nosecdef{glsxtrdisplaysupploc}
+By default, this simply creates an external hyperlink to the
+supplementary document with the location as the hyperlink text.
+The hyperlink is created using \meta{src} as the target path
+with the fragment part (anchor) formed from the prefix and 
+location. The \catattr{externallocation} attribute is not set in
+this case. The actual formatting is done via
+\nosecdef{glsxtrmultisupplocation}
+which ignores the \meta{format} argument by default. Its
+definition is simply:
+\begin{verbatim}
+\newcommand*{\glsxtrmultisupplocation}[3]{%
+ {% scope required to localise changes
+   \def\glsxtrsupplocationurl{#2}%
+   \glshypernumber{#1}%
+ }%
+}
+\end{verbatim}
+which locally sets the command checked by \ics{glshypernumber}
+to establish an external rather than internal link. You can
+redefine this command to retain the original formatting
+command used in the target document:
+\begin{verbatim}
+\renewcommand*{\glsxtrmultisupplocation}[3]{%
+ {% scope required to localise changes
+   \def\glsxtrsupplocationurl{#2}%
+   \csuse{#3}{#1}%
+ }%
+}
+\end{verbatim}
+but remember that if a hyperlink is required, the identified
+control sequence name must correspond to a command that
+uses \cs{glshyperlink} (such as \cs{hyperbf}), otherwise you
+will lose the hyperlink.
+
+With older versions of \sty{glossaries-extra},
+the original location format from the supplementary document
+will be replaced by \optfmt{glsxtrsupphypernumber}, which 
+again produces an external hyperlink. The \catattr{externallocation}
+attribute also needs to be set (this can be done automatically with
+\csopt{supplemental-category}) to identify the external document.
+The original format can't be accessed.
+
+In both cases, if the document hasn't loaded the \isty{hyperref}
+package, the location will simply be displayed without a hyperlink.
+(Note that not all PDF viewers can handle external hyperlinks, and
+some that can open the external PDF file may not recognise the
+destination within that file.)
+
 The supplementary locations lists are encapsulated within
-\gls{bibglssupplemental}.
+\gls{bibglssupplemental}. With \sty{glossaries-extra} v1.36+,
+this command will encapsulate the sub-lists with
+\gls{bibglssupplementalsublist}.
 
+So the above example with an old version of \sty{glossaries-extra}
+(pre 1.36) will set the supplemental location list (which only consists
+of one location) to
+\begin{verbatim}
+\bibglssupplemental{1}{\setentrycounter[I]{section}\glsxtrsupphypernumber{S1}}
+\end{verbatim}
+and the external target must be supplied through the
+\catattr{externallocation} attribute, which can be set 
+with the \csopt{supplemental-category} option.
+
+Whereas with at least version 1.36, the list will be
+\begin{verbatim}
+\bibglssupplemental{1}{\bibglssupplementalsublist{1}{suppl.pdf}
+{\glsxtrdisplaysupploc{I}{section}{glsnumberformat}{suppl.pdf}{S1}}}
+\end{verbatim}
+
+If an entry has both a main location list and a supplementary
+location list (such as the \code{sample} entry above), the lists
+will be separated by \csref{bibglssupplementalsep}. The sub-lists
+(when supported) are separated by \csref{bibglssupplementalsubsep}.
+
 \optsection{supplemental-selection}
 
 In the above example, only the \code{sample} entry is listed in
@@ -9120,10 +9233,6 @@
 \code{goose} entry used in the supplementary document won't be
 included.
 
-If an entry has both a main location list and a supplementary
-location list (such as the \code{sample} entry above), the lists
-will be separated by \csref{bibglssupplementalsep}.
-
 \optsection{supplemental-category}
 
 The \field{category} field for entries containing supplemental location
@@ -12946,6 +13055,22 @@
 part of \gls{bibglssupplemental}. The first argument \meta{n}
 (ignored by default) is the number of supplementary locations.
 
+If multiple supplemental sources are permitted (that is, 
+\bibgls\ has detected that the document is using at least
+version 1.36 of \sty{glossaries-extra}), then the \meta{list}
+part will consist of sub-lists for each external source. In this
+case, \meta{n} will be the total number of elements across
+all the sub-lists.
+
+\cssection{bibglssupplementalsublist}
+
+\formatdef{bibglssupplementalsublist}
+If multiple supplemental sources are permitted, this will be used
+to format each sub-list, where \meta{n} (ignored by default)
+is the number of elements in the sub-list, \meta{external document}
+(ignored by default) is the external source and \meta{list}
+is the list of supplementary locations in \meta{external document}.
+
 \cssection{bibglssupplementalsep}
 
 \formatdef{bibglssupplementalsep}
@@ -12968,6 +13093,12 @@
 \renewcommand{\bibglssupplementalsep}{; }
 \end{verbatim}
 
+\cssection{bibglssupplementalsubsep}
+
+\formatdef{bibglssupplementalsubsep}
+The separator between the supplementary
+location sub-lists. By default this is just \csref{bibglsdelimN}.
+
 \section{Letter Groups}
 \label{sec:lettergroupdefs}
 

Modified: trunk/Master/texmf-dist/source/support/bib2gls/src/gls2bib-src.zip
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/source/support/bib2gls/src/texparser-src.zip
===================================================================
(Binary files differ)



More information about the tex-live-commits mailing list