summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/bib2gls
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-03-24 20:54:02 +0000
committerKarl Berry <karl@freefriends.org>2020-03-24 20:54:02 +0000
commit6c9767fa3ed5fdd16f7045079d4c7144ed22a89f (patch)
tree4eca6f8d4fe7d6bf796ba912efa35692c4daae20 /Master/texmf-dist/doc/support/bib2gls
parent7e0670894cc9e548cbe17d5bda9e242f239638fc (diff)
bib2gls (24mar20)
git-svn-id: svn://tug.org/texlive/trunk@54525 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support/bib2gls')
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/CHANGES24
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/bib2gls-begin.pdfbin726603 -> 726572 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/bib2gls.156
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/bib2gls.pdfbin4532038 -> 4692176 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/convertgls2bib.12
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-authors.pdfbin49007 -> 49007 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-bacteria.pdfbin50457 -> 50457 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-chemical.pdfbin50346 -> 50249 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-citations.pdfbin47241 -> 47241 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-constants.pdfbin89877 -> 89380 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-hierarchical.pdfbin0 -> 49656 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-hierarchical.tex31
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-markuplanguages.pdfbin56324 -> 56324 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-maths.pdfbin111702 -> 110925 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-media.pdfbin160836 -> 160836 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-msymbols.pdfbin104361 -> 103819 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-multi1.pdfbin243245 -> 243149 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-multi2.pdfbin318519 -> 318033 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-nested.pdfbin0 -> 49664 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-nested.tex49
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-people.pdfbin47742 -> 47742 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.pdfbin69911 -> 69791 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols2.pdfbin67001 -> 67001 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-units1.pdfbin53003 -> 53003 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-units2.pdfbin54745 -> 54745 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-units3.pdfbin41199 -> 41132 bytes
-rw-r--r--Master/texmf-dist/doc/support/bib2gls/examples/sample-usergroups.pdfbin23839 -> 23838 bytes
27 files changed, 138 insertions, 24 deletions
diff --git a/Master/texmf-dist/doc/support/bib2gls/CHANGES b/Master/texmf-dist/doc/support/bib2gls/CHANGES
index b68f56882e8..7f1d128d1ac 100644
--- a/Master/texmf-dist/doc/support/bib2gls/CHANGES
+++ b/Master/texmf-dist/doc/support/bib2gls/CHANGES
@@ -1,3 +1,27 @@
+v2.3 (2020-03-23):
+
+ * New sort methods: recordcount and recordcount-reverse
+ (both require --record-count).
+
+ * Resource option 'selection' now also allows the values
+ 'deps but not recorded' and 'ancestors but not recorded'
+
+ * New resource options:
+
+ custom-sort-fallbacks
+ field-concat-sep
+
+ * The sort fallback resource options custom-sort-fallbacks,
+ entry-sort-fallback, symbol-sort-fallback,
+ abbreviation-sort-fallback and bibtexentry-sort-fallback
+ now allow 'id' or 'original id' as values or values that are
+ field concatenations.
+
+ * New command line switches:
+
+ --provide-glossaries
+ --no-provide-glossaries
+
v2.2 (2020-03-16):
* Bug fix (texparserlib.jar):
diff --git a/Master/texmf-dist/doc/support/bib2gls/bib2gls-begin.pdf b/Master/texmf-dist/doc/support/bib2gls/bib2gls-begin.pdf
index fb5b191d509..0511e6a2cd7 100644
--- a/Master/texmf-dist/doc/support/bib2gls/bib2gls-begin.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/bib2gls-begin.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/bib2gls.1 b/Master/texmf-dist/doc/support/bib2gls/bib2gls.1
index 42ece34b41e..55d4579a25b 100644
--- a/Master/texmf-dist/doc/support/bib2gls/bib2gls.1
+++ b/Master/texmf-dist/doc/support/bib2gls/bib2gls.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "BIB2GLS 1"
-.TH BIB2GLS 1 "2020-02-09" "perl v5.30.1" "bib2gls"
+.TH BIB2GLS 1 "2020-03-18" "perl v5.30.2" "bib2gls"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -201,30 +201,30 @@ Use the TeX parser library to interpret known (La)TeX commands
Don't try interpreting (La)TeX commands.
.IP "\fB\-\-break\-space\fR" 4
.IX Item "--break-space"
-Interpret tilde character and \enobreakspace as a normal space.
+Interpret \f(CW\*(C`~\*(C'\fR (tilde) character and \f(CW\*(C`\enobreakspace\*(C'\fR as a normal space.
.IP "\fB\-\-no\-break\-space\fR" 4
.IX Item "--no-break-space"
-Interpret tilde and \enobreakspace as a non-breaking space (default).
+Interpret \f(CW\*(C`~\*(C'\fR (tilde) and \f(CW\*(C`\enobreakspace\*(C'\fR as a non-breaking space (default).
.IP "\fB\-\-cite\-as\-record\fR" 4
.IX Item "--cite-as-record"
-Treat \fB\ecitation\fR as an ignored record.
+Treat \f(CW\*(C`\ecitation\*(C'\fR as an ignored record.
.IP "\fB\-\-no\-cite\-as\-record\fR" 4
.IX Item "--no-cite-as-record"
-Don't check for instances of \fB\ecitation\fR in the \fB.aux\fR file (default).
+Don't check for instances of \f(CW\*(C`\ecitation\*(C'\fR in the \fI.aux\fR file (default).
.IP "\fB\-\-warn\-non\-bib\-fields\fR" 4
.IX Item "--warn-non-bib-fields"
-Warn if internal non-bib fields are found in the .bib file.
+Warn if internal non-bib fields are found in the \fI.bib\fR file.
.IP "\fB\-\-no\-warn\-non\-bib\-fields\fR" 4
.IX Item "--no-warn-non-bib-fields"
-Don't warn if internal non-bib fields are found in the .bib file.
+Don't warn if internal non-bib fields are found in the \fI.bib\fR file.
The use of these internal fields can cause unexpected results, so
only use this option if you have taken appropriate precautions.
.IP "\fB\-\-warn\-unknown\-entry\-types\fR" 4
.IX Item "--warn-unknown-entry-types"
-Warn if any unknown entry types are found in the .bib file.
+Warn if any unknown entry types are found in the \fI.bib\fR file.
.IP "\fB\-\-no\-warn\-unknown\-entry\-types\fR" 4
.IX Item "--no-warn-unknown-entry-types"
-Don't warn if any unknown entry types are found in the .bib file.
+Don't warn if any unknown entry types are found in the \fI.bib\fR file.
.IP "\fB\-\-merge\-wrglossary\-records\fR" 4
.IX Item "--merge-wrglossary-records"
Merge an entry's \fBwrglossary\fR records for the same page locations.
@@ -234,8 +234,8 @@ Merge an entry's \fBwrglossary\fR records for the same page locations.
Don't merge an entry's \fBwrglossary\fR records.
.IP "\fB\-\-merge\-nameref\-on\fR \fIrule\fR" 4
.IX Item "--merge-nameref-on rule"
-Rule for merging locations created with the record=nameref package option
-(requires glossaries\-extra.sty version 1.37+). The \fIrule\fR may be
+Rule for merging locations created with the \fBrecord=nameref\fR package option
+(requires \fIglossaries\-extra.sty\fR version 1.37+). The \fIrule\fR may be
one of: \fBhcounter\fR, \fBhref\fR, \fBtitle\fR or \fBlocation\fR.
.IP "\fB\-\-force\-cross\-resource\-refs\fR or \fB\-x\fR" 4
.IX Item "--force-cross-resource-refs or -x"
@@ -245,15 +245,15 @@ Force cross-resource referencing mode on.
Don't force cross-resource referencing mode on (default).
.IP "\fB\-\-support\-unicode\-script\fR" 4
.IX Item "--support-unicode-script"
-Text superscript (\etextsuperscript) or subscripts (\etextsubscript)
+Text superscript (\f(CW\*(C`\etextsuperscript\*(C'\fR) or subscripts (\f(CW\*(C`\etextsubscript\*(C'\fR)
will use Unicode superscript/subscript characters if available.
-For example, \etextsuperscript{2} will be converted to U+00B2
+For example, \f(CW\*(C`\etextsuperscript{2}\*(C'\fR will be converted to U+00B2
(superscript two).
.IP "\fB\-\-no\-support\-unicode\-script\fR" 4
.IX Item "--no-support-unicode-script"
-Text superscript (\etextsuperscript) or subscripts (\etextsubscript)
+Text superscript (\f(CW\*(C`\etextsuperscript\*(C'\fR) or subscripts (\f(CW\*(C`\etextsubscript\*(C'\fR)
won't be converted to Unicode superscript/subscript characters.
-For example, \etextsuperscript{2} will be converted to <sup>2</sup>
+For example, \f(CW\*(C`\etextsuperscript{2}\*(C'\fR will be converted to \f(CW\*(C`<sup>2</sup>\*(C'\fR
and the markup will be stripped leaving just the character 2.
.IP "\fB\-\-packages\fR \fIlist\fR (or \fB\-p\fR \fIlist\fR)" 4
.IX Item "--packages list (or -p list)"
@@ -286,7 +286,7 @@ packages may be used in \fB\-\-packages\fR or \fB\-\-ignore\-packages\fR.
.IP "\fB\-\-mfirstuc\-protection\fR \fIfields\fR|\fBall\fR (or \fB\-u\fR \fIfields\fR|\fBall\fR)" 4
.IX Item "--mfirstuc-protection fields|all (or -u fields|all)"
Insert an empty group if fields start with certain problematic
-commands to protect against case-changing commands like \eGls.
+commands to protect against case-changing commands like \f(CW\*(C`\eGls\*(C'\fR.
.Sp
The default is to do this for all fields. To do this for only a
subset of fields, set \fIfields\fR to a comma-separated list of fields
@@ -296,11 +296,11 @@ subset of fields, set \fIfields\fR to a comma-separated list of fields
Switch off the auto-insertion of an empty group for all fields.
.IP "\fB\-\-mfirstuc\-math\-protection\fR" 4
.IX Item "--mfirstuc-math-protection"
-Switch on the auto-insertion of an empty group for math-shift ($).
+Switch on the auto-insertion of an empty group for math-shift (\f(CW\*(C`$\*(C'\fR).
This option will be overridden by \fB\-\-no\-mfirstuc\-protection\fR.
.IP "\fB\-\-no\-mfirstuc\-math\-protection\fR" 4
.IX Item "--no-mfirstuc-math-protection"
-Switch off the auto-insertion of an empty group for math-shift ($).
+Switch off the auto-insertion of an empty group for math-shift (\f(CW\*(C`$\*(C'\fR).
.IP "\fB\-\-nested\-link\-check\fR \fIlist\fR|\fBnone\fR" 4
.IX Item "--nested-link-check list|none"
Check each field listed in \fIlist\fR for potentially problematic
@@ -323,10 +323,10 @@ Permitted values of \fIoption\fR: \fBacronyms\fR (or \fBacro\fR), \fBac\fR,
Set location format mappings.
.IP "\fB\-\-group\fR or \fB\-g\fR" 4
.IX Item "--group or -g"
-Add 'group' field to entries.
+Add \fBgroup\fR field to entries.
.IP "\fB\-\-no\-group\fR" 4
.IX Item "--no-group"
-Don't add 'group' field to entries (default).
+Don't add \fBgroup\fR field to entries (default).
.IP "\fB\-\-record\-count\fR or \fB\-c\fR" 4
.IX Item "--record-count or -c"
Add record count fields to entries.
@@ -363,10 +363,20 @@ Don't trim leading and trailing spaces from fields (default).
This option cancels \fB\-\-trim\-only\-fields\fR and \fB\-\-trim\-fields\fR.
.IP "\fB\-\-expand\-fields\fR" 4
.IX Item "--expand-fields"
-Don't write \fB\eglsnoexpandfields\fR to the \fB.glstex\fR file.
+Don't write \f(CW\*(C`\eglsnoexpandfields\*(C'\fR to the \fI.glstex\fR file.
.IP "\fB\-\-no\-expand\-fields\fR" 4
.IX Item "--no-expand-fields"
-Write \fB\eglsnoexpandfields\fR to the \fB.glstex\fR file (default).
+Write \f(CW\*(C`\eglsnoexpandfields\*(C'\fR to the \fI.glstex\fR file (default).
+.IP "\fB\-\-provide\-glossaries\fR" 4
+.IX Item "--provide-glossaries"
+Write \f(CW\*(C`\eprovideignoredglossary*\*(C'\fR to the \fI.glstex\fR file to provide
+unknown glossaries.
+.IP "\fB\-\-no\-provide\-glossaries\fR" 4
+.IX Item "--no-provide-glossaries"
+Don't write \f(CW\*(C`\eprovideignoredglossary*\*(C'\fR to the \fI.glstex\fR file to
+provide unknown glossaries except in documented situations
+(\fBmaster\fR, \fBsecondary\fR and \fBtrigger-type\fR resource options).
+This setting is the default.
.SH "REQUIRES"
.IX Header "REQUIRES"
Java 7 or later and a TeX distribution.
@@ -398,4 +408,4 @@ The glossaries manual:
.SH "AUTHOR"
.IX Header "AUTHOR"
Nicola L. C. Talbot,
-<http://www.dickimaw\-books.com/>
+<https://www.dickimaw\-books.com/>
diff --git a/Master/texmf-dist/doc/support/bib2gls/bib2gls.pdf b/Master/texmf-dist/doc/support/bib2gls/bib2gls.pdf
index dfd6523fb8b..1ec0b544baf 100644
--- a/Master/texmf-dist/doc/support/bib2gls/bib2gls.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/bib2gls.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/convertgls2bib.1 b/Master/texmf-dist/doc/support/bib2gls/convertgls2bib.1
index c5f2aceaa08..4c44b2b86a0 100644
--- a/Master/texmf-dist/doc/support/bib2gls/convertgls2bib.1
+++ b/Master/texmf-dist/doc/support/bib2gls/convertgls2bib.1
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "CONVERTGLS2BIB 1"
-.TH CONVERTGLS2BIB 1 "2020-02-11" "perl v5.30.1" "convertgls2bib"
+.TH CONVERTGLS2BIB 1 "2020-02-11" "perl v5.30.2" "convertgls2bib"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-authors.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-authors.pdf
index 8b5267884aa..9313283211c 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-authors.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-authors.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-bacteria.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-bacteria.pdf
index 7a234832ef1..4bea556abdf 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-bacteria.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-bacteria.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-chemical.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-chemical.pdf
index 6eea6850c5f..a40807a98fe 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-chemical.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-chemical.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-citations.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-citations.pdf
index 4e7484577bc..af0ca7379de 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-citations.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-citations.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-constants.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-constants.pdf
index afd62a657f4..f940272f170 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-constants.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-constants.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-hierarchical.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-hierarchical.pdf
new file mode 100644
index 00000000000..e33b240606b
--- /dev/null
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-hierarchical.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-hierarchical.tex b/Master/texmf-dist/doc/support/bib2gls/examples/sample-hierarchical.tex
new file mode 100644
index 00000000000..7d00843f90d
--- /dev/null
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-hierarchical.tex
@@ -0,0 +1,31 @@
+% This file is public domain. See the "Examples" chapter
+% in the bib2gls user manual for a more detailed description
+% of this file.
+
+\documentclass[12pt,a4paper]{article}
+
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+
+\usepackage[record,% use bib2gls
+ nostyles,% don't load default styles
+ postdot,% add a full stop after the description
+% load glossary-tree.sty and patch styles:
+ stylemods={tree},
+ style=treegroup]{glossaries-extra}
+
+\GlsXtrLoadResources[
+ src={terms,animals,minerals,vegetables},% data these .bib files
+ field-aliases={identifier=parent}
+]
+
+\begin{document}
+Some sample terms: \gls{duck}, \gls{sealion}, \gls{armadillo},
+\gls{seal}, \gls{aardvark}, \gls{amethyst}, \gls{aquamarine},
+\gls{diamond}, \gls{dolomite}, \gls{chalcedony}, \gls{citrine},
+\gls{quetzalcoatlite}, \gls{cabbage}, \gls{cauliflower},
+\gls{artichoke}, \gls{courgette}.
+
+\GlsXtrSetDefaultNumberFormat{glsignore}% ignore records in the glossary
+\printunsrtglossary
+\end{document}
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-markuplanguages.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-markuplanguages.pdf
index c381c0b8d9f..6688825d480 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-markuplanguages.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-markuplanguages.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-maths.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-maths.pdf
index 3bc8fe6a11c..43cd7710df4 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-maths.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-maths.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-media.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-media.pdf
index 5daa1bcf79b..1369546ba45 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-media.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-media.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-msymbols.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-msymbols.pdf
index 94b0cd9aa74..2b066570ab5 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-msymbols.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-msymbols.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi1.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi1.pdf
index 7cb94e2e827..49cc35baaf4 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi1.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi2.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi2.pdf
index b2ad9f79f33..90cdb481e90 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi2.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi2.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-nested.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-nested.pdf
new file mode 100644
index 00000000000..8286cb06433
--- /dev/null
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-nested.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-nested.tex b/Master/texmf-dist/doc/support/bib2gls/examples/sample-nested.tex
new file mode 100644
index 00000000000..fc6b540706c
--- /dev/null
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-nested.tex
@@ -0,0 +1,49 @@
+% This file is public domain. See the "Examples" chapter
+% in the bib2gls user manual for a more detailed description
+% of this file.
+
+\documentclass[12pt,a4paper]{article}
+
+\usepackage[T1]{fontenc}
+\usepackage[colorlinks]{hyperref}
+
+\usepackage[record,% use bib2gls
+ nostyles,% don't load default styles
+ postdot,% add a full stop after the description
+% load glossary-tree.sty and patch styles:
+ stylemods={tree},
+ style=treegroup]{glossaries-extra}
+
+\GlsXtrLoadResources[src={terms},sort={en-reverse}]
+
+\GlsXtrLoadResources[
+ src={animals,minerals,vegetables},
+ field-aliases={identifier=type},
+ dependency-fields=type,
+ sort={en}
+]
+
+\newcommand{\nestedhandler}[1]{%
+ \glsxtrunsrtdo{#1}%
+% Is there a glossary whose label (type) matches this entry's label?
+ \ifglossaryexists*{#1}%
+ {%
+ \printunsrtinnerglossary[type={#1},leveloffset=++1,groups=false]{}{}%
+ }%
+ {}%
+}
+
+\begin{document}
+Some sample terms: \gls{duck}, \gls{sealion}, \gls{armadillo},
+\gls{seal}, \gls{aardvark}, \gls{amethyst}, \gls{aquamarine},
+\gls{diamond}, \gls{dolomite}, \gls{chalcedony}, \gls{citrine},
+\gls{quetzalcoatlite}, \gls{cabbage}, \gls{cauliflower},
+\gls{artichoke}, \gls{courgette}.
+
+\GlsXtrSetDefaultNumberFormat{glsignore}% ignore records in the glossary
+
+\printunsrtglossary*{%
+ \let\printunsrtglossaryhandler\nestedhandler
+}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-people.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-people.pdf
index 34c8dc47507..e56463c5cbd 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-people.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-people.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.pdf
index 1a142e08f0e..1b7fbffb086 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols2.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols2.pdf
index 6a3eb23a495..a9a33d07507 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols2.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols2.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-units1.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-units1.pdf
index b1f890b33d0..82a539f6db0 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-units1.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-units1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-units2.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-units2.pdf
index 57fa32679d3..2bdd998fac6 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-units2.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-units2.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-units3.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-units3.pdf
index 77ec87df670..c8a61336578 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-units3.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-units3.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-usergroups.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-usergroups.pdf
index 41b5ee9544c..2b0a48ce126 100644
--- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-usergroups.pdf
+++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-usergroups.pdf
Binary files differ